Actions with task trackers

Adding a task tracker

info

To add a task tracker, the user must have at least the following access rights:

• view trackers;
• manage trackers;
• create tasks for the tracker;
• view and comment (within the access scope for security issues).

To add a task tracker, follow these steps:

1. Go to Integrations → Task trackers.
2. In the window that opens, enter the connection parameters:
   • integration name (for example, Jira Tracker);
   • workspace URL;
   • authentication data—an API token or login when you select the Basic type, or a Bearer token when you select the Bearer type.

3. Select Create.
4. Specify the default parameters to apply to tasks:
   • Project;
   • Task type:
     • task;
     • bug;
     • story;
   • Task submission format:
     • multiple separate tasks;
     • one combined task.

5. Select Save.
6. Complete the task mapping parameters. To do this:
   • select Apply preset to prepopulate the data;
   • map ASOC fields to tracker fields in the Fields block;
   • map ASOC statuses to tracker statuses in the Statuses block.

7. Select Save.

8. Turn on the Sync comments toggle to add comments from the system to the task tracker.

9. Select Save.

After the connection succeeds, the tracker appears in the list with the Active status.

info

To send changes from the task tracker to the system, you can use a webhook and the API endpoint in the Send changes from the task tracker to ASOC block.

In the endpoint's {UserApiToken} placeholder, specify the API token created in the user profile. For more information, see Creating an API token. It's best to perform this action in a separate account created for the task tracker integration. This ensures that the task tracker user appears in the change history for security issues.

For more information about webhooks, see the official Atlassian documentation.

Deleting one or more task trackers

To delete one task tracker, follow these steps:

1. Go to Integrations → Task trackers.
2. Select the additional actions button () next to the required task tracker.
3. Select Delete.
4. Confirm the task tracker deletion in the modal window that opens.

To delete multiple task trackers, follow these steps:

1. Select the trackers using the checkboxes ()
2. Select the delete button () above the task tracker table.
3. Confirm the task tracker deletion in the modal window that opens.