Linked.Archi Converters¶
A unified multi-module project for converting architecture modelling notations to RDF datasets aligned to the Linked.Archi foundational ontology.
Each converter reads a source notation (ArchiMate, BPMN, PlantUML) and produces
a named-graph RDF dataset consumable by rdf2docs, SPARQL engines, and any
RDF-based tooling — without notation-specific logic on the consumer side.
New here? See the big picture first
The End-to-End Workflow shows how converters fit into a full architecture-as-code pipeline: authoring models in a source repo, then aggregating the resulting RDF into one validated knowledge graph.
Quick start¶
# Build all converters
./gradlew build
# Convert a BPMN process to TriG
java -jar converter-bpmn/build/libs/bpmn2linkedarchi.jar convert \
process.bpmn --base-iri https://example.org/la/ \
--model-id demo --format TRIG -o out.trig
# Convert a PlantUML diagram to TriG
java -jar converter-plantuml/build/libs/plantuml2linkedarchi.jar convert \
diagram.puml --base-iri https://example.org/la/ \
--model-id demo --format TRIG -o out.trig
# Convert ArchiMate Exchange XML to TriG
java -jar converter-archimate/build/libs/archimate2linkedarchi.jar convert \
--input model.xml --output out.trig \
--base https://example.org/la/ --model-id demo --format trig
Modules¶
| Module | Purpose | Output JAR |
|---|---|---|
core |
Shared library: IRI minting, type mapping, RDF I/O, base emitter, CLI, verifier | (library) |
svg-core |
SVG rendering interface and base render command | (library) |
converter-archimate |
ArchiMate Exchange XML → RDF | archimate2linkedarchi-all.jar |
converter-bpmn |
BPMN 2.0 XML → RDF | bpmn2linkedarchi.jar |
converter-plantuml |
PlantUML diagrams → RDF | plantuml2linkedarchi.jar |
Package namespace¶
All code lives under archi.linked.converter.*:
archi.linked.converter.core — shared infrastructure
archi.linked.converter.svg — shared SVG rendering
archi.linked.converter.archimate — ArchiMate-specific
archi.linked.converter.bpmn — BPMN-specific
archi.linked.converter.plantuml — PlantUML-specific
Dependency versions¶
| Dependency | Version |
|---|---|
| Kotlin | 2.3.0 |
| RDF4J | 5.3.1 |
| Picocli | 4.7.7 |
| SnakeYAML | 2.5 |
| SLF4J | 2.0.16 |
| Logback | 1.5.16 |
| JUnit 5 | 5.11.4 |
| PlantUML MIT | 1.2025.4 |
| Camunda BPMN Model | 7.22.0 |