Viewing the tables, files, and logs in an ACL robot

To view the Analytics tables or result files contained in an ACL robot you must first download them to your local computer. You can view result logs directly from Robots, or you can also download them. The different options for downloading and viewing tables, files, and logs are summarized below.

Table or file type Download in result package or Analytics project Download individually View in Robots
Analytics data table
Analytics result table
Analytics result file
Analytics result log
non-Analytics related file

Viewing a table in Analytics

How you view a downloaded Analytics table depends on the type of Robots Agent you are using. Downloaded tables are contained in either a downloaded result package (*.zip) or an Analytics project (*.acl).

Agent type Download and view details
On-premise Robots Agent
  • Download The downloaded package or project contains only the table layout. The table data remains on your organization's network, but you can use the data for analysis in Analytics.
  • View Using a server profile, you connect from Analytics to the table data on your organization's Robots Agent.
  • Supported tables Analytics result tables and Analytics data tables.
Cloud-based Robots Agent
  • Download The downloaded package or project contains both the table layout and the table data.
  • View You access the table data locally using only Analytics.
  • Supported tables Analytics result tables only.

Download task results

Task results can include Analytics result tables, other file types, and a log file.

Task results are specified using the //RESULT analytic tag. For more information, see RESULT tag.

  1. From the Launchpad home page (www.highbond.com), select the Robots app to open it.

    If you are already in Diligent One, you can use the left-hand navigation menu to switch to the Robots app.

  2. From the dashboard in Robots, select ACL Robots.
  3. Navigate to the robot that contains the results, and select the robot to open it.
  4. In the top right corner of the robot, click Production or Development to select the mode to use.
  5. Select the Task runs tab.
  6. Select the task run with the results that you want to download.
  7. In the Task run details panel, do one of the following:

    • Download a result file individually

      To download an Analytics result file such as Excel, or an Analytics log file, click Download beside the name of file.

      Result The file is downloaded to your local file system and can be opened in its native application. An Analytics log file can be opened in any text editor. You can also click View beside the name of a log file to view the log directly.

    • Download all results in a package

      To download all results from a task run, including any Analytics result tables, do the following:

      1. Click Generate result package and wait while the result package is generated.

      2. Click Download result package.

      Result A compressed file named <robot_name>.zip, which includes an Analytics project, is downloaded to your local file system.

      You can extract the contents of the compressed file, open the Analytics project in Analytics, and view any Analytics result tables. You can open any other result file types, such as Excel, in their native applications.

      If the task run failed, click Download failed package to download the log file. You can also click View beside the name of the log file to view the log directly. The log file can help you identify the reason the task failed.

Download an Analytics data table

Note

Analytics data tables are supported by the on-premise Robots Agent only. They are not supported by the cloud-based Robots Agent.

Data tables are specified using the //DATA analytic tag. For more information, see DATA tag.

  1. From the Launchpad home page (www.highbond.com), select the Robots app to open it.

    If you are already in Diligent One, you can use the left-hand navigation menu to switch to the Robots app.

  2. From the dashboard in Robots, select ACL Robots.
  3. Navigate to the robot that contains the data table, and select the robot to open it.
  4. In the top right corner of the robot, click Production or Development to select the mode to use.
  5. Select the Input/Output tab.
  6. In one of the sections containing tables, select the data table that you want to download.
  7. In the Table details panel, click View Table in AN.

    Result An Analytics project named <robot_name>.acl is downloaded to your local computer. The project contains all the data tables from the Input/Output tab, not just the table you selected.

    You can open the project in Analytics and view the data table.

Open a downloaded Analytics table (on-premise Robots Agent)

Before you start

To connect to data on a Robots Agent from Analytics the following prerequisites must be in place:

  • Analytics users must have the appropriate Windows logon rights and folder permissions on the server where the Robots Agent is installed.

    For more information, see On-premise Robots Agent security.

  • the Enable Server integration option in Analytics must be selected (Tools > Options > Interface)
  • the RobotsProfile server profile must be configured in Analytics
  • the edition of Analytics (Unicode or non-Unicode) must match the edition of the Robots Agent

Open the table

  1. On your computer, navigate to the zipped or the downloaded Analytics project (*.zip or *.acl).
  2. If the project is zipped, right-click it and choose an appropriate option to unzip it.
  3. Double-click the downloaded or the unzipped project.

    The project opens in Analytics.

  4. Double-click a Robots table to open it.
  5. Enter your network password and click OK.

Troubleshooting

If you get a connection error when attempting to open a Robots table in Analytics, try these remedies:

  • Robots Data Service Check that the Robots Data Service is running on the server where the Robots Agent is installed. Start the service if it is stopped.
  • Robots server profile Delete the RobotsProfile server profile and close and reopen the Analytics project to automatically create a refreshed profile.

    To delete the RobotsProfile, on the Analytics main menu, go to Server > Server Profiles.

Open a downloaded Analytics table (cloud-based Robots Agent)

  1. On your computer, navigate to the zipped Analytics project (*.zip).
  2. Right-click the project and choose an appropriate option to unzip it.
  3. Double-click the unzipped project.

    The project opens in Analytics.

  4. Double-click a table to open it.