Skip to main content

Task history

History and tracking information can be enabled for the tasks that are run in a project. Task tracking information is recorded in a task history table. You would enable task history in your project to ascertain the following metrics:

  • Identify the most commonly used and least commonly used tasks.

  • Identify the average time it takes to run a task.

  • Compare how long it takes to run a task against the average run time of the task.

As a task administrator, you would enable task history to identify the following information:

  • The most commonly used and least commonly used tasks

  • Which users use which tasks

  • The number of times a task is used by a user

  • The adoption rate of a task over a period of time

  • The average time it takes to run a task for cost analysis purposes

  • How modifications to tasks affect task efficiency (run time)

Enable task history

Task history is tracked in a table that is created and stored in a geodatabase. Task history is enabled when a project is associated with a task history table. To create a task history table for your project, do the following:

  1. Click the Project tab and click Options to open the Options dialog box.

  2. Choose Tasks under Project to set project options for tasks.

  3. Under Task History, check Enable Task History.

  4. Browse to the geodatabase where the task history table will be stored and choose <Create History Table> from the Table drop-down list.

  5. Click OK to create the table and add it to the Contents pane.

  • Multiple task history tables can be created in the same geodatabase, but the project can only reference one task history table.

  • The same task history table can be referenced by multiple projects.

  • The default name of the task history table is TASK_HISTORY. You can modify the table name and add your own fields to the task history table.

    Note:

    If you change the schema of the table (delete or rename existing tracking fields), the use of the table as a task history table becomes disabled.

  • To open a task history table, expand the geodatabase in the Catalog pane, right-click the task history table and click Add to Current Map. In the Contents pane, right-click the table and click Open to view it.

Task history table

Task tracking information is recorded in the following fields in the task history table:

Field Name

Alias

Description

USERID

User ID

The ArcGIS Online user name or system login user name.

PROJECTNAME

Project Name

The name of the project. The same task history table can be referenced by multiple projects.

TASKITEMID

Task Item ID

The ID of the task item (GUID).

TASKITEMNAME

Task Item Name

Task item name.

TASKITEMVERSION

Task Item Version

Version number of the task item.

TASKID

Task ID

The ID of the task (GUID).

TASKNAME

Task Name

The name of the task.

STARTTIME

Start Time

The time the first step of the task was executed.

ENDTIME

End Time

The time the last step of the task was finished or the time the task was aborted.

DURATION

Duration in seconds

The total run time of the task (excluding idle time).

JOBID

Workflow Manager Job ID

The ID of the job in Workflow Manager.

TASKCOMPLETED

Task Completed

Set to true (1) if the task was completed.