--- title: "Import and Export BPMN" slug: "import-and-export-bpmn" updated: 2025-06-24T17:38:43Z published: 2025-06-24T17:38:43Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Import and Export BPMN ## Overview Decisions provides the ability to utilize **BPMN**(**Business Process Modeling Notation**) in conjunction with the **Flow****Designer**to create BPMN Diagrams. In addition to being able to create BPMN **Flows**and diagrams using the **Toolbox**, Decisions also provides the ability to **Import****BMPN XML** files/convert them into Workflows and **Export**these diagrams as Decisions .**obj**files. This ability is provided via the **Project****Conversion****Service**and can be accessed via the Upload BMN XML or a POST call. Note on BPMN Formatting Note that Decisions utilizes **BPMN 2.0**notation to import/convert BPMN.  The following document demonstrates how to use the Import and Export feature to utilize BPMN Diagrams within the Decisions Studio environment. Additional DocumentationFor additional information on BPMN in Decisions, see [Creating a BPMN Flow.](https://documentation.decisions.com/docs/creating-a-bpmn-flow) --- ## Example A: Upload BPMN XML The following example demonstrates how to Import a **BPMN****XML**format file into the **Decisions****Studio**environment through use of the **Upload BPMN XML** action. Note on Example The following example utilizes a .**bpmn**file that was constructed using the demo BPMN builder at bpmn.io. To use this tool, navigate to [https://demo.bpmn.io/](https://demo.bpmn.io/)  To Import a **BPMN**File: 1. Create and export a **BPMN****Diagram**using a BPMN tool, or locate a BPMN XML file. 2. Navigate to a **Designer****Project**in Decisions Studio. 3. Right-click the Designer Project then select**Import/Export > Upload BPMN XML**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-24_13h26_42.png) 4. From the Upload BPMN XML window, use the CHOOSE FILE button or drag in a**.bpmn** file into the **Drag file here** field. Then click UPLOAD.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-24_13h27_29.png) 5. Once the File Imports, open the imported Flow to verify that the BPMN Diagram has imported and been properly converted into a **Flow**.Note on Imported File's NameNote that if a **Name**is specified in the **BMPN****XML****File**, then the Flow will Import with the same name. Otherwise, the Flow will appear under the Name "**BPMN Converted Flow"**.  ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-14_12h19_19.png)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-24_13h35_20.png) --- ## Example B: POST Call Note on POST Calls The following document utilizes sending a POST Call in Postman to upload BPMN XML. For more information on POST calls see [Post to Flow Behavior.](https://documentation.decisions.com/v9/docs/post-to-flow-behavior) To configure a POST Call as an alternate method of uploading BPMN XML: 1. From the **Decisions****Studio**, navigate to **System > Administration > Features > All Services**. 2. Scroll to and right-click **ProjectConversionService**, then select **View Integration Details**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-14_12h12_43.png) 3. Locate and select **UploadBpmnProject**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-07-16_12h55_12.png) 4. From the UploadBpmnProject **Integrations****Page**, under **Credentials**, select **Specify****User****Credentials**. Under **Options > Rest Options**, select **POST**. Then, under **Output****Type**, select **XML**. Then copy the **Using POST url**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-07-16_12h57_26(1).png) 5. Open **Postman**and create a new POST call; paste the URL into the **Enter URL Request** box. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-07-16_13h03_05.png) 6. Navigate to the **Body**tab and select **raw**. Back on the View Integrations Page, copy the **Parameters**content, then paste it into the Body text field. Configure the **userid**, **password**, and **folderId**values accordingly. Additional Information on Call Configuration **folderId**represents the designated location (**Designer Project**) that the Flow will import to. **userid**and **password**represent the user's login credentials for Decisions.   Note, the default value for **includeDataSteps**is set to false, setting this value to true will import the **BPMN**with the inclusion of **Data****Input**steps.  ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-07-16_13h07_44.png) 7. After the opening **bpmnDiagramXml**tag, replace **StringValue**, with the desired BPMN XML content, leading the text with ****. Then click **Send**. Note on CDATA TagEnsure that the BPMN XML is encapsulated within the tag, Failing to do so will throw an error in the process and prevent the BPMN from importing.  ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-07-16_13h15_34.png) 8. Navigate to the designated **Designer****Project**, then locate and open the newly imported Flow. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-14_12h16_30.png) 9. Verify that the Flow contains the expected **Shapes**, steps, and **Annotations**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-24_13h38_02.png) --- ## Example C: Export Note on Export Functions Presently, Decisions only offers the ability to Export a BPMN formatted Flow as a .dec obj file, for migration to other Decisions environments. Functionality to Export BPMN Flows as .bpmn files is currently in development.  To export a **BPMN** **Workflow**: 1. Locate the desired **Flow**in **Decisions****Studio**. 2. Right-click the Flow and select **Import/Export > Export**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-14_12h18_11.png) 3. Once the item is ready, click DOWNLOAD. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-14_12h20_32.png) Note on DOWNLOAD Selecting DOWNLOAD will Export and download the desired Flow as a .decObj to the default Download location on the **Local****System**.  ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-07-15_16h18_10.png)