Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: HTML format is in 10.1.5 (not 10.1.6); correct button location (UserTypes, not AssetTree); HTML is what the button opens

...

Produce a human-readable diagram of your Unified Namespace (UserTypes, AssetTree, Tags) in interactive HTML, Mermaid / , SVG / , or PNG / HTML.

Standards Compliance How-toIndustrial Ontology → Visual Report

...

Primary path: the

...

Open Visual Graph button

The fastest way is a single click in Designer. No AI required, works offline.

  1. Open Unified Namespace → Asset TreeUserTypes.
  2. On the AssetTree toolbar, click Relationship Open Visual Graph (tooltip: Generate Visual Graph of UNS).
  3. Designer generates a Markdown file with embedded Mermaid diagrams an interactive HTML file and opens it in the your default viewerbrowser. The file lands in the solution's Exchange folder under Visualizations/ as <SolutionName>_UNS_Visual.html.

The HTML is a single self-contained artifact with the UNS nodes and edges embedded. No server required. Pan, zoom, and filter via cytoscape.js inside the browser.

The diagram The output shows:

  • UDT class diagram. Composition members as hasPart edges, Reference members as dotted edges, BaseUserType as inheritance arrows.
  • AssetTree containment. One node per folder, one per Tag, with the /Attr convention made visible.
  • Cross-links. Reference-typed members pointing at other tags.
  • Summary. Counts of UDTs, Enumerations, Tags, folders. Any warnings.

The button is also available on the UNS UserTypes page as Open Visual Graph. Same backend, same output file format.

Alternative path: AI-driven for scripted or fuzzy-intent flows

...

Code Block
languagenone
generate_uns_visual(scope="full", format="html")
generate_uns_visual(scope="subtree", root_path="/Plant1/Line3", format="mermaid-md")
generate_uns_visual(scope="userTypes", include_inheritance=true)

The MCP tool defaults to mermaid-md for scripted diffs. Pass format="html" for the interactive view.

Output ladder

Tier

Format

Best for

1 (default)

mermaid-md (.md)

Docs, handoff, diff. Renders natively in VSCode, GitHub, Obsidian, Confluence. No local tools required.

2

svg / png

Embedding in external docs, tickets, email. Requires mmdc on the host. Falls back to mermaid-md with a warning if unavailable.

3 (button default)

html

Interactive exploration (pan, zoom, filter) via cytoscape.js. Ships . Single self-contained file, no server required. Available in 10.1.65.

Example Mermaid output

Code Block
languagenone
classDiagram
    Motor <|-- Pump : BaseUserType
    class Motor {
      Running : Digital
      Speed : Double
      Temperature : Double
    }
    class Pump {
      FlowRate : Double
      Pressure : Double
    }

...

  • Mermaid starts to struggle around 500 nodes. Narrow 80 nodes or 200 edges. The generator emits an advisory warning above those thresholds. Switch to html (no limit, interactive) or narrow the scope (subtree, userTypes) or escalate to svg.
  • html handles large graphs without performance advisories. Pan, zoom, and filter inside the browser scale well beyond Mermaid's practical limits.
  • Same solution plus same parameters always produces byte-identical output. Safe to check into source control.

...