Viewing robot tasks and task runs

You can view robot tasks and task runs globally for your organization's Robots instance, or locally inside each robot, on a per-robot basis. From a global view, click any task or task run to go directly to the details screen for the item at the robot level.

Robots gives you these options for viewing tasks and task runs:

Note

Global views in Robots are not available if your Diligent One instance uses AWS GovCloud, or if it is located in the Africa (South Africa) region. A technical limitation prevents including the views.

What is the difference between a task and a task run?

A task is a single object contained in a robot. You create and configure a task to run one or more scripts in the robot. Each time that a task runs, a new, unique task run is created.

A single task typically has multiple associated task runs. A task run may include output results such as tables or files. These output results are unique to each task run.

When you create a new task, it is added to the Tasks global view and the Tasks tab in the robot.

Every time that a task runs, a new task run is created and added to the Task runs global view and the Task runs tab in the robot. A new task run is created even if the task fails or is skipped.

Task run history and status

You can view the history and status of task runs globally, or locally at the individual robot level. Task run entries display a range of information, including:

  • start date and time
  • duration
  • run method (manual, scheduled, or part of a task sequence)
  • identity of the user who ran the task
  • current or completed task run status
Global icon or description Local icon Task run status
queued Queued
running Running/In progress
cancelling Cancelling
Success

Failed

Possible cause: The script in the task failed and did not run to completion.

Skipped

Possible cause: The task was in a Queued status for too long.

Tasks can exceed the expiry time of the Queued status if too many tasks are running simultaneously. For more information, see Robots specifications and limits.

For ACL robots, another reason a task is skipped is that the on-premise Robots Agent is offline. For more information, see Installing or upgrading an on-premise Robots Agent.

Cancelled

Cause: Someone manually canceled the task.

View all tasks in Robots

Open a read-only global view of all tasks in your organization's Robots instance. From the global view, you can go directly to an individual task to see greater detail or perform any required edits.

  1. Open the Robots app.
  2. From the dashboard in Robots, select the Tasks global view.

    The Tasks global view contains a list of all tasks in your organization's Robots instance. The global view displays tasks for only those robots that you have permission to see.

  3. Optional. Apply a filter to the view:
    1. Click the Controls bar to open the filters.
    2. Select or deselect values in one or more filters so that the global view displays only the tasks that you want to see.

      Note

      Each additional filter that you apply potentially excludes more tasks from the view.

      After you configure an initial filter, only relevant values are available in subsequent filters. If you do not see a value that you expect in a filter, check to see if another filter is already applied.

  4. Optional. Click a task entry that you want to view in detail.

    Result the task opens in a new browser tab with the Task details side panel open.

    For information about editing a task, see Maintaining a robot task.

View all task runs for all tasks in Robots

Open a read-only global view of all task runs in your organization's Robots instance. From the global view, you can go directly to an individual task run to see greater detail or access output results.

  1. Open the Robots app.
  2. From the dashboard in Robots, select the Tasks runs global view.

    The Task runs global view contains a dashboard with charts and a list of task runs in your organization's Robots instance. The global view displays task runs for only those robots that you have permission to see.

    Note

    The view is initially filtered to include only the most recent 10 days of data.

  3. Optional. Apply a filter to the view:
    1. Click the Controls bar to open the filters.
    2. Select or deselect values in one or more filters so that the global view displays the task runs that you want to see.

      Note

      Each additional filter that you apply potentially excludes more task runs from the view. The exception is the date filter, which can increase or decrease the amount of data in the view.

      After you configure an initial filter, only relevant values are available in subsequent filters. If you do not see a value that you expect in a filter, check to see if another filter is already applied.

  4. Optional. Click a task run entry that you want to view in detail.

    Result the task run opens in a new browser tab with the Task run details side panel open. Any output tables or files are listed in the side panel.

    For information about viewing the output of a task run, see:

View tasks and task runs for a specific robot

View production or development tasks and tasks runs for a specific robot.

Navigate to the robot

Tip

Instead of manually navigating to a robot and its tasks, you can go directly to a task or a task run by selecting it in a global view.

  1. Open the Robots app.
  2. From the dashboard in Robots, select the tab for the appropriate robot type.
  3. Navigate to the robot with the task or the task run that you want to view.
  4. Click the robot to open it.

  5. In the upper-right corner of the robot, click Production or Development to select the mode to use.

    For more information, see Development mode and production mode in Robots.

View tasks for the robot

  1. Select the Tasks tab.

    The tab opens and displays a list of tasks contained in the robot. Each task displays the most recent task run status.

  2. Click a task with details that you want to view.

    Result the Task details side panel opens and displays detailed information about the task.

    For information about editing a task, see Maintaining a robot task.

View task runs for the robot

  1. Select the Task runs tab.

    The tab opens and displays a list, in reverse chronological order, of all the task runs for the robot. Each task run displays its current or completed status.

    Tip

    Hover over a Status icon to see the status name.

  2. Click a task run with details that you want to view.

    Result the Task run details side panel opens and displays detailed information about the task run, including a list of any output tables and files.

    For information about viewing the output of a task run, see: