---
title: "Workflow - Post Function"
canonical: "https://docs.getxporter.app/space/XPORTERCLOUD/460608/Workflow%20-%20Post%20Function"
format: markdown
---
> Macro (rw-ui-expands-macro)
> 
> > Macro (rw-expand)
> 
> > Macro (toc)

## Getting Started

[Xporter](https://marketplace.atlassian.com/apps/891368/xporter-export-issues-from-jira?tab=overview&hosting=cloud) provides the Multi-Action Post Function, a [Workflow Post function](https://confluence.atlassian.com/adminjiraserver073/advanced-workflow-configuration-861253591.html#Advancedworkflowconfiguration-Postfunctions) that allows administrators to define multiple actions that will be performed during transitions in [Jira workflows](https://www.atlassian.com/software/jira/guides/workflows/overview#what-is-a-jira-workflow). 

> ℹ️ <span style="color: #172B4D">"A Jira workflow is a set of statuses and transitions that an issue moves through during its lifecycle, typically representing a process within your organization" (Atlassian, 2024).</span>

## Adding a Workflow

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> In your Jira Cloud instance, click the *Settings*/gear icon on the top right of the screen (Figure 1 - 1).
> 
> ![Figure 1 - Issues](media://e8703767-de25-41fc-a497-eca25c021272)
> 
> Then, select the *Issues* option (Figure 1 - 2). The *Issues* menu will open on the left side of the screen (Figure 2 - 1).
> 
> > Macro (rw-step)
> 
> Click *Workflows* (Figure 2 - 7).
> 
> ![Figure 2 - Workflow](media://0a3c0e39-deb3-4861-8502-16cacaacd260)
> 
> Here, you can:
> 
> - See the list of existing Workflows (Figure 2 - 1).
> - Use the search bar to find existing Workflows (Figure 2 - 2).
> - Add a Workflow (Figure 2 - 3):
>   - Create a new Workflow (Figure 2 - 4; a modal will open for you to enter the name and Workflow's description).
>   - Import a Workflow from the marketplace (Figure 2 - 5; a screen will open for you to select a Workflow from the marketplace).
> - Click the *Actions*/ellipsis button (Figure 2 - 6) to view/edit/copy an existing Workflow.


## Multi-Action Post Function Configuration

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> ### Accessing the Workflows Menu
> 
> 1.1 - In your Jira Cloud instance, click the *Settings*/gear icon on the top right of the screen (Figure 1 - 1).
> 
> Then, select the *Issues* option (Figure 1 - 2).
> 
> 1.2 - The *Issues* menu will open on the left side of the screen (Figure 2 - 1).
> 
> ![Figure 3 - Workflows](media://ac0838ae-8c5d-401c-a920-31223553ae5c)
> 
> 1.3 - Click *Workflows* (Figure 2 - 2). Here you will see the list of active and inactive workflows (Figure 3 - 3).
> 
> > ℹ️ Go [here](https://confluence.atlassian.com/adminjiraserver073/advanced-workflow-configuration-861253591.html#Advancedworkflowconfiguration-postfunctions) to see the full post functions configuration documentation.
> 
> > Macro (rw-step)
> 
> ### Adding the <span style="color: #111111">Xporter Multi-Action to the Transition</span>
> 
> <span style="color: #111111">Select the Xporter Multi-Action option (Figure 4 - 1) and then click the </span>*<span style="color: #111111">Add</span>*<span style="color: #111111"> button (Figure 4 - 2).</span>
> 
> ![Figure 4 - Xporter Multi-Action](media://e2460dee-9c0e-4dce-a9bb-57d47957ef59)
> 
> > Macro (rw-step)
> 
> ### <span style="color: #111111">Adding Parameters to the Function</span>
> 
> ![Figure 5 - Parameters](media://db271fce-3e2f-466a-a905-d0239cf53dbd)
> 
> <span style="color: #111111">Here, you can:</span>
> 
> - Select the template to use (Figure 5 - 1).
> - Choose the output format (Figure 5 - 2).
> - Provide the name of the file you want to generate (Figure 5 - 3; mandatory field).
> - Configure a new post action (Figure 5 - 4). If you click the *Configure* button, a modal will open (Figure 6).
> 
> Once you're finished, click the *Add* button (Figure 5 - 5).
> 
> > Macro (rw-step)
> 
> ### <span style="color: #111111">Configuring an Action</span>
> 
> - <span style="color: #111111">The Xporter Post Function provides different actions and each of them will have its specification (learn more about each action</span><span style="color: #111111"> below)</span><span style="color: #111111">.</span>
> - <span style="color: #111111">The administrator will have the possibility to have more than one action configured to different receivers or to upload the document generated into multiple file servers.</span>
> - <span style="color: #111111">The filename can be modified on each action and it can be specified as a custom name. </span><span style="color: #111111">T</span><span style="color: #172b4d">he filename configuration has a size limit of 50 characters (but the exported file name doesn't have a limit).</span>
> 
> #### <span style="color: #111111">Attach File</span>
> 
> Select this option (Figure 6) if you want the document generated to be attached to the issue that performed the transition.
> 
> ![Figure 6 - Attach File](media://fc80773f-343f-4129-b645-104c2dcbe27e)
> 
> <span style="color: #111111">Here, you can:</span>
> 
> - <span style="color: #111111">Choose one of the different actions. In this case, it is </span>*<span style="color: #111111">Attach File</span>*<span style="color: #111111"> (Figure 6 - 1; mandatory field).</span>
> - <span style="color: #111111">Use the toggle to have the default filename enabled or disabled (Figure 6 - 2). </span><span style="color: #111111">T</span><span style="color: #172b4d">he filename configuration has a size limit of 50 characters (but the exported file name doesn't have a limit).</span>
> - <span style="color: #111111">Enter a file name for the file that will be attached to the issue (Figure 6 - 3; mandatory field).</span>
> 
> Once you're done, click the *Confirm* button (Figure 6 - 4).
> 
> #### Upload File
> 
> <span style="color: #111111">Choose this option (Figure 7) if you want to upload the generated document to a file server. </span><span style="color: #111111">Just pick the server to which the exported file will be saved and, after this, the administrator will have the opportunity to define the path on the filename. </span><span style="color: #111111">T</span><span style="color: #172b4d">he filename configuration has a size limit of 50 characters (but the exported file name doesn't have a limit).</span>
> 
> ![Figure 7 - Upload file](media://5d9c7b76-93c9-46e7-9823-76a1e4fb1f64)
> 
> <span style="color: #111111">Here, you can:</span>
> 
> - <span style="color: #111111">Select one of the different actions. In this case, it is </span>*<span style="color: #111111">Upload File</span>*<span style="color: #111111"> (Figure 7 - 1; mandatory field).</span>
> - <span style="color: #111111">Choose the </span>*<span style="color: #111111">Select file server</span>*<span style="color: #111111"> option (Figure 7 - 2; mandatory field).</span>
> - <span style="color: #111111">Use the toggle to have the default filename enabled or disabled (Figure 7 - 3). </span><span style="color: #111111">T</span><span style="color: #172b4d">he filename configuration has a size limit of 50 characters (but the exported file name doesn't have a limit).</span>
> - <span style="color: #111111">Enter a file name for the file that will be attached to the issue (Figure 7 - 4; mandatory field).</span>
> 
> <span style="color: #111111">Once you're done, click the </span>*<span style="color: #111111">Confirm</span>*<span style="color: #111111"> button (Figure 7 - 5).</span>
> 
> #### Send Email
> 
> Select this option (Figure 8) if you want to send reports by email with a custom body message.
> 
> ![Figure 8 - Send email](media://0d1724dc-c11e-4ed5-94e9-dd3f9ca64ab4)
> 
> <span style="color: #111111">Here, you can:</span>
> 
> - <span style="color: #111111">Choose one of the different actions. In this case, it is </span>*<span style="color: #111111">Send Email</span>*<span style="color: #111111"> (Figure 8 - 1; mandatory field).</span>
> - <span style="color: #111111">Insert the recipient's email address (Figure 8 - 2; mandatory field).</span>
> - <span style="color: #111111">Enter the email subject (Figure 8 - 3; optional field).</span>
> - <span style="color: #111111">Write the email's message (Figure 8 - 4; optional field).</span>
> 
> <span style="color: #111111">Once you're done, click the </span>*<span style="color: #111111">Confirm</span>*<span style="color: #111111"> button (Figure 8 - 5).</span>
> 
> > Macro (rw-step)
> 
> <span style="color: #000000">Actions Overview</span>
> 
> After choosing all the actions that will be performed, Xporter will give you an overview of each action (Figure 9 - 1) with a description (Figure 9 - 2) and the filename (Figure 9 - 3). <span style="color: #111111">T</span><span style="color: #172b4d">he filename configuration has a size limit of 50 characters (but the exported file name doesn't have a limit).</span>
> 
> ![Figure 9 - Actions](media://bb37abac-7e17-41ca-9fee-6f383e9ab51d)
> 
>   
> Here you can also edit (Figure 9 - 4) and/or delete (Figure 8 - 5) the actions <span style="color: #0d0d0d">based on your requirements</span>.
> 
> You can also add a new action (Figure 9 - 6).
> 
> > Macro (rw-step)
> 
> ### <span style="color: #111111">Configuration Concluded</span>
> 
> After the configuration process is finished, the post functions of the transition will look like the screenshot below (Figure 10).
> 
> ![Figure 10 - Post functions](media://370745bc-1292-4030-8a3c-5c2357a9c5bd)
> 
> Here, you can:
> 
> - Publish the draft (Figure 10 - 1), discard the draft (Figure 10 - 2), and/or view the original issue (Figure 10 - 3).
> - Edit (Figure 10 - 4) and/or view the transition's properties (Figure 10 - 5).
> - Add a post function (Figure 10 - 6).

> ℹ️ The mappings that you can include a<span style="color: #0d0d0d">re identical to the </span><span style="color: #0d0d0d">[mappings used](https://docs.getxporter.app/space/XPORTERCLOUD/558575/Mappings)</span>[ inside the templates](https://docs.getxporter.app/space/XPORTERCLOUD/558575/Mappings) with the same notation.
> ℹ️ 
> ℹ️ You can also use these Xporter format functions:
> ℹ️ 
> ℹ️ - [Fields with HTML](https://docs.getxporter.app/space/XPORTERCLOUD/527053/Wiki+Markup%2C+HTML+and+Links)
> ℹ️ - [Formatting Date Fields](https://docs.getxporter.app/space/XPORTERCLOUD/460547/JavaScript)
> ℹ️ - [Formatting Number Field](https://docs.getxporter.app/space/XPORTERCLOUD/558535/Formatting+Fields)
> ℹ️ - [Formatting User Picker Fields](https://docs.getxporter.app/space/XPORTERCLOUD/558535/Formatting+Fields)
> ℹ️ - [Escaping fields](https://docs.getxporter.app/space/XPORTERCLOUD/558535/Formatting+Fields)
> ℹ️ 
> ℹ️ **You can't use JavaScript with these mappings.**


<details>
<summary>Support/Troubleshooting</summary>

If you have questions or technical issues, please [contact the Support team via the Customer Portal (Jira service management)](https://jira.getxray.app/servicedesk/customer/portal/2/user/login?destination=portal%2F2%2Fcreate%2F28) or [send us a message using the in-app chat](https://docs.getxporter.app/space/XPORTERCLOUD/18251779/In-App+Chat+Support).
</details>