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:
- Click the Project tab and click Options to open the Options dialog box.
- Choose Tasks under Project to set project options for tasks.
- Under Task History, check Enable Task History.
- Browse to the geodatabase where the task history table will be stored and choose <Create History Table> from the Table drop-down list.
- 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. |