Page History

...

AI skill: produce a human-readable diagram of the UNS. Prefer the Designer Relationship Open Visual Graph button. Fall back to generate_uns_visual when AI orchestration is needed.

...

If the user is in Designer and wants the default full-solution view, point them at Unified Namespace → Asset Tree UserTypes → Relationship Open Visual Graph. One click, no AI, works offline. The button produces an interactive HTML file and opens it in the default browser. About 95% of visual-report uses go through this path.

...

generate_uns_visual(scope="full", format="html")
generate_uns_visual(scope="subtree", root_path="/Plant1/Line3")
generate_uns_visual(scope="userTypes", include_inheritance=true, include_references=true)
generate_uns_visual(scope="assetTree")

Output

• Default: MCP tool default: mermaid-md. Markdown with embedded Mermaid blocks, in the Exchange folder under Visualizations/. Good for diffs and source control.
• html: single self-contained interactive file (cytoscape.js). Available in 10.1.5. This is what the Designer button produces.
• svg / png: requires SVG/PNG require mmdc on the host. HTML ships in 10.1.6.Falls back to mermaid-md with a warning if unavailable.
• Same solution plus same parameters produces byte-identical output. Source-control friendly for the mermaid-md and html formats.

Gotchas to surface

• Mermaid clutters past around 500 80 nodes or 200 edges. Suggest subtree or format="html" (interactive, no limit) or narrow via subtree / userTypes scoping first.
• Operators see DisplayText by default, script/MCP users see Name. The diagram shows both (Name is the node ID, DisplayText is the rendered label).
• Reference targets render as dotted edges in AssetTree scope, as → UDT range labels in UserTypes scope.

...