Set field value of related issues

Introduction


Complex element

This workflow element is complex and maybe a little confusing for beginners. If you have any further questions, please contact us via our Customer Portal.


This post function allows you to set a field value of related issues to a given value. For example, this post function can be used in following scenarios:

  • Update the assignee of all linked issues
  • Set subtasks resolution to a given value
Element summary
Status
CURRENT
Version compatibility6.0.1 - Latest
SupportedYes
Introduced in version1.0.0

Post function parameters

 This post function takes the following parameters:

  • Issue relation and JQL - described at the bottom of the page
  • Field - a list of Jira standard and custom fields.
  • Add source value(s) to destination field - ticking this option will add missing options to the destination custom field (if it's dictionary-based) or append a source text to an existing destination field value. (Works only in relevant fields e.g. this option remains hidden for the assignee)
  • Set issue field value - a condition to check on a field
    • Always
    • Only if empty
    • Only if not empty
  • Text value/Option value- a desired field value after the post function execution.


Working with related issues

Related issues can be selected by using two inputs:

Issue Relation - where you can choose a relation with the current (transitioned) issue;

JQL - you can put your JQL text to filter some issues from the results. If you leave the JQL Field empty, all issues in a given relation are taken into account.

In the example above you wanted to execute a workflow function on subtasks of the current issue and take additionally only the ones with the "Sub-task" and priority="High" type.

Tags

In the JQL field you can put some text tags to be replaced with actual values of the current (transitioned) issue:

TagDescription

$$CURRENT_DATETIME$$

The current date and time.
 $$CURRENT_USER$$The name (login) of the current user.
$$ISSUEKEY$$The key of the current issue.
 $$ISSUEID$$ID of the current issue.
 $$REPORTER$$The current issue reporter's name.

$$ASSIGNEE$$

The current issue assignee's name
$$PROJECTKEY$$The project key.
$$CURRENT_STATUS$$The current issue status.
$$ISSUETYPE$$The issue type.
$$CREATED_DATE$$The date when the issue was created.

$$CURRENT_STATUS_CATEGORY$$

A status category of the current issue (To Do, In Progress or Done).
$$TRANSITION_NAME$$The name of an actual transition (doesn't work in Conditions)
$$TRANSITION_ID$$ID of an actual transition (doesn't work in Conditions).
$$TRANSITION_COMMENT$$The content of a transition comment (doesn't work in Conditions).

The JQL field has a built-in validation feature. If your query is incorrect, you will see a red sign next to the JQL field and an error description as shown below:

Example of use