Use Cases for Post-Functions (Legacy)
Note: the Use Cases detailed on this page are still mostly valid! However, they are in the process of being updated, both in format and in specific post-function configurations that have been changed in recent JMWE updates.
This section has use cases that help you in understanding the usage of post functions. A few post-functions of JMWE have been deprecated and will no longer be enhanced. However, they still continue to work and you can configure and use the post-functions. But it is recommended to use their replacements instead.
On this Page
- 1 Assign to role member
- 1.1 On the creation of a Bug assign it to a user only if he is a Product Owner
- 1.2 Assign an issue to a member of the QA team when the issue is transitioned to Ready for testing status
- 1.3 Assign an issue to a member of the Support - UTC project role only when the reporter time zone is UTC.
- 1.4 On approving a Story assign the subtasks of the Story to a member of the Developer project role
- 2 Assign to last role member
- 2.1 When a tester reopens an issue assign the issue to a Developer who last worked on it.
- 2.2 After testers have validated an issue, it should be assigned to the last product owner who worked on it for the functional validation. The product owner might either have been explicitly assigned to the issue before, to write the functional specification or have written the specification while creating the issue.
- 2.3 Assign the Story to the tester who last worked on the Story when all the bugs blocking the Story are fixed
- 3 Build-your-own (scripted) Post-function
- 4 Clear fields
- 5 Clear fields of linked issues - Deprecated - Use Clear Fields instead
- 6 Comment issue(s)
- 6.1 A customer using Jira Service Desk should be notified via comment when someone has started working on their support request.
- 6.2 On resolving or closing the issue, comment the issue with a summary of the worklog.
- 6.3 An issue is blocking another and you want to ensure the Assignee of the blocked issue is notified when the impediment has been resolved.
- 6.4 Add a comment on all the sub-tasks when the parent is canceled
- 6.5 On the Approval of an issue, copy the comment added if any to its sub-tasks.
- 6.6 Add a comment on the Epic when its user story is resolved.
- 6.7 The Service Desk Agent responsible for a support request should be notified when the linked Bug is resolved.
- 7 Comment linked issues - Deprecated - Use Comment issue(s) instead
- 7.1 An issue is blocking another and you want to ensure the Assignee of the blocked issue is notified when the impediment has been resolved.
- 7.2 Add a comment on all the sub-tasks when the parent is canceled
- 7.3 On the Approval of an issue, copy the comment added if any to its sub-tasks.
- 7.4 Add a comment on the Epic when its user stories are resolved.
- 7.5 The Service Desk Agent responsible for a support request should be notified when the linked Bug is resolved.
- 8 Copy comments to related issues
- 9 Create issue
- 9.1 Create a documentation ticket only if "Needed" is selected in the "Documentation ticket" checkboxes field
- 9.2 On the approval of a Story, create two sub-tasks: one for Development and another for QA.
- 9.3 We use Jira Service Desk for support and Jira Software for development. When the support agent's problem analysis identifies a bug, a Bug should be created in the development project.
- 9.4 To onboard a new employee in the HR database, create tasks for the New Employee ticket for Configuring a new computer system, Set up an employee phone and Configure a new employee work space.
- 9.5 An Epic has a Story and the Story has a sub-task. When the sub-task is reopened we want to create a bug in another project linking it to the sub-task. On creation of the Bug, set its Epic link to the Story's Epic link
- 9.6 When a user raises a bug report, post-verification, automatically add it to the backlog in the development project and copy the issue links of the Bug to the newly created issue.
- 10 Copy field value from linked issues
- 11 Copy field value to linked issues
- 12 Copy field value from parent issue
- 13 Copy field value to parent issue
- 14 Copy value from field to field
- 14.1 Set the component of an issue with a value selected from a cascading field that carries the Main and Sub-components in parent and child.
- 14.2 Issues in our project are fixed in the version they are found . So I want to copy the Affect versions of the issue to the Fix Versions, on resolving the issue.
- 14.3 I want 'Capture for JIRA Environment' field to be copied to the 'Environment' field when a bug is created using Capture for JIRA.
- 14.4 Copy value from a Single Version Picker select list to the Fix Version(s) field if the resolution provided while closing the issue is "Fixed".
- 15 Delete issue
- 16 Display Message to user
- 17 Email issue
- 18 Increase value of field
- 19 Link issues to the current issue
- 20 Sequence of post-functions
- 20.1 Create a new issue (using the Create Issue(s) post-function) and then send a notification email mentioning the new issue.
- 20.2 To clone an issue and its subtasks to another project
- 20.3 Assign the subtasks of the current issue to the Developers project role and send an email to the assignee of the subtask
- 21 Set field value
- 21.1 Assign a reopened issue to the last person who last commented it.
- 21.2 Automatically add the Reporter of an Epic to the watchers of its User Stories while creating a Story.
- 21.3 Set the due date to today's date
- 21.4 Capture the developer who resolved an issue in a custom single-user picker field
- 21.5 Assign the issue to the current user when the issue is being self-reviewed.
- 21.6 On the reopen of an issue, if a user is selected in the transition screen, verify that the user belongs to the Approvers. If not, assign the issue to the first user of the Approvers field.
- 21.7 On the approval of an issue, append the current user to a multi-user picker custom field only when the current user is listed in "Approvers" field list.
- 21.8 On creating an issue, add it to the first active Sprint of the board the issue belongs to.
- 21.9 Set the due date to issue created plus five days
- 21.10 On the creation of an issue assign the issue to the current user only if the user belongs to the Administrators group.
- 21.11 Copy Jira service desk customers in a multi-user picker field to Request Participants ignoring the reporter of the issue
- 21.12 On creating an issue, pick the component of the issue from a cascading field that carries the Main and Sub-components
- 21.13 Set the Original estimate of the issue to the difference of its creation date and Due date
- 21.14 Set the priority of the issue to Highest if the issue belongs to the "Customer Portal" component
- 21.15 Assign the issue to the Project lead, if the issue is unassigned on creation
- 21.16 Set the Affects Version/s of the issue to Affects Version/s of all its linked issues
- 21.17 Set the Component/s of the issue to components whose lead is the current user
- 21.18 On the creation of a Story, change its priority to that of the Epic if the Epic's priority is lower than the current priority of the Story
- 21.19 On the creation of a Story add the reporter of its Epic to the Watchers
- 21.20 On creating an issue, Copy the component leads of the selected components to a Multi-user picker field
- 21.21 Add the members of the group selected in a custom Single-Group picker to the Watchers of the issue
- 21.22 Identify all comments made between transitions A and B and add them to a custom text field
- 21.23 Select the Installation tasks in the Checkboxes/Multi-select type field when all the Installations are done
- 21.24 Add the time spent during the rework on an issue in the Rework Hours custom field, every time a rework is performed on the ticket
- 21.25 Set the Assignee of the issue based on the selected office
- 21.26 Display the Man hours (a custom Numeric field) of an Epic as the sum of Man hours of all the user stories linked to the Epic.
- 21.27 On the creation of a sub-task add its summary to the description of its parent
- 21.28 Set the issue's due date to the maximum due date set in its sub-tasks.
- 21.29 On the Approval of an issue copy its components to issues linked to it with duplicates link type, only if the linked issue belongs to the same project as the current issue.
- 21.30 Set the assignee of the linked issues with the current user only if the user is the Developer of the linked issue.
- 22 Set field value from user entity property value
- 23 Set field value of linked issues post-function - Deprecated - Use Set field value instead
- 23.1 Display the Man hours (a custom Numeric field) of an Epic as the sum of Man hours of all the user stories linked to the Epic.
- 23.2 On the creation of a sub-task add its summary to the description of its parent
- 23.3 Set the issue's due date to the maximum due date set in its sub-tasks.
- 23.4 On the Approval of an issue copy its components to issues linked to it with duplicates link type, only if the linked issue belongs to the same project as the current issue.
- 23.5 Set the assignee of the linked issues with the current user only if the user is the Developer of the linked issue.
- 24 Shared Action post-function
- 25 Transition issue(s)
- 25.1 Start the progress on an issue immediately after its creation.
- 25.2 Automatically escalate an issue if it is being raised with a "Blocker" priority.
- 25.3 Start the progress on an issue immediately after its creation if the reporter of the issue is a Project Manager.
- 25.4 Transition an issue only when all the Business Approvers approve the request through a comment "Approved"
- 25.5 All the cloned issues of an issue should transition through the workflow in parallel with the current issue.
- 25.6 We use Jira as our internal and external issue tracking system. Every client has his project to log issues into. If the issue is valid, the product owner creates a bug in the internal project and links it to the external issue. I want to automate the closing of external issues when its linked bug in the internal system is closed.
- 25.7 Automatically transition the Epic when all Stories are resolved.
- 25.8 Resolve a support request when the bug blocking it is Resolved.
- 25.9 Start progress on the parent issue when someone started working on its sub-task.
- 25.10 Block the parent from being transitioned until all its subtasks are resolved and automatically transition the Parent when all Subtasks are resolved.
- 26 Transition linked issue - Deprecated - Use Transition issues(s) instead
- 26.1 All the cloned issues of an issue should transition through the workflow in parallel with the current issue.
- 26.2 We use Jira as our internal and external issue tracking system. Every client has his project to log issues into. If the issue is valid, the product owner creates a bug in the internal project and links it to the external issue. I want to automate the closing of external issues when its linked bug in the internal system is closed.
- 26.3 Automatically transition the Epic when all Stories are resolved.
- 26.4 Resolve a support request when the bug blocking it is Resolved.
- 27 Transition parent issue - Deprecated - Use Transition issues(s) instead
- 28 Unlink issues from the current issue
Assign to role member
A workflow post-function that assigns the target issue to a member of a selected project role.
Sample use cases:
On the creation of a Bug assign it to a user only if he is a Product Owner
Assign an issue to a member of the QA team when the issue is transitioned to Ready for testing status
Assign an issue to a member of the Support - UTC project role only when the reporter time zone is UTC.
On approving a Story assign the subtasks of the Story to a member of the Developer project role
Assign to last role member
A workflow post-function that assigns the target issue to the last assignee who belongs to the selected project role.
Sample use cases:
When a tester reopens an issue assign the issue to a Developer who last worked on it.
After testers have validated an issue, it should be assigned to the last product owner who worked on it for the functional validation. The product owner might either have been explicitly assigned to the issue before, to write the functional specification or have written the specification while creating the issue.
Assign the Story to the tester who last worked on the Story when all the bugs blocking the Story are fixed
Build-your-own (scripted) Post-function
A post-function that allows you to run an arbitrary Nunjucks template (script). This can be used to create your own post-functions.
Add a worklog entry to the issue. You can do this using the callJira custom Nunjucks filter.
Clear fields
A workflow post-function that clears the value(s) of the selected field(s) of the target issue.
Clear the Fix Version/s field on the reopening of a ticket.
Clear a set of fields on all the linked issues of the current issue when an Abort is triggered on the current issue
Clear fields of linked issues - Deprecated - Use Clear Fields instead
A workflow post-function that clears the value of the selected field(s) of the issues linked to the current issue through a specific link type.
Clear a set of fields on all the linked issues of the current issue when an Abort is triggered on the current issue
Comment issue(s)
A workflow post-function that creates a comment on the target issue(s). The text of the comment to be created can be any simple text or a text with Nunjucks annotations.
Sample use cases:
A customer using Jira Service Desk should be notified via comment when someone has started working on their support request.
On resolving or closing the issue, comment the issue with a summary of the worklog.
An issue is blocking another and you want to ensure the Assignee of the blocked issue is notified when the impediment has been resolved.
Add a comment on all the sub-tasks when the parent is canceled
On the Approval of an issue, copy the comment added if any to its sub-tasks.
Add a comment on the Epic when its user story is resolved.
The Service Desk Agent responsible for a support request should be notified when the linked Bug is resolved.
Comment linked issues - Deprecated - Use Comment issue(s) instead
A workflow post-function that creates a comment on all issues linked to the current issue through a selected link type. The text of the comment to be created can be any simple text or a text with Nunjucks annotations.
Sample use cases:
An issue is blocking another and you want to ensure the Assignee of the blocked issue is notified when the impediment has been resolved.
Add a comment on all the sub-tasks when the parent is canceled
On the Approval of an issue, copy the comment added if any to its sub-tasks.
Add a comment on the Epic when its user stories are resolved.
The Service Desk Agent responsible for a support request should be notified when the linked Bug is resolved.
Copy comments to related issues
A workflow post-function that copies the comment(s) of the current issue to the specified related issues
Sample use cases:
When a developer transitions an issue to "Customer Feedback" copy the developer's comment on the transition screen to the linked issue.
Configure bi-directional sync of comments between the issues linked through the “causes” link type.
Create issue
A workflow post-function that creates one or more new issue(s). The specifications of the issue(s) to be created can be customized using the options provided.
Sample use cases:
Create a documentation ticket only if "Needed" is selected in the "Documentation ticket" checkboxes field
On the approval of a Story, create two sub-tasks: one for Development and another for QA.
We use Jira Service Desk for support and Jira Software for development. When the support agent's problem analysis identifies a bug, a Bug should be created in the development project.
To onboard a new employee in the HR database, create tasks for the New Employee ticket for Configuring a new computer system, Set up an employee phone and Configure a new employee work space.
An Epic has a Story and the Story has a sub-task. When the sub-task is reopened we want to create a bug in another project linking it to the sub-task. On creation of the Bug, set its Epic link to the Story's Epic link
When a user raises a bug report, post-verification, automatically add it to the backlog in the development project and copy the issue links of the Bug to the newly created issue.
Copy field value from linked issues
A workflow post-function that sets the value(s) of a selected field to the value(s) from the same/different field of an issue linked to the current issue through a selected link type.
Sample use cases:
Copy the Fix Version/s field from the Epic to a Story, while creating a Story.
Automatically add the Reporter of an Epic to the watchers of its User Stories while creating a Story.
Copy field value to linked issues
A workflow post-function that copies the value(s) of a selected field into the same/different field of all issues linked to the current issue through a selected link type.
Sample use cases:
Copy the Fix Version/s field from the Stories to Epic, after resolving a user story.
On resolving an issue, copy the Fix Versions to all the linked issues regardless of the link type.
Copy field value from parent issue
A workflow post-function that sets the value(s) of a selected field with value(s) from the same/different field of an issue's parent issue.
Sample use cases:
When creating a child bug of another bug (i.e. the parent bug), copy the fields Assignee, Component and Affect versions if they are left empty.
Copy field value to parent issue
A workflow post-function that copies the value(s) of a selected field to the same/different field of the issue's parent issue.
Sample use cases :
Copy the labels from each sub-task to its parent when the sub-task is closed.
Copy value from field to field
A workflow post-function that copies the value(s) of a selected field to another field of the same issue.
Sample use cases :
Set the component of an issue with a value selected from a cascading field that carries the Main and Sub-components in parent and child.
Issues in our project are fixed in the version they are found . So I want to copy the Affect versions of the issue to the Fix Versions, on resolving the issue.
I want 'Capture for JIRA Environment' field to be copied to the 'Environment' field when a bug is created using Capture for JIRA.
Copy value from a Single Version Picker select list to the Fix Version(s) field if the resolution provided while closing the issue is "Fixed".
Delete issue
A workflow post-function that deletes one or more issues.
Sample use cases:
Automatically move the issue to a project when it is approved.
On rejecting a Story delete its subtasks
Display Message to user
A workflow post-function that displays a message on the issue view page to the user triggering the transition.
On triggering a transition display a notification message on the issue view if a new issue has been created by the Create Issue(s) post-function with a link to the newly created issue.
Email issue
A post-function that will send an email to certain recipients of the target issues specified in the post-function configuration.
Sample use cases:
Send an Email to the voters of the issue when a new feature is approved.
Send an Email notification when an issue is created but avoid Email notification when the issue is cloned
Send an Email notification to the reporter of the Service Desk ticket when a linked bug is created
Increase value of field
A workflow post-function that increases the value of a selected numerical field by one.
Sample use cases:
Track the number of times a bug fix was rejected by the QA team.
Link issues to the current issue
A post-function that will link the current issue to all issues that satisfy a parameterized JQL query.
Sample use cases:
Link all the Faults in Service desk project to the current issue with "blocks" link type
Sequence of post-functions
A post-function that runs a sequence of JMWE post-functions on the target issues. This is the easiest way of making sure that a series of post-functions run in a predictable order during a transition - it is easier and more reliable than using Delayed execution as was previously recommended.
Create a new issue (using the Create Issue(s) post-function) and then send a notification email mentioning the new issue.
To clone an issue and its subtasks to another project
Assign the subtasks of the current issue to the Developers project role and send an email to the assignee of the subtask
Set field value
A workflow post-function that sets the value of a selected field of the target issues to the specified value
Sample use cases:
Assign a reopened issue to the last person who last commented it.
Automatically add the Reporter of an Epic to the watchers of its User Stories while creating a Story.
Set the due date to today's date
Capture the developer who resolved an issue in a custom single-user picker field
Assign the issue to the current user when the issue is being self-reviewed.
On the reopen of an issue, if a user is selected in the transition screen, verify that the user belongs to the Approvers. If not, assign the issue to the first user of the Approvers field.
On the approval of an issue, append the current user to a multi-user picker custom field only when the current user is listed in "Approvers" field list.
On creating an issue, add it to the first active Sprint of the board the issue belongs to.
Set the due date to issue created plus five days
On the creation of an issue assign the issue to the current user only if the user belongs to the Administrators group.
Copy Jira service desk customers in a multi-user picker field to Request Participants ignoring the reporter of the issue
On creating an issue, pick the component of the issue from a cascading field that carries the Main and Sub-components
Set the Original estimate of the issue to the difference of its creation date and Due date
Set the priority of the issue to Highest if the issue belongs to the "Customer Portal" component
Assign the issue to the Project lead, if the issue is unassigned on creation
Set the Affects Version/s of the issue to Affects Version/s of all its linked issues
Set the Component/s of the issue to components whose lead is the current user
On the creation of a Story, change its priority to that of the Epic if the Epic's priority is lower than the current priority of the Story
On the creation of a Story add the reporter of its Epic to the Watchers
On creating an issue, Copy the component leads of the selected components to a Multi-user picker field
Add the members of the group selected in a custom Single-Group picker to the Watchers of the issue
Identify all comments made between transitions A and B and add them to a custom text field
Select the Installation tasks in the Checkboxes/Multi-select type field when all the Installations are done
Add the time spent during the rework on an issue in the Rework Hours custom field, every time a rework is performed on the ticket
Set the Assignee of the issue based on the selected office
Display the Man hours (a custom Numeric field) of an Epic as the sum of Man hours of all the user stories linked to the Epic.
On the creation of a sub-task add its summary to the description of its parent
Set the issue's due date to the maximum due date set in its sub-tasks.
On the Approval of an issue copy its components to issues linked to it with duplicates link type, only if the linked issue belongs to the same project as the current issue.
Set the assignee of the linked issues with the current user only if the user is the Developer of the linked issue.
Set field value from user entity property value
A workflow post-function that sets the value of a selected field of the current issue to the value of a User Property of the current user.
Sample use cases:
Store the Country, Department, Location, and Pin information of the Reporter of an issue into the issue itself while creating it.
Set field value of linked issues post-function - Deprecated - Use Set field value instead
Display the Man hours (a custom Numeric field) of an Epic as the sum of Man hours of all the user stories linked to the Epic.
On the creation of a sub-task add its summary to the description of its parent
Set the issue's due date to the maximum due date set in its sub-tasks.
On the Approval of an issue copy its components to issues linked to it with duplicates link type, only if the linked issue belongs to the same project as the current issue.
Set the assignee of the linked issues with the current user only if the user is the Developer of the linked issue.
Shared Action post-function
A post-function that runs an Action (a sequence of one or more JMWE post-functions), created in the Shared Actions page, on the target issues.
Sample use cases:
Setting multiple field values on the Create transition of every workflow of the instance
Transition issue(s)
A workflow post-function that triggers a transition on the target issues. This can be used to an issue one step further in the workflow.
Sample use cases:
Start the progress on an issue immediately after its creation.
Automatically escalate an issue if it is being raised with a "Blocker" priority.
Start the progress on an issue immediately after its creation if the reporter of the issue is a Project Manager.
Transition an issue only when all the Business Approvers approve the request through a comment "Approved"
All the cloned issues of an issue should transition through the workflow in parallel with the current issue.
We use Jira as our internal and external issue tracking system. Every client has his project to log issues into. If the issue is valid, the product owner creates a bug in the internal project and links it to the external issue. I want to automate the closing of external issues when its linked bug in the internal system is closed.
Automatically transition the Epic when all Stories are resolved.
Resolve a support request when the bug blocking it is Resolved.
Start progress on the parent issue when someone started working on its sub-task.
Block the parent from being transitioned until all its subtasks are resolved and automatically transition the Parent when all Subtasks are resolved.
Transition linked issue - Deprecated - Use Transition issues(s) instead
A workflow post-function that triggers a transition on all issues linked to the current issue through a selected link type.
Sample use cases:
All the cloned issues of an issue should transition through the workflow in parallel with the current issue.
We use Jira as our internal and external issue tracking system. Every client has his project to log issues into. If the issue is valid, the product owner creates a bug in the internal project and links it to the external issue. I want to automate the closing of external issues when its linked bug in the internal system is closed.
Automatically transition the Epic when all Stories are resolved.
Resolve a support request when the bug blocking it is Resolved.
Transition parent issue - Deprecated - Use Transition issues(s) instead
A workflow post-function that triggers a transition on the parent issue of the current issue.
Sample use cases:
Start progress on the parent issue when someone started working on its sub-task.
Block the parent from being transitioned until all its subtasks are resolved and automatically transition the Parent when all Subtasks are resolved.
Unlink issues from the current issue
This post-function is used to unlink issues from the current issue based on the result of a Groovy condition.
Sample use cases:
On rejection of an issue, unlink all its linked issues