Sazinieties ar
  Sazinieties ar

Getting Started – Digital Twin Visual

Welcome! This guide will help you quickly get started with the Digital Twin visual for Power BI, enabling you to bring your SVG diagrams to life with interactive data.

How to Prepare Your Data

Our Digital Twin visual primarily works with an SVG graphic and can be enhanced with data about its components (nodes) and their relationships (edges)

  • SVG Content (Measure): This is the most crucial field.
  • Provide a text string containing valid SVG markup. This SVG will be rendered as the base of your visual.
  • For best results, ensure elements within your SVG that you want to interact with (nodes) have unique id attributes.

Optional Data for Interactivity & Enrichment:

  • Node ID (Grouping):
  • Provides the unique identifiers for elements within your SVG that represent nodes.
  • These IDs should match the id attributes of the corresponding elements in your “SVG Content”.
  • Node Type (Grouping):
  • Assign a category or type to each node (e.g., “Machine”, “Sensor”, “Tank”).
  • A legend will display unique node types found.
  • Node Status (Grouping):
  • Assign a status to each node (e.g., “Online”, “Error”, “Maintenance”).
  • (Currently, status is ingested but direct conditional formatting based on status values needs to be configured via per-node color settings).
  • Edge ID (Grouping):
  • Unique identifier for each connection/relationship between nodes.
  • Source ID (Grouping):
  • The “Node ID” of the starting point for an edge.
  • Target ID (Grouping):
  • The “Node ID” of the ending point for an edge.

Visual Capabilities Overview

(Here, we’d ideally have short videos/GIFs like the Risk Matrix page. For now, text descriptions.)

  1. Loading Your SVG Diagram:
  • Simply map your text field containing the SVG markup to the “SVG Content” field well. The visual will parse and display your diagram.
  • It respects the viewBox attribute of your root SVG element for initial scaling.
  1. Bringing Nodes to Life:
  • Map your “Node ID” data. If these IDs correspond to element IDs in your SVG, those elements become interactive.
  • Clicking a node will select it (applying a .selected style – ensure you have corresponding CSS in your theme if needed for visual feedback beyond default browser selection) and trigger cross-filtering in other Power BI visuals.
  • Hovering over a node will briefly outline it.
  1. Visualizing Connections (Edges):
  • Provide “Edge ID”, “Source ID”, and “Target ID” data.
  • The visual will attempt to find the center points of the source and target nodes (from your SVG elements) and draw connecting lines.
  • Clicking an edge will select it and trigger cross-filtering.
  • Hovering over an edge will highlight it.
  1. Customizing Node Colors:
  • In the Format Pane, under the “Node Colors” card, you’ll find color pickers for each unique “Node ID” detected in your data.
  • This allows you to individually color elements within your SVG.
  1. Tooltips for Quick Info:
  • Hover over a recognized node in your SVG to see its ID and assigned color.
  • Hover over a drawn edge to see its ID, source, and target nodes.