Workflow extensions
Script Master adds three kinds of rule to Jira workflow transitions: post functions, validators and conditions. You add them to a transition in Jira's workflow editor, and Script Master lists every workflow that uses them.
Applies to: Script Master for Jira Β· Cloud
Which rule to useβ
| Rule | Jira name | Runs | Written in | Effect |
|---|---|---|---|---|
| Post function | Scripted Post-function | After the work item moves | Server-side JavaScript, run by the Companion App | Changes data, for example adds a comment or calls another service |
| Validator | Scripted Validator | When someone confirms the transition, after the transition screen | A Jira expression, or rules you build without code | Blocks the transition, with your own message if you want |
| Condition | Scripted Condition | Before Jira shows the transition | A Jira expression, or rules you build without code | Hides the transition |
- To stop a move and tell the person why, use a validator. A condition can't show a message.
- To keep people from seeing a transition at all, use a condition.
- To do something after the move, use a post function.
Validators and conditions run inside Jira, so they work without the Companion App. Post functions need it. See Set up the Companion App.
Where the rules liveβ
A rule is stored with the transition in Jira, not in Script Master. You add, edit and remove it in Jira's workflow editor, and the change takes effect when you select Update workflow. Script Master records each save in the rule's version history.
Pages in this sectionβ
Find and manage rulesβ
- The Workflows tab: every workflow with a scripted rule, and how often the rules run or fail.
Validators and conditionsβ
- Add a validator: block a transition until the work item is ready.
- Add a condition: show a transition only to some people or work items.
- Build a rule without code: checks, templates and messages in the rule builder.
- Write a Jira expression: the expression editor, its live check and snippets.
- Test a rule on a work item: see what Jira would do before you save.
Post functionsβ
- Add a post function: run a script after a transition.
- Test a post function: run the script against a work item.
- Add a comment after a transition: a complete example.
Relatedβ
- Scripted custom fields: fields that compute their value with a script.
- Run history: the recent runs of a post function, with output and errors.
- Jira expressions: Atlassian's reference for the language validators and conditions use.