Configuring trigger actions

Configure one or more actions under Trigger action by clicking Add action:

• Change issue status
• Update fields
• Add comment
• Create checklist
• Calculate value
• Move issue
• Create issue
• HTTP request

Changing issue statusChanging issue status

Set a new issue status. The available statuses depend on the workflow settings.

If you set up a transition screen for a status update, make sure it does not have required fields. Otherwise, you will not be able to change the status using a trigger.

Updating fieldsUpdating fields

Set up new values for one or more fields.

1. Click Select fields and specify the field.

2. Select an action:

   Action	Description
   Set the value	Assign the value to a field.
   Clear the field	Delete a field value.
   Add to list	Add another value for the field (for multiple-item fields).
   Remove from list	Remove one value from the field (for multiple-item fields).

3. Specify the new value for the field.

Add commentAdd comment

Write the comment text that will be added to an issue.

You can insert values of issue fields into the comment text. To do this, click Add variable and select one or more values. The Comment field will show a sequence like not_var{{issue.<field_ID>}}.

Create checklistCreate checklist

Create a checklist that will be added to an issue.

To add a checklist item:

1. Click Add item.

2. Enter a description for the item. If necessary, specify the assignee and deadline.

3. Click Save.

Calculate valueCalculate value

You can set up a special field whose values are calculated automatically based on values entered in other fields. For example, you can automatically calculate the value of a certain metric.

To calculate the field value automatically:

1. Add an action for the Calculate value trigger.

2. Set a formula for calculating the value:

   • Click Add variable and add a field formula with numeric values. The formula will include a sequence like not_var{{issue.<field_key>}}.
     If the desired field is missing in Tracker, you can create one.
   • You can use mathematical symbols for addition +, subtraction -, multiplication *, and division /.
   • To set the priority of operations, use parentheses.

3. Click Choose the field and set the field you want to put the calculated value into.

   Note

   If the field supports only integer values, the value will be rounded.

4. Set a condition that will trigger the calculation of the field value in the Trigger conditions section. We recommend choosing the Formula fields changed event. You can also set any conditions you need for your issue workflow.

Move issueMove issue

1. Add the Move issue trigger action.

2. Select the queue to move your issue to.

The issue will be moved only if the user who ran the trigger has rights for creating issues in the selected queue.

Create an issueCreate an issue

You can set up a trigger that will automatically create an issue when certain conditions are met. For example, you can create a trigger that creates an issue for testing when a programmer implements a new feature and updates the issue status to Resolved.

To set up creation of an issue:

1. Add the Create issue trigger action.

2. Click Fill in fields.

3. In the Issue creation window:

   1. Specify the queue to create an issue automatically in.

   2. Set issue parameters and click Save.

4. If you want the Tracker robot to be the issue reporter, select Create as robot. Make sure that the robot has rights for creating issues in the selected queue.

   If the option is disabled, the user whose action fired the trigger will be assigned as the issue's reporter. In this case, the issue will be created only if the user has rights for creating issues in the selected queue.

5. If you want to link the issue that enabled the trigger to the issue created by that trigger, select Link with initial issue.

HTTP requestHTTP request

To send an HTTP request whenever the trigger is fired:

1. Select the HTTP request method.

2. Specify the full URL of the resource to which the request will be sent. For example: http://example.org/newfolder/newfile.

3. Choose the authorization method:

   • NoAuth

     Without authorization.

   • Basic

     You are prompted to enter your username and password.

   • OAuth 2.0

     You're prompted to enter a token, authorization header, and token type.

   The authorization data (username, password, token, authorization header, token type) are transmitted in relevant fields and don't require to be re-entered in headers.

4. Enter the request body.

   You can add issue field values or custom variables to the request body. To do this, click { } to the right of the field and choose the name for the field or value. The request body will include a sequence like {{variable_name}}.

   Note

   You can also use variables in the resource URL and header value.

5. Enter the headers and their values.

6. Add new variables if you need them in the request body or headers. For example, you can add an authentication key or other secret information.

   Note

   When you save the trigger, the variable's value is hidden, and you can't look it up later.

Sample HTTP request settings:

• Sending notifications from Tracker to Slack and Telegram.

• Creating and updating a checklist in an issue.

• Creating an issue with field values from its parent issue.

• Updating status, priority and adding a comment in related issues.