Some Conditions, Validators and Post functions use JQL-selected issues to check, validate or updated them.
These elements are:
Conditons
- Related Issues Field Value condition
- Number of issues having same field value
- Number of Related Issues (links, subtasks or JQL based)
Validators
- Related Issues Field Value validator
- Number of Issues having same field value
- Number of related issues validator
Post Functions
- Set field value of related issues
- Copy field value to related issues
- Transition related issues
- Delete issues
JQL - based feature works as described below:
Working with related issues Related issues can be selected using two inputs: Issue Relation - where you can choose relation to current (transitioned) issue JQL - you can put your JQL text to filter some issues from results. If you leave JQL Field empty, all issues in given relation are taken into account. In example above you want to execute workflow function on subtasks of current issue and additionally take only ones with type of "Sub-task" and priority="High". In JQL Field you can put some text tags to be replaced with actual values of current (transitioned) issue: $$CURRENT_DATETIME$$ $$ASSIGNEE$$ $$CURRENT_STATUS_CATEGORY$$ JQL field has validation feature built-in. If you query is incorrect you can see red sign next to JQL field and error description below:
Tags
Tag Description Current date and time $$CURRENT_USER$$ Name (login) of current user $$ISSUEKEY$$ Key of current issue $$ISSUEID$$ ID of current issue $$REPORTER$$ Current issue reporter's name Current issue current assignee's name $$PROJECTKEY$$ Project key $$CURRENT_STATUS$$ Current issue status $$ISSUETYPE$$ Issue type $$CREATED_DATE$$ Date when issue was created Status category of current issue (To Do, In Progress or Done) $$TRANSITION_NAME$$ Name of actual transition (doesn't work in Conditions) $$TRANSITION_ID$$ ID of actual transition (doesn't work in Conditions) $$TRANSITION_COMMENT$$ Content of transition comment (doesn't work in Conditions) 