Skip to content

usm/gen-archimate ​

ArchiMate 3.1 generator — produces an Open Exchange XML model (XMI 2.1) from USM data for enterprise architecture tools.

Why this exists ​

Enterprise architecture teams use ArchiMate tools (Archi, BiZZdesign, Orbus iServer). The ArchiMate generator translates .usm services, features, and data into a standard Open Exchange XML model importable by these tools.

How it works ​

Generate ArchiMate model (gen-archimate) ​

Produce model.xml with ArchiMate elements and relationships

  1. Parse — all .usm files (system, services, features, data)
  2. Generate — XMI elements for ApplicationComponent, BusinessFunction, DataEntity
  3. Generate — XMI relationships (Serving, Realization, Access)
  4. Submit — write model.xml

Flow Diagrams ​

mermaid
sequenceDiagram
    participant User
    participant Browser
    participant Server

    User->>Browser: parse all .usm files (system, services, features, data)
    User->>Browser: generate XMI elements for ApplicationComponent, BusinessFunction, DataEntity
    User->>Browser: generate XMI relationships (Serving, Realization, Access)
    User->>Browser: submit write model.xml

Guarantees ​

archimate-valid-xml ​

Generated XML must conform to the ArchiMate 3.1 Open Exchange format

Acceptance criteria:

  • [ ] Valid XML with proper namespace declarations
  • [ ] Elements organized by ArchiMate layer folders

Test specifications ​

archimate-xml-valid ​

Given:

  • system_with_services_and_features: true

Then:

  • assertion: model.xml is well-formed XML
  • assertion: Contains ApplicationComponent elements for services

Implementation ​

  • Primary: src/generators/archimate.ts
  • Test code status: none

See Also ​

  • usm/gen-togaf