Automation for Jira
ScriptRunner provides two actions for Automation for Jira, that let you run your own code.
Due to incompatibly changing APIs in Automation for Jira, we provide two actions. One is deprecated although there are no plans to remove it, and you do not need to migrate to the newer version unless you need access to something only available in the newer version.
Both actions provide simply a way to run a "custom script", but you can call other ScriptRunner functions programmatically.
Binding Variables
- issue
-
The issue object that triggered the event
- currentUser
-
The ApplicationUser defined as the actor for the rule
- initiator
-
The ApplicationUser that initiated the event
- inputs
-
The ComponentInputs. This could be used for example to retrieve the sprint if the trigger is Sprint Created Event.
- ruleContext
-
The current RuleContext. This can be used to evaluate smart values.
Additionally there are two utility functions available for writing information and error messages to the Automation for Jira audit log.
They are addMessage(String message) and addError(String errorMessage)
Example:
addMessage("My message")
addError("My error message")produces:
Smart Values
You can evaluate smart values using ruleContext.renderSmartValues(String) for example:
log.warn ("Initiator of the action was... " + ruleContext.renderSmartValues('{{initiator}}'))Deprecated version
Binding Variables
- issue
-
The issue object that triggered the event
- currentUser
-
The ApplicationUser defined as the actor for the rule
- errorCollection
-
An ErrorCollection - use it to record error conditions, eg
errorCollection.addErrorMessage("Something went wrong") - executionContext
-
Use this if you need to retrieve any information about the rule that is currently firing
Have questions? Visit the Atlassian Community to connect, share, and learn with other Atlassian users and experts, including Adaptavist staff.
Ask a question about ScriptRunner for JIRA, Bitbucket Server, or Confluence.
Want to learn more? Check out courses on Adaptavist Learn, an online platform to onboard and train new users for Atlassian solutions.
