Our new Appfire Documentation Space is now live!

Take a look here! If you have any questions please email support@appfire.com

Build-your-own (scripted) Post-function

Owned by David Fischer
Last updated: Jun 16, 2022 by Richard Stone[Appfire] (Deactivated)
2 min read

This post-function allows you to run an arbitrary Nunjucks template (script). This can be used to create your own post-functions.

To add the 'Build-your-own (scripted)' post-function to a transition: 

  1. Click Edit for the workflow that has the transition, you wish to add the post-function on.

  2. In the Workflow Designer, select the transition.

  3. Click on Post Functions in the properties panel.

  4. Click on Add post function.

  5. Select Build-your-own (scripted) post-function from the list of post-functions.

  6. Click on Add to add the post-function on the transition.

     

  7. Input an optional description in the “Description” field

  8. Input a Nunjucks template that needs to be executed

  9. Click on "Add post function".

See here for a use case for this post-function

When you add this post-function to a transition and trigger it, the specified arbitrary code gets executed.

Known issues common to all post-functions:

Troubleshooting this post-function configuration: In case the post-function does not work as expected these are the things to look out for

JMWE shows an error message on the issue view if any error occurs during the execution of the post-function. This message is displayed only if the current user is a Jira administrator. 

Delayed execution

Use case

Consider a use case where you want to add a worklog entry to the issue. You can do this using the callJira custom Nunjucks filter.

  1. Add the “Build-your-own (scripted)” post-function to the transition

  2. Input the following Nunjucks template

    {{ "/rest/api/2/issue/:issue/worklog" | callJira(verb=("post"), params={"issue":issue.key}, body={ "timeSpent": "1w" } ) | dump(2) }}

     

  3. Save the post-function and publish the workflow

Refer here for more use cases.