Our new Appfire Documentation Space is now live!
Take a look here! If you have any questions please email support@appfire.com
Shared actions
Shared actions allow you to create actions that run one or more post-functions (in a sequence). These actions can then be used in the Shared Action post-function that can be added to multiple workflow transitions. In essence, the shared actions feature enables you to create shared post-functions (that run in a sequence), and add them to various transitions across workflows. This helps you reuse the most common configurations making the maintenance of your workflows simple.
Navigate to the Shared actions page using Jira Settings → Manage apps → Shared actions. This page lists all the existing shared actions and displays where each shared action is used. A shared action can be used in:
Other shared actions
This page also allows you to add new shared actions, or edit, copy, or delete an existing action.
Add a shared action
To add a shared action:
Navigate to Jira Settings → Manage apps → Shared actions.
Click
Add shared action
to navigate to Shared actions editor where you can add the configuration details.Add the following:
Action name: Enter a meaningful name for the action.
Description: Enter a more detailed explanation of what the action would accomplish.
Post-functions: Click
Add post-function
to navigate to the window that lists all the available post-functions. Select a post-function, configure as needed and add it to the list here. The post-functions added here are run in the sequence displayed. You can use the ☰ handle to drag a post-function and drop it wherever required in the list to reorder the sequence.
UseEdit
orRemove
to make changes to the respective post-function or delete it from the list here.
Click
Save
to add the newly created shared action to the Shared actions screen.
Edit a shared action
On the Shared actions page, click the menu icon next the shared action you wish to modify and select
Edit
.Modify the action details in the Shared action editor screen.
Click
Save
to save the changes.
When you try to add a Shared Action post-function while editing a shared action, you notice that the shared action is disabled for selection. This is to avoid creating an infinite loop by adding the shared action to itself.
Copy a shared action
Sometimes it is easier to create a new action based on one that already exists. The Copy option lets you do just that.
On the Shared actions page, click the menu icon next the shared action you wish to duplicate and select
Copy
.A new Shared action is created with “Copy of” in front of the action name.
Follow the steps in Edit a Shared action above, to make modifications.
Delete a shared action
On the Shared actions page, click the menu icon next the shared action you wish to delete and select
Delete
to remove the respective shared action permanently.Click
OK
in the confirmation dialog to confirm. The shared action is deleted.
The Delete
button is disabled when the respective shared action is used in:
Workflow transitions or
other shared actions
You need to remove the references to delete a shared action.
Use a shared action in a workflow
You can use shared actions in a Jira workflow by adding the Shared Action post-function to a transition. This post-function lists all the shared actions configured in the Shared actions page, allowing a workflow administrator to select one action and run it on the specified issue(s).
For example, say you have configured the following actions in the Shared actions page:
To add one of these shared actions to the Shared action post-function:
Click Edit for the workflow that has the transition you wish to configure the post-function on.
In the Workflow Designer, select the transition.
Click
Post Functions
in the properties panel.Click
Add
post function
.Select
Shared Action
from the list of post-functions. You are navigated to the Shared Action Post-function screen.All the shared actions configured in the Shared actions page are displayed here as highlighted. Select one shared action that suits your requirement and configure other details as required.
Click
Add
to add the post-function to the transition.Publish the workflow.