Managing tasks for data refreshes

You can manage existing tasks for refreshing app, script, or data flow data. To view and manage these tasks, click on an app, script, or data flow from the Analytics or Insights activity center. Next, select Schedule.

Actions for managing tasks include:

• Viewing all tasks

• Running

• Editing

• Activating and deactivating

• Viewing execution history, including logs

• Deleting

Viewing existing tasks

1. Click on an app, script, or data flow from the Analytics or Insights activity center.

2. Select Schedule.

The scheduling dialog opens. In the Tasks tab, you can view all tasks for the item.

Editing a task

You can edit existing tasks.

Do the following:

1. In the Analytics or Insights activity center, click on an app, script, or data flow.

2. Click Schedule.

   The scheduling dialog opens.

3. Click on a task, and select Edit.

Activating and deactivating a task

A task can have one of two activation statuses: Active or Inactive.

You can activate and deactivate tasks as needed. Tasks can are also sometimes deactivated automatically (see Reasons for task deactivation). When a task is inactive, it will not run based on time-based or event-based triggers. The task also cannot be run manually when it is inactive.

Do the following:

1. In the Analytics or Insights activity center, click on an app, script, or data flow.

2. Click Schedule.

   The scheduling dialog opens.

3. Click on a task, and select Activate or Deactivate.

Identifying whether a task is active or inactive

You can tell whether a task is active or inactive.

Do the following:

1. Click on an app, script, or data flow from the Analytics or Insights activity center.

2. Select Schedule.

   The scheduling dialog opens, with the list of all tasks.

3. There are two ways to find out the task status:

   1. Inactive tasks have a icon next to the Task name. Active tasks do not have any icon next to the Task name.

   2. Check the Next run column value for the task. If the task is inactive, this column shows Inactive, as well as how the task was deactivated.

Reasons for task deactivation

Tasks can be deactivated in the following ways:

• You or another user with sufficient permissions has manually deactivated it.

• A task is automatically deactivated after failing to execute five times in a row.

• If your app, script, or data flow has tasks for refreshing data, and you move it between spaces (personal or shared spaces), these tasks are deactivated. You can reactivate them when ready to resume the scheduled refreshes.

Deleting a task

Do the following:

1. In the Analytics or Insights activity center, click on an app, script, or data flow.

2. Click Schedule.

   The scheduling dialog opens.

3. Click on a task, and select Delete.

Viewing the refresh history of a task

You can dive deeper into task histories with History. The History view shows all executions of the tasks for the app, script, or data flow. You can view details such as completion status, duration, the owner of the associated task, and how the execution was triggered.

Do the following:

1. In the Analytics or Insights activity center, click on an app, script, or data flow.

2. Click Schedule.

   The scheduling dialog opens.

3. Switch to the History tab.

Click > View on a single execution in the list for additional details. In this view, you are given a log that includes a reload ID. If needed, click Download to download a line-by-line script execution log for further analysis.

Manually running a task

Although tasks are meant to run on time-based or event-based schedules, you can still manually run a task for immediate updates to the data.

Do the following:

1. In the Analytics or Insights activity center, click on an app, script, or data flow.

2. Click Schedule.

   The scheduling dialog opens.

3. Click on a task, and select Run now.

Permissions

Administering tasks

Tenant admins and analytics admins can edit and delete tasks for scheduled data refreshes. This is done in the Administration activity center. For more information, see:

• Managing apps for tenant and analytics administrators

• Managing scripts for tenant and analytics administrators