By default, GroundRunners automatically create log files in the \Contents\log\
directory of their installation locations. To ease access to the log file for troubleshooting, you can automatically download a GroundRunner's output.log
file to a table in Wdata with a chain using:
- The default File Utilities connection
- A Workiva connection
Step 1. Create the table and chain
- If necessary, install and set up the GroundRunner.
- From Home , create a table, and add a single text column named Log.
- To identify the table in the chain, record its ID.
Note: The table's ID is the alphanumeric value following
tables/
in its URL. - In Chain Builder, from Build , Chains, click Create Chain.
- Under Setup, enter a unique name and description to help identify the chain and its intent.
Step 2. Add a Copy command
To enable the table to import the log, add a Copy command to create a CSV of the latest file:
- Under Available BizApps, click File Utilities, and move Copy to the canvas.
- Select the node, click Edit , and enter a unique name and description for the command.
- Select the GroundRunner to download the logs from.
- For Source, enter the path to the GroundRunner's output.log file, such as
c:\PROGRA~2\Wdata\Contents\log\output.log
. - For Destination, append the same path with
.$(Chain.ExecutorId).csv
, such asc:\PROGRA~2\Wdata\Contents\log\output.log.$(Chain.ExecutorId).csv
. - To ensure the chain downloads the latest log file, select Overwrite.
- Click Save, and move the node to Start.
Step 3. Add a command group to create a ZIP of the CSV
The log file may be large. To create a ZIP file from–and then delete–the CSV, add a command group:
- Under Available BizApps, click File Utilities, and move Zip to the canvas.
- Select the node, click Edit , enter a unique name and description for the command, and select the same GroundRunner.
- For Archive Name, enter the name to give the ZIP file, such as
output.log.zip
. - For Source Files, enter the same path as the Destination input of the Copy command.
- Click Save.
- Under Available BizApps, click File Utilities, and move Delete to the canvas.
- Select the node, click Edit , enter a unique name and description for the command, and select the same GroundRunner.
- For File name, enter the same path as the Destination input of the Copy command.
- Click Save, and move the node to the Zip node to create a command group.
- Drag a link from Start to the command group.
Step 4. Add a Create File command
To import the log file to the table, add a Create File command:
- Under Available BizApps, click Workiva, and move Create File to the canvas.
- Select the node, click Edit , enter a unique name and description for the command, and select the same GroundRunner.
- For Table ID, enter the ID from the URL of the table to add the log file to.
- For File, click Variable, and select the Zipped File output of the Zip command.
- Click Save, drag a link from the command group to the node, and click Publish.
Step 5. Download the log file
- To run the chain, click its Execute and Run Chain.
- In the table, verify the current log file appears on the Datasets right panel.
- To download the log file, select Details from its dataset's menu, and then select Download , Original File , To CSV .