BPMN to STAMP converter (bpmn2stamp)
About
This is a BPMN to STAMP converter, which contains two applications in form of submodules.
- bpmn2stamp - main parent module.
- bpmn2stamp-converter - converter library containing main logic.
- bpmn2stamp-console - CLI tool, uses the bpmn2stamp-converter as a dependency.
Requirements
- Installed JDK of version 11+
- TODO add other requirements if needed (e.g. JAXB)
CLI documentation and usage
The program can be run using by executing the JAR file. The command can be executed using one of the three types: bbo, stamp, and stampFromBbo.
Type: BBO
Will generate a BBO ontology file, containing individuals of a transformed BPMN file, Organization structure fie, and Actor mapping files. Requires the following input arguments to be passed:
- -iam, --inputActorMappings - input *.xml files for the converter, containing actor mapping definitions for every process in the provided bpmn diagram
- -ibpmn, --inputBpmn - input *.bpmn file for the converter, containing process diagram.
- -iorg, --inputOrg - input *.xml file for the converter, containing organization structure definition
- -iri, --baseIri - base IRI for the output ontology. The prefixes will be added to the result files automatically.
- -o, --output - output files directory
Example of usage:
java -jar bpmn2stamp.jar -t bbo -iam "Jednani-sag-actor-mapping.xml" -ibpmn "Jednani-sag.bpmn" -iorg "ucl.xml" -iri "http://jednani-sag-onto" -o "output_bbo.ttl"
Type: Stamp
Will generate a STAMP ontology file, containing individuals of a transformed BPMN file, Organization structure fie, and Actor mapping files. Requires the following input arguments to be passed:
- -iam, --inputActorMappings - input *.xml files for the converter, containing actor mapping definitions for every process in the provided bpmn diagram
- -ibpmn, --inputBpmn - input *.bpmn file for the converter, containing process diagram.
- -iorg, --inputOrg - input *.xml file for the converter, containing organization structure definition
- -iri, --baseIri - base IRI for the output ontology. The prefixes will be added to the result files automatically.
- -o, --output - output files directory
Example of usage:
java -jar bpmn2stamp.jar -t stamp -iam "Jednani-sag-actor-mapping.xml" -ibpmn "Jednani-sag.bpmn" -iorg "ucl.xml" -iri "http://jednani-sag-onto" -o "output_stamp.ttl"
Type: StampFromBbo
Will generate a STAMP ontology file, containing individuals of a transformed BBO file. Requires the following input arguments to be passed:
- -ibbo,--inputBbo - input *.ttl file for the converter, containing individuals of the BBO ontology (typically having the bpmn and organization structure data).
- -iri,--baseIri - base IRI for the output ontology. The prefixes will be added to the result files automatically.
- -o,--output - output file
Example of usage:
java -jar bpmn2stamp.jar -t stampFromBbo -ibbo “jednani-sag_bbo.ttl” -iri "http://jednani-sag-onto" -o "output_stamp.ttl"
Development
JOPA model generation
JOPA model is not generated automatically. Separate parts of the model, i.e. BBO part, BBO Extenstion part, STAMP part can be re-generated using mvn command-line as follows:
mvn jopa:owl2java-transform@generate-bbomvn jopa:owl2java-transform@generate-bbo-emvn jopa:owl2java-transform@generate-stamp
See more information in relavant pom.xml.
Other information
Reference examples of the output ontologies, along with the converter inputs/outputs can be found in BPMN convertor examples repository.
Directory doc contains:
- bbo_to_stamp_diagram - showing how converter maps BPMN elements to STAMP. The diagram consists of BPMN and STAMP concepts, used in the converter with the corresponding mapping for each element.
This work has been supported by the grant No. CK01000204 "Digitalization of integrated aviation safety oversight" of Technology Agency of the Czech Republic.