Example Workflow Extension

Add a Post Function Workflow Extension Example

By way of an example, if you would like to add a Post Function to an existing Jira workflow, follow the steps below:

  1. Click the Cog icon in the top ribbon and select Issues in the Jira settings.
  2. Navigate to the Workflows side menu from within Jira. You will see a list of Active and Inactive workflows displayed.
  3. Click Edit from the Actions ellipsis for your chosen workflow. The workflow opens and can be viewed as either a Diagram or Text, we will use the former for this example.
  4. Select a transition from within the Diagram view. A list of associated workflow functions is displayed for the selected transition including Conditions, Validators, Post Functions, Triggers, and Properties.
  5. Click Post Functions and the workflow's transition options appear.

  6. Click Add post function.
  7. Select the ScriptRunner Post Function option and click Add. The Add Parameters to Function screen appears:
  8. Select a post function from the list of available functions, for example, Add/Remove From Sprint and click Add. You will now see the configuration screen.
  9. In the Description field, enter a short description of the post function.
  10. Select Enable Post Function to enable it as soon as it is added.
  11. Select an Example script from the available examples provided, these can help you get started writing your script in the console. 
  12. Choose from the Action drop down whether to add to a sprint or remove from a sprint.
  13. Choose from the Board Name drop down whether to assign the post function to a particular board.
  14. Choose whether to run the script as an Initiating User or ScriptRunner Add-On User in the Run As dropdown.
  15. Click Add and you are returned to the workflow transition where you will see the newly added post function appear.

You can edit the script on the post function from the workflow itself or quickly access it via the Workflows tab within ScriptRunner for Jira Cloud at any time.

Remember, you can only view Workflows in ScriptRunner for Jira Cloud if you have already created a condition, validator or post function from the Workflows within the Jira Administration menus. Once added within Jira, the workflow then appears in the Workflows section of ScriptRunner for Jira Cloud from where you can edit or disable.
  1. Navigate to ScriptRunner → Workflows. 
    All existing workflows are displayed. You can refine your search by selecting the type of transition option from the Type drop down list (Condition, Validator, or Post Function), or the Workflow Status (active or inactive). You will now see a refined list displayed.
  2. Click the Actions ellipsis for your preferred workflow and select either Edit or Disable.
  • If you choose to disable the chosen workflow, you simply confirm this via a confirmation message once prompted.
  • If you choose to edit the chosen workflow, you will see the workflow details screen displayed from where you can make the required edits to an existing workflow. For example:


On this page