# camunda-consulting/migrate-to-camunda-tools architecture

> Architecture diagram of the GitHub repository camunda-consulting/migrate-to-camunda-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/camunda-consulting/migrate-to-camunda-tools
- Repository: https://github.com/camunda-consulting/migrate-to-camunda-tools

## Overview

This repository provides vendor-specific migration utilities that read exported process formats and generate Camunda BPMN, plus IBM diagram-layout tools and a jBPM BPMN cleanup pipeline. The usual user workflow is to provide an input export and an output BPMN file; the README notes that generated models may still need manual work to become executable. The source index and excerpts support the jBPM orchestration and transformation links shown; vendor conversion details are mostly unsampled, so their internal steps are not inferred.

Main entry points: [`JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java`](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java) (Batch Orchestrator), [`JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnDiagramTransport.java`](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnDiagramTransport.java) (BPMN Document), [`JBPM/src/main/java/org/camunda/bpmn/generator/transform`](https://github.com/camunda-consulting/migrate-to-camunda-tools/tree/master/JBPM/src/main/java/org/camunda/bpmn/generator/transform) (BPMN Transformations), [`JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TransformationDraw.java`](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TransformationDraw.java) (Diagram Drawing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vendor["Vendor Converters"]
  node_ibm_twx["IBM TWX Converter"]
  node_oracle["Oracle Converter"]
  node_pega7["Pega Converter 7"]
  node_pega8["Pega Converter 8"]
  node_tibco1["XPDL 1 Converter"]
  node_tibco2["XPDL 2 Converter"]
  node_tibco21_7["XPDL 2.1 Camunda 7"]
  node_tibco21_8["XPDL 2.1 Camunda 8"]
end

subgraph group_ibm["IBM Diagram Layout"]
  node_ibm_layout7["IBM Layout 7"]
  node_ibm_layout8["IBM Layout 8"]
end

subgraph group_jbpm["jBPM Processing"]
  node_pilot["Batch Orchestrator<br/>[Pilot.java]"]
  node_transport["BPMN Document"]
  node_transforms["BPMN Transformations"]
  node_layout_transform["Diagram Drawing"]
  node_tree["Process Tree<br/>[TreeProcess.java]"]
end

subgraph group_support["Validation and Reporting"]
  node_verifications["Model Verification"]
  node_report["Run Report<br/>[Report.java]"]
  node_bpmn_tool["BPMN XML Utilities<br/>[BpmnTool.java]"]
end

node_operator(("Migration User"))
node_input["Vendor Export"]
node_output["Camunda BPMN"]
node_jbpm_user(("jBPM Migration User"))

node_operator -->|"provides export"| node_input
node_operator -->|"requests output"| node_output
node_input -->|"reads export"| node_ibm_twx
node_input -->|"reads export"| node_oracle
node_input -->|"reads export"| node_pega7
node_input -->|"reads export"| node_pega8
node_input -->|"reads export"| node_tibco1
node_input -->|"reads export"| node_tibco2
node_input -->|"reads export"| node_tibco21_7
node_input -->|"reads export"| node_tibco21_8
node_ibm_twx -->|"generates BPMN"| node_output
node_oracle -->|"generates BPMN"| node_output
node_pega7 -->|"generates BPMN"| node_output
node_pega8 -->|"generates BPMN"| node_output
node_tibco1 -->|"generates BPMN"| node_output
node_tibco2 -->|"generates BPMN"| node_output
node_tibco21_7 -->|"generates BPMN"| node_output
node_tibco21_8 -->|"generates BPMN"| node_output
node_operator -.->|"runs layout tool"| node_ibm_layout7
node_operator -.->|"runs layout tool"| node_ibm_layout8
node_ibm_layout7 -.->|"writes diagram BPMN"| node_output
node_ibm_layout8 -.->|"writes diagram BPMN"| node_output
node_jbpm_user -.->|"starts migration"| node_pilot
node_pilot -->|"reads and writes"| node_transport
node_pilot -->|"runs checks"| node_verifications
node_pilot -->|"applies sequence"| node_transforms
node_pilot -->|"records progress"| node_report
node_transforms -->|"includes drawing"| node_layout_transform
node_layout_transform -->|"builds process tree"| node_tree
node_layout_transform -->|"updates document"| node_transport
node_transforms -->|"transforms document"| node_transport
node_transforms -->|"uses XML helpers"| node_bpmn_tool
node_verifications -->|"checks document"| node_transport
node_verifications -->|"reports results"| node_report
node_transport -->|"logs I/O"| node_report

click node_ibm_twx "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/IBM/create%20BPMN%20from%20TWX%20export/src/main/java/org/camunda/bpmn/generator/BPMNGenFromTWX.java"
click node_ibm_layout7 "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/IBM/create%20diagram%20from%20exported%20BPMN/create%20Camunda%207%20BPMN%20from%20exported%20IBM%20BPMN/src/main/java/org/camunda/create/bpmndi/BPMNDiagramGenerator.java"
click node_ibm_layout8 "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/IBM/create%20diagram%20from%20exported%20BPMN/create%20Camunda%208%20BPMN%20from%20exported%20IBM%20BPMN/src/main/java/org/camunda/create/bpmndi/BPMNDiagramGenerator.java"
click node_oracle "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/Oracle/Create%20BPMN%20from%20Oracle%20BPMN/src/main/java/org/camunda/bpmn/generator/BPMNGenFromOracle.java"
click node_pega7 "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/Pega/create%20Camunda%207%20BPMN%20from%20Pega%20XML/src/main/java/org/camunda/bpmn/generator/BPMNGenFromPega.java"
click node_pega8 "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/Pega/create%20Camunda%208%20BPMN%20from%20Pega%20XML/src/main/java/org/camunda/bpmn/generator/BPMNGenFromPega.java"
click node_tibco1 "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/TIBCO/create%20BPMN%20from%20XPDL%201.0%20export/src/main/java/org/camunda/bpmn/generator/BPMNGenFrom1dot0XPDL.java"
click node_tibco2 "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/TIBCO/create%20BPMN%20from%20XPDL%202.0%20export/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL2dot0.java"
click node_tibco21_7 "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/TIBCO/create%20BPMN%20from%20XPDL%202.1%20export/Camunda%207/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL.java"
click node_tibco21_8 "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/TIBCO/create%20BPMN%20from%20XPDL%202.1%20export/Camunda%208/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL.java"
click node_pilot "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java"
click node_transport "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnDiagramTransport.java"
click node_transforms "https://github.com/camunda-consulting/migrate-to-camunda-tools/tree/master/JBPM/src/main/java/org/camunda/bpmn/generator/transform"
click node_layout_transform "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TransformationDraw.java"
click node_tree "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TreeProcess.java"
click node_verifications "https://github.com/camunda-consulting/migrate-to-camunda-tools/tree/master/JBPM/src/main/java/org/camunda/bpmn/generator/verify"
click node_report "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/report/Report.java"
click node_bpmn_tool "https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnTool.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ibm_twx,node_oracle,node_pega7,node_pega8,node_tibco1,node_tibco2,node_tibco21_7,node_tibco21_8,node_operator,node_jbpm_user toneBlue
class node_ibm_layout7,node_ibm_layout8 toneAmber
class node_pilot,node_transport,node_transforms,node_layout_transform,node_tree toneMint
class node_verifications,node_report,node_bpmn_tool toneRose
class node_input,node_output toneIndigo
```

## Components

### Vendor Converters

- [IBM TWX Converter](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/IBM/create%20BPMN%20from%20TWX%20export/src/main/java/org/camunda/bpmn/generator/BPMNGenFromTWX.java): `IBM/create BPMN from TWX export/src/main/java/org/camunda/bpmn/generator/BPMNGenFromTWX.java`
- [Oracle Converter](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/Oracle/Create%20BPMN%20from%20Oracle%20BPMN/src/main/java/org/camunda/bpmn/generator/BPMNGenFromOracle.java): `Oracle/Create BPMN from Oracle BPMN/src/main/java/org/camunda/bpmn/generator/BPMNGenFromOracle.java`
- [Pega Converter 7](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/Pega/create%20Camunda%207%20BPMN%20from%20Pega%20XML/src/main/java/org/camunda/bpmn/generator/BPMNGenFromPega.java): `Pega/create Camunda 7 BPMN from Pega XML/src/main/java/org/camunda/bpmn/generator/BPMNGenFromPega.java`
- [Pega Converter 8](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/Pega/create%20Camunda%208%20BPMN%20from%20Pega%20XML/src/main/java/org/camunda/bpmn/generator/BPMNGenFromPega.java): `Pega/create Camunda 8 BPMN from Pega XML/src/main/java/org/camunda/bpmn/generator/BPMNGenFromPega.java`
- [XPDL 1 Converter](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/TIBCO/create%20BPMN%20from%20XPDL%201.0%20export/src/main/java/org/camunda/bpmn/generator/BPMNGenFrom1dot0XPDL.java): `TIBCO/create BPMN from XPDL 1.0 export/src/main/java/org/camunda/bpmn/generator/BPMNGenFrom1dot0XPDL.java`
- [XPDL 2 Converter](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/TIBCO/create%20BPMN%20from%20XPDL%202.0%20export/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL2dot0.java): `TIBCO/create BPMN from XPDL 2.0 export/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL2dot0.java`
- [XPDL 2.1 Camunda 7](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/TIBCO/create%20BPMN%20from%20XPDL%202.1%20export/Camunda%207/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL.java): `TIBCO/create BPMN from XPDL 2.1 export/Camunda 7/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL.java`
- [XPDL 2.1 Camunda 8](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/TIBCO/create%20BPMN%20from%20XPDL%202.1%20export/Camunda%208/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL.java): `TIBCO/create BPMN from XPDL 2.1 export/Camunda 8/src/main/java/org/camunda/bpmn/generator/BPMNGenFromXPDL.java`

### IBM Diagram Layout

- [IBM Layout 7](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/IBM/create%20diagram%20from%20exported%20BPMN/create%20Camunda%207%20BPMN%20from%20exported%20IBM%20BPMN/src/main/java/org/camunda/create/bpmndi/BPMNDiagramGenerator.java): `IBM/create diagram from exported BPMN/create Camunda 7 BPMN from exported IBM BPMN/src/main/java/org/camunda/create/bpmndi/BPMNDiagramGenerator.java`
- [IBM Layout 8](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/IBM/create%20diagram%20from%20exported%20BPMN/create%20Camunda%208%20BPMN%20from%20exported%20IBM%20BPMN/src/main/java/org/camunda/create/bpmndi/BPMNDiagramGenerator.java): `IBM/create diagram from exported BPMN/create Camunda 8 BPMN from exported IBM BPMN/src/main/java/org/camunda/create/bpmndi/BPMNDiagramGenerator.java`

### jBPM Processing

- [Batch Orchestrator](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java): `JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java`
- [BPMN Document](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnDiagramTransport.java): `JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnDiagramTransport.java`
- [BPMN Transformations](https://github.com/camunda-consulting/migrate-to-camunda-tools/tree/master/JBPM/src/main/java/org/camunda/bpmn/generator/transform): `JBPM/src/main/java/org/camunda/bpmn/generator/transform`
- [Diagram Drawing](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TransformationDraw.java): `JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TransformationDraw.java`
- [Process Tree](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TreeProcess.java): `JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TreeProcess.java`

### Validation and Reporting

- [Model Verification](https://github.com/camunda-consulting/migrate-to-camunda-tools/tree/master/JBPM/src/main/java/org/camunda/bpmn/generator/verify): `JBPM/src/main/java/org/camunda/bpmn/generator/verify`
- [Run Report](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/report/Report.java): `JBPM/src/main/java/org/camunda/bpmn/generator/report/Report.java`
- [BPMN XML Utilities](https://github.com/camunda-consulting/migrate-to-camunda-tools/blob/master/JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnTool.java): `JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnTool.java`

### Other components

- **Migration User**
- **Vendor Export**
- **Camunda BPMN**
- **jBPM Migration User**

## Connections

- Migration User → Vendor Export: provides export
- Migration User → Camunda BPMN: requests output
- Vendor Export → IBM TWX Converter: reads export
- Vendor Export → Oracle Converter: reads export
- Vendor Export → Pega Converter 7: reads export
- Vendor Export → Pega Converter 8: reads export
- Vendor Export → XPDL 1 Converter: reads export
- Vendor Export → XPDL 2 Converter: reads export
- Vendor Export → XPDL 2.1 Camunda 7: reads export
- Vendor Export → XPDL 2.1 Camunda 8: reads export
- IBM TWX Converter → Camunda BPMN: generates BPMN
- Oracle Converter → Camunda BPMN: generates BPMN
- Pega Converter 7 → Camunda BPMN: generates BPMN
- Pega Converter 8 → Camunda BPMN: generates BPMN
- XPDL 1 Converter → Camunda BPMN: generates BPMN
- XPDL 2 Converter → Camunda BPMN: generates BPMN
- XPDL 2.1 Camunda 7 → Camunda BPMN: generates BPMN
- XPDL 2.1 Camunda 8 → Camunda BPMN: generates BPMN
- Migration User → IBM Layout 7: runs layout tool
- Migration User → IBM Layout 8: runs layout tool
- IBM Layout 7 → Camunda BPMN: writes diagram BPMN
- IBM Layout 8 → Camunda BPMN: writes diagram BPMN
- jBPM Migration User → Batch Orchestrator: starts migration
- Batch Orchestrator → BPMN Document: reads and writes (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java`)
- Batch Orchestrator → Model Verification: runs checks (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java`)
- Batch Orchestrator → BPMN Transformations: applies sequence (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java`)
- Batch Orchestrator → Run Report: records progress (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/Pilot.java`)
- BPMN Transformations → Diagram Drawing: includes drawing (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/transform/TransformFactory.java`)
- Diagram Drawing → Process Tree: builds process tree (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TransformationDraw.java`)
- Diagram Drawing → BPMN Document: updates document (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/transform/draw/TransformationDraw.java`)
- BPMN Transformations → BPMN Document: transforms document (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/transform/TransformUserTaskInput.java`)
- BPMN Transformations → BPMN XML Utilities: uses XML helpers (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/transform/TransformUserTaskInput.java`)
- Model Verification → BPMN Document: checks document (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/verify/VerificationInt.java`)
- Model Verification → Run Report: reports results (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/verify/VerificationInt.java`)
- BPMN Document → Run Report: logs I/O (evidence: `JBPM/src/main/java/org/camunda/bpmn/generator/process/BpmnDiagramTransport.java`)
