Help Documentation — Capella Fabric Generator

Purpose

This tool generates a Fabric representation from a Capella model that can be consumed by Generative AI tools such as Microsoft Copilot, ChatGPT, Gemini, and Grok. By exporting structured model data as a YAML Fabric file, you can ask AI tools questions about your system architecture grounded in the actual model content.

Workflow Overview

  1. Open and review your Capella model. Identify the model elements (components, functions, interfaces, etc.) that you want to include in the Fabric.
  2. Identify the UUIDs of those model elements. Each element in Capella has a stable UUID — this is what the tool uses to locate and export the element. See the UUID section below for how to find them.
  3. Export the Capella project as a .zip archive. In Capella, right-click the project → Export → Archive File. Save the full project archive — do not use partial exports.
  4. Upload the archive and UUIDs to this tool. The tool will resolve the UUIDs against the model, then generate a structured YAML Fabric file you can download and use with your AI tool of choice.

What is a UUID?

Every model element in Capella is assigned a UUID (Universally Unique Identifier). This is the stable identifier the Fabric Generator uses to locate model elements regardless of their display name or position in the model tree. UUIDs remain consistent even if an element is renamed, making them the reliable key for traceability between Capella and Fabric artifacts.

The UUID looks like: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Finding UUIDs in Capella

Step 3a: Finding UUIDs for a Diagram

UUIDs can be identified directly from a diagram using Capella's Mass Property Visualization feature.

  1. Navigate to the diagram that contains the element of interest.
  2. Right-click the diagram and use the context menu to Show Diagram in Project Explorer.
  3. From the diagram object in the Project Explorer, use the context menu to invoke Send to Mass Visualization View.
  4. In the visualization settings, ensure that Expert mode is enabled. Expert mode exposes additional technical metadata, including UUIDs.
  5. The UUID will be displayed as part of the element's visualized properties.
  6. Select the UUID value and copy it with Ctrl+C.
Note: If UUIDs are not visible, confirm that Mass Property Visualization is active and Expert mode is enabled in the visualization settings.

Step 3b: Finding UUIDs on a Model Element

UUIDs can also be identified directly on a model element using Capella's object level visualization features.

  1. In the Project Explorer, navigate to the model element of interest (for example, a Functional Chain Function, Component, or Actor).
  2. Select the model element.
  3. Open Mass Property Visualization from the context menu or toolbar.
  4. In the visualization settings, ensure that Expert mode is enabled. Expert mode exposes technical metadata that is not shown in standard views.
  5. Review the visualized properties associated with the selected model element.
  6. Locate the UUID in the displayed properties.
  7. Select the UUID value and copy it with Ctrl+C.

This approach allows you to extract UUIDs directly from the semantic model element, independent of any diagram representation.

Note: If the UUID is not visible:
  • Confirm that Mass Property Visualization is active
  • Ensure Expert mode is enabled
  • Verify that the selected item is the semantic element (not a diagram decoration)

Generation Options

When generating a Fabric you can optionally include:

  • Include Realized Elements — pulls in elements from lower layers that are realized by the selected objects (e.g., Logical → Physical).
  • Include Realizing Elements — pulls in elements from higher layers that realize the selected objects (e.g., Physical → Logical).

Ready to begin?

Get Started