Transport Across Organization
Moving Workflows Between Environments
When you design and test a workflow in DEV, you'll eventually need to move it to QA for testing and then to PROD.
What Needs to Be Moved
| Item | How to Move |
|---|---|
| Application code | Automatically via CI/CD pipeline |
| Workflow definitions | Export from source → Import to target |
| Forms | Recreate in target environment |
Step-by-Step: Moving a Workflow to a New Environment
Step 1: Verify workflow works correctly in DEV
Step 2: Export workflow from DEV
Step 3: Note all form keys
Step 4: Import workflow into QA
Step 5: Recreate forms in QA
Step 6: Deploy imported workflow in QA
Step 7: Run smoke test in QA
Step 8: Repeat for PROD
Application Code Transport
| Step | Action | Details |
|---|---|---|
| 1 | Developer pushes code | Azure DevOps Git repository |
| 2 | Pipeline triggers | Builds JAR and Docker image |
| 3 | Image pushed to ACR | wblnd.azurecr.io/flowable-latest:<build_number> |
| 4 | Deploy to DEV | DEV manifest |
| 5 | Deploy to QA | QA manifest |
| 6 | Deploy to PROD | PROD manifest |
Environment-Specific Configuration
| Environment | Config Differences |
|---|---|
| DEV | Dev auth server, dev DB |
| QA | QA auth server, QA DB |
| PROD | Prod auth server, prod DB |
Workflow Model Transport
Export from DEV
curl -H "Authorization: Bearer $DEV_TOKEN" \
"https://dev-flowable-url/processDefinitions/bpmn/purchase_approval" \
-o purchase_approval.bpmn20.xml
Import to QA
curl -X POST -H "Authorization: Bearer $QA_TOKEN" \
-F "file=@purchase_approval.bpmn20.xml" \
"https://qa-flowable-url/import"
Deploy in QA
curl -X POST -H "Authorization: Bearer $QA_TOKEN" \
"https://qa-flowable-url/api/models/deploy/{modelId}/{appId}"
Form Transport
Forms are stored in CW_CUSTOM_FORMS table per environment.
- Forms must be recreated in each environment
- Forms are automatically published to ITM on every model deploy
Transport Checklist
1. Verify workflow works in DEV
2. Export BPMN XML or JSON
3. Export form definitions
4. Deploy application Docker image
5. Verify app is running
6. Import workflow model
7. Recreate forms
8. Deploy workflow model
9. Verify forms published to ITM
10. Run smoke test