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

There are two ways to select the model elements to include in the Fabric:

Option A — By UUID
  1. Open your Capella model and identify the elements to export.
  2. Copy the UUID(s) for those elements (see the UUID section below).
  3. Export the project as a .zip archive.
  4. Upload the archive and paste the UUIDs into the By UUID tab, then click Inspect UUIDs.
Option B — Browse by Name
  1. Export the project as a .zip archive.
  2. Upload the archive on the Browse by Name tab and click Browse Model.
  3. Select a Phase, an Object Type, and optionally enter a name to filter.
  4. Check the elements you want and click Add Selected & Inspect.

Both options lead to the same Inspect confirmation step, where you can review the selected objects before clicking Generate Fabric.

Exporting the archive: In Capella, right-click the project → Export → Archive File. Save the full project archive — do not use partial exports.

Browse by Name

The Browse by Name option lets you search the model without needing to look up UUIDs in advance. After uploading the archive you are taken to the Browse page, which has three filters:

  • Phase — the Capella architectural layer to search: OA Operational Analysis, SA System Analysis, LA Logical Architecture, or PA Physical Architecture.
  • Object Type — the kind of model element to list (e.g., Component, Function, Capability, Diagram). The available types update automatically when you change the Phase.
  • Name contains — optional free-text filter. Leave blank to list all elements of the selected type. Matching is case-insensitive.

Click Search to run the query. The results table shows the name, type, layer, parent, and UUID of each match. Check one or more rows — or use the header checkbox to select all — then click Add Selected & Inspect to proceed.

Tip: If a name is common (e.g. "Function 1"), use a more specific substring or browse a narrower Object Type to reduce the result set before selecting.

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