Scout can be executed from the command line, this allowing it to be scheduled as a task.
Since Scout is written in Java the execution means to execute Java, point to the right classpath, set all the required Java arguments and pass in the right Scout arguments.
Here's an example of a Scout execution:
java -Djna.nosys=true -Djava.library.path=.;.\dependencies -cp bin\*;libs\* com.tableausoftware.test.tools.scout.ScoutRunner <Scout arguments>
The composition of this command is:
- Start java (java)
- Make sure the JNA shipped with Scout is used, and not the default system JNA (-Djna.nosys=true)
- Set the java native library path to the Scout\dependencies: (-Djava.library.path=.;.\dependencies)
- Set the java class path to the bin and libs folders (-cp bin\*;libs\*)
- The name of the class to be executed by java that contains the program entry point for Scout (com.tableausoftware.test.tools.scout.ScoutRunner)
- The arguments to be passed in to Scout for execution (<Scout arguments>)
Here are the arguments supported by Scout when executing from the command line:
|Argument category||Argument name||Required||Values||Default||Description|
|General||platform||y||[Server, Desktop]||The platform Scout will be running against (Tableau Server or Tableau Desktop)|
|outputDir||n||<path>||The path where the Scout results, logs and screenshots are going to be saved|
|iterations||n||<integer>||1||The number of iterations to execute|
|saveScreenshots||n||[true, false]||true||Flag to indicate Scout to save or not screenshots|
|flow||n||[AllInteractions, PageLoad, RandomInteractions]||AllInteractions||The flow Scout will execute. For more information about flows see the main Scout help page|
|forceAudit||n||[true, false]||false||A flag indicating the Auditor to overwrite any data already audited|
|Server||host||y||<URL to server>||The address to the Tableau Server to execute Scout on|
|mode||n||[view, authoring]||view||The interaction mode Scout should be run in (view or authoring)|
|serverType||n||[onprem, online, public]||onprem||The Tableau Server type (on premise, Tableau online or Tableau public)|
|urlsFile||n||<path>||A path to a file containing a list of the URLs Scout should be running on (one URL per line)|
|saveServerLogs||n||[true, false]||false||A flag indicating to Scout to try to pull the logs from the server after the run execution|
|limitViewCount||n||<integer>||If specified this will restrict Scout to only execute on the number of views limited to|
|overrideWorkbookDiscoveryOrderOnServer||n||[true, false]||A flag indicating to Scout to not go in the order of popularity, but rather go in alphabetical order when discovering content on the server|
|isJsDebugEnabled||n||[true, false]||A flag indicating to Scout that the server is rendering the content with jsDebugEnabled query string set to true|
A flag indicating to Scout that it could ignore missing performance instrumentation data due to the fact that WCM were not enabled.
Useful for user acceptance testing
If specified, Scout will only discover content on the given site.
This is the SiteID, as in the URL and it is case-sensitive
If specified, Scout will only discover content on the given project.
|Desktop||workbookName||n||<path>||Path to workbook Scout will execute on|
|workbookDir||n||<path>||Path to a folder with workbooks Scout will execute on|
|tableauExecutable||y||<path>||Path to the location of Tableau Desktop instance to be used by Scout|
|suppressDialogs||n||[true, false]||true||Flag to indicate to Scout that it should suppress any dialogs that could be suppressed|
|collectPerfmonCounters||n||[true, false]||false||Flag to indicate Scout to try to start and stop performance counter collection|
|processIsolation||n||[true, false]||false||Flag to indicate to Scout that each workbook should start a new Tableau Desktop instance|