Verwenden von Azure Digital Twins-Explorer (Vorschau)

Der Azure Digital Twins-Explorer (Vorschau) ist ein Tool für die Visualisierung von Azure Digital Twins und die Arbeit mit ihnen. In diesem Artikel werden die Features von Azure Digital Twins-Explorer und deren Verwendung zum Verwalten der Daten in Ihrer Azure Digital Twins-Instanz beschrieben. Sie können mit dem Azure Digital Twins-Explorer über Klicks oder Tastenkombinationen interagieren.

So erfolgt der Zugriff

Der Zugriff auf den Azure Digital Twins-Explorer erfolgt hauptsächlich über das Azure-Portal.

Um den Azure Digital Twins-Explorer für eine Azure Digital Twins-Instanz zu öffnen, navigieren Sie zunächst im Portal zur Instanz, indem Sie in der Suchleiste des Portals nach ihrem Namen suchen.

Wählen Sie als Nächstes die Schaltfläche Azure Digital Twins-Explorer (Vorschau) öffnen aus.

Screenshot of the Azure portal showing the Overview page for an Azure Digital Twins instance. There's a highlight around the Open Azure Digital Twins Explorer (preview) button.

Dadurch wird der Azure Digital Twins-Explorer auf einer neuen Registerkarte geöffnet. Wenn Sie den Explorer zum ersten Mal verwenden, wird eine modale Willkommensübersicht mit den wichtigsten Features angezeigt.

Azure Digital Twins-Explorer verbindet sich möglicherweise automatisch mit Ihrer Instanz. Wenn nicht, wird der folgende Bildschirm angezeigt, in dem Sie aufgefordert werden, eine Azure Digital Twins-URL anzugeben. (Wenn dieses Feld nicht auf dem Bildschirm angezeigt wird, wurde dieser Schritt bereits automatisch im Azure Digital Twins-Explorer abgeschlossen.)

Screenshot of Azure Digital Twins Explorer. The Azure Digital Twins URL modal displays an empty editable box for the Azure Digital Twins URL.

Wenn dieses Feld angezeigt wird, geben Sie https:// in das Feld ein, gefolgt vom Hostnamen Ihrer Instanz (die Sie auf der Übersichtsseite der Instanz im Portal finden). Diese Werte bilden zusammen die Instanz-URL. Wählen Sie Speichern aus, um eine Verbindung mit Ihrer Instanz herzustellen.

Hinweis

Der gehostete Azure Digital Twins-Explorer kann nur auf Azure Digital Twins-Instanzen mit aktiviertem öffentlichen Zugriff zugreifen. Wenn Sie Private Link verwenden, um den Zugriff auf Ihre Instanz über einen privaten Endpunkt einzuschränken, können Sie Azure-Funktionen verwenden, um die Codebasis von Azure Digital Twins-Explorer privat in der Cloud bereitzustellen. Entsprechende Anweisungen finden Sie unter Azure Digital Twins-Explorer: Ausführen in der Cloud.

Wechseln von Kontexten innerhalb der App

In der Anwendung können Sie auch ändern, welche Instanz derzeit mit dem Explorer verbunden ist, indem Sie auf der oberen Symbolleiste den Instanznamen auswählen.

Screenshot of Azure Digital Twins Explorer. The instance name in the top toolbar is highlighted.

Dadurch wird das modale Dialogfeld „Azure Digital Twins URL“ (Azure Digital Twins-URL) aufgerufen, in dem Sie nach dem Präfix https:// den Hostnamen einer anderen Azure Digital Twins-Instanz eingeben können, um eine Verbindung mit dieser Instanz herzustellen.

Screenshot of Azure Digital Twins Explorer. The Azure Digital Twins URL modal displays an editable box containing https:// and a host name.

Hinweis

Derzeit ist die Möglichkeit zum Wechseln von Kontexten innerhalb der App für persönliche Microsoft-Konten (MSA) nicht verfügbar. MSA-Benutzer müssen aus der gewählten Instanz im Azure-Portal auf den Explorer zugreifen oder über einen direkten Link zur Umgebung eine Verbindung mit einer bestimmten Instanz herstellen.

Abfragen des digitalen Zwillingsgraphen

Sie können den Bereich Abfrage-Explorer verwenden, um Abfragen für Ihren Graphen auszuführen.

Screenshot of Azure Digital Twins Explorer. The Query Explorer panel is highlighted.

Geben Sie die Abfrage ein, die Sie ausführen möchten. Wenn Sie eine mehrzeilige Abfrage eingeben möchten, können Sie im Abfragefeld durch Drücken von UMSCHALT+EINGABE eine neue Zeile hinzufügen.

Wählen Sie die Schaltfläche Abfrage ausführen aus, um Abfrageergebnisse im Bereich Twin Graph (Zwillingsgraph) anzuzeigen.

Hinweis

Abfrageergebnisse, die Beziehungen enthalten, können nur im Bereich Twin Graph (Zwillingsgraph) gerendert werden, wenn die Ergebnisse mindestens einen Zwilling enthalten. Während Abfragen, die nur Beziehungen zurückgeben, in Azure Digital Twins möglich sind, können Sie diese nur im Ausgabebereich im Azure Digital Twins-Explorer anzeigen.

Überlagern von Abfrageergebnissen

Sie können das Kontrollkästchen Overlay results (Ergebnisse überlagern) aktivieren, bevor Sie Ihre Abfrage ausführen, wenn die Ergebnisse gegenüber den derzeit im Bereich Twin Graph angezeigten Ergebnissen hervorgehoben werden sollen, anstatt den Inhalt des Bereichs vollständig durch die neuen Abfrageergebnisse zu ersetzen.

Screenshot of Azure Digital Twins Explorer Query Explorer panel. The Overlay results box is checked, and two twins are highlighted in the larger graph that is shown in the Twin Graph panel.

Wenn das Abfrageergebnis etwas enthalten, das derzeit nicht im Bereich Twin Graph angezeigt wird, wird das Element der vorhandenen Ansicht hinzugefügt.

Speichern und erneutes Ausführen von Abfragen

Abfragen können in Ihrem Browser im lokalen Speicher gespeichert werden, sodass sie einfach ausgewählt und erneut ausgeführt werden können.

Hinweis

Lokaler Browserspeicher bedeutet, dass gespeicherte Abfragen in anderen Browsern als dem, in dem Sie sie gespeichert haben, nicht verfügbar sind, und dass sie auf unbestimmte Zeit im Browserspeicher verbleiben, bis der lokale Speicher gelöscht wird.

Um eine Abfrage zu speichern, geben Sie sie in das Abfragefeld ein, und wählen Sie rechts im Bereich das Symbol Speichern aus. Wenn Sie dazu aufgefordert werden, geben Sie einen Namen für die gespeicherte Suche ein.

Screenshot of Azure Digital Twins Explorer Query Explorer panel. The Save icon is highlighted.

Nachdem die Abfrage gespeichert wurde, können Sie im Dropdownmenü Saved Queries (Gespeicherte Abfragen) auswählen, um sie einfach erneut auszuführen.

Screenshot of Azure Digital Twins Explorer Query Explorer panel. The Saved Queries dropdown menu is highlighted and shows two sample queries.

Um eine gespeicherte Abfrage zu löschen, wählen Sie das Symbol X neben dem Namen der Abfrage aus, wenn das Dropdownmenü Saved Queries (Gespeicherte Abfragen) geöffnet ist.

Tipp

Bei großen Graphen wird empfohlen, nur eine begrenzte Teilmenge abzufragen und dann den Rest des Graphen nach Bedarf zu laden. Sie können im Bereich Twin Graph auf einen Zwilling doppelklicken, um weitere verknüpfte Knoten abzurufen.

Erkunden des Twin Graph

Im Bereich Twin Graph (Zwillingsdiagramm) können Sie die Zwillinge und Beziehungen in Ihrer Instanz untersuchen.

Screenshot of Azure Digital Twins Explorer. The Twin Graph panel is highlighted.

Sie können dieses Panel verwenden, um Zwillingsdaten zu untersuchen.

Der Bereich „Twin Graph“ bietet auch mehrere Möglichkeiten zum Anpassen der Graphanzeige:

Erkunden von Twin-Daten

Führen Sie eine Abfrage mithilfe des Abfrage-Explorers aus, um die Zwillinge und Beziehungen im Abfrageergebnis anzuzeigen, das im Bereich Twin Graph angezeigt wird.

Tipp

Die Abfrage zum Anzeigen aller Zwillinge und Beziehungen ist SELECT * FROM digitaltwins.

Anzeigen von Zwillings- und Beziehungseigenschaften

Um die Eigenschaftswerte eines Zwillings oder einer Beziehung anzuzeigen, wählen Sie den Zwilling oder die Beziehung im Bereich Twin Graph aus, und verwenden Sie die Schaltfläche Toggle property inspector (Eigenschaftenanalyse umschalten), um den Bereich Zwillingseigenschaften bzw. den Bereich Beziehungseigenschaften zu erweitern. In diesem Bereich werden alle dem Element zugeordneten Eigenschaften sowie deren Werte angezeigt. Er enthält auch Standardwerte für Eigenschaften, die noch nicht festgelegt wurden.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and the Twin Properties panel is expanded, showing the properties of the twin.

Datentyp-Symbole

Die in den Dialogfeldern Zwillingseigenschaften und Beziehungseigenschaften angezeigten Eigenschaften werden jeweils mit einem Symbol dargestellt, das den Typ des Feldes aus dem DTDL-Modell angibt. Sie können den Mauszeiger über ein Symbol bewegen, um den zugehörigen Typ anzuzeigen.

Die folgende Tabelle zeigt die möglichen Datentypen und die entsprechenden Symbole. Die Tabelle enthält auch Verknüpfungen von jedem Datentyp zu seiner Schemabeschreibung in der DTDL v3-Sprachbeschreibung.

Schaltfläche Datentyp
boolean icon boolean
component icon Komponente
date icon date
dateTime icon dateTime
duration icon duration
enum icon enum
map icon map
numeric icon Numerische Typen, einschließlich Double, Float, Integer und Long
object icon object
string icon string
time icon time
Errors

Im Bereich „Zwillingseigenschaften“ werden Fehlermeldungen angezeigt, wenn der Zwilling oder einige seiner Eigenschaften nicht mehr mit dem zugehörigen Modell übereinstimmen.

Es gibt zwei mögliche Fehlerszenarien, die jeweils eine eigene Fehlermeldung ergeben:

  • Ein oder mehrere vom Zwilling verwendete Modelle fehlen. Infolgedessen werden alle Eigenschaften, die mit diesem Modell verbunden sind, im Fenster Zwillingseigenschaften als "fehlend" gekennzeichnet. Dieser Fehler kann passieren, wenn das Modell seit der Erstellung des Zwillings gelöscht wurde.
  • Einige Eigenschaften des Zwillings sind nicht Teil des Zwillingsmodells. Nur diese Eigenschaften werden im Fenster Zwillingseigenschaften als "fehlend" gekennzeichnet. Dieser Fehler kann passieren, wenn das Modell für den Zwilling ersetzt oder geändert wurde, seit die Eigenschaften festgelegt wurden, und die Eigenschaften in der neuesten Version des Modells nicht mehr vorhanden sind.

Die beiden Fehlermeldungen sind in der folgenden Abbildung dargestellt:

Screenshot of Azure Digital Twins Explorer Twin Properties panel, showing two error messages. One error indicates that models are missing, and the other indicates that properties are missing a model.

Überprüfen und Erkunden von historisierten Eigenschaften

Wenn Ihre Azure Digital Twins-Instanz den Datenverlauf aktiviert hat, können Sie ihre historisierten Daten im Azure Digital Twins Explorer überprüfen und untersuchen. Führen Sie die folgenden Schritte aus, um historisierte Daten in einem Diagramm zu visualisieren oder Rohwerte in einer Tabelle anzuzeigen.

  1. Wählen Sie im Twin Graph-Viewer einen Zwilling aus, dessen historisierte Eigenschaften Sie anzeigen möchten, um sie im Bereich "Twin Properties " zu öffnen. Wählen Sie in der oberen rechten Ecke des Bereichs das Symbol "Zeitreihe" aus, um den Datenverlauf-Explorer zu öffnen.

    Screenshot of Azure Digital Twins Explorer Twin Properties panel, highlighting the icon to open the data history explorer.

  2. Wählen Sie den Zwillingsnamen von links aus, um die Optionen für die Auswahl der historischen Eigenschaften des Zwillings anzuzeigen. Das Feld "Twin ID " wird bereits mit der Twin-Auswahl ausgefüllt. Neben diesem Feld können Sie das Symbol "Eigenschaften prüfen" auswählen, um die Zwillingsdaten anzuzeigen, oder das Symbol "Erweiterte Zwillingssuche ", um andere Zwillinge zu finden, indem Sie Eigenschaftswerte abfragen.

    Screenshot of the Data history explorer and a modal asking for twin and property details.

  3. Wählen Sie im Feld "Eigenschaft " die Eigenschaft aus, deren historisierte Daten Sie anzeigen möchten. Wenn die Eigenschaft nicht numerisch ist, aber aus numerischen Werten besteht, verwenden Sie den Wert der Cast-Eigenschaft, um zu versuchen , diese Daten in Zahlen zu umwandeln, damit sie im Diagramm visualisiert werden können.

    Screenshot of the Data history explorer with the property details highlighted.

    Hinweis

    Wenn Sie eine Eigenschaft aus der Dropdownliste nicht auswählen können, da die Liste nicht reagiert, bedeutet dies möglicherweise, dass in einer Instanz ein Fehler auftritt. Wenn sie beispielsweise nicht eindeutige Enumerationswerte in den Attributen eines Modells haben, wird dieses Feature unterbrochen. Überprüfen Sie in diesem Fall Ihre Modelldefinitionen, und stellen Sie sicher, dass alle Eigenschaften gültig sind.

  4. Wählen Sie eine Bezeichnung für die Zeitreihe aus, und wählen Sie "Aktualisieren" aus.

Dadurch wird die Diagrammansicht der historisierten Werte für die ausgewählte Eigenschaft geladen. Sie können die Registerkarten über dem Diagramm verwenden, um zwischen der Diagrammansicht und der Tabellenansicht umzuschalten.

Wenn Sie der Visualisierung weitere Eigenschaften hinzufügen möchten, verwenden Sie die Schaltfläche "Zeitreihen hinzufügen" auf der linken Seite.

Screenshot of the Data history explorer highlighting the option to add another time series.

Um den Datenverlaufs-Explorer zu beenden und zum Standard Azure Digital Twins Explorer zurückzukehren, wählen Sie "Schließen" aus.

Anzeigen des Verlaufs im Diagramm

Die Diagrammansicht von historisierten Eigenschaften zeigt Eigenschaftswerte als Punkte in einem Liniendiagramm im Laufe der Zeit an.

Screenshot of the Data history explorer showing a chart of historized values for a property.

Sie können die Symbole über dem Diagramm verwenden, um die Diagrammeinstellungen zu steuern, einschließlich...

  • Ändern des Zeitraums für die Daten, die im Diagramm enthalten sind.
  • Auswählen, ob mehrere Zeitreihen unabhängig oder auf einer freigegebenen y-Achse angezeigt werden. Wenn Sie "Unabhängig" für die Achsen auswählen, bedeutet dies, dass jede Zeitreihe auf das Diagramm skaliert wird und Standard ihre eigene Achse für die Skalierung beibehalten. Wenn Sie freigegebene Achsen auswählen, bedeutet dies, dass alle Datenreihen auf dieselbe Achse skaliert werden.
  • Auswählen der Aggregationslogik für das Diagramm. Wenn die Eigenschaft mehr Datenpunkte aufweist, als im Diagramm angezeigt werden können, werden die Daten mithilfe von Mittelwert- oder Minimal- oder Maximalfunktionen in einer begrenzten Anzahl von Datenpunkten aggregiert.

Es gibt auch eine Schaltfläche zum Öffnen der Abfrage im Azure-Daten-Explorer, in der Sie die aktuelle Abfrage anzeigen und ändern können, um die Daten der Zeitreihen weiter zu untersuchen.

Screenshot of the button to open query in Azure Data Explorer.

Anzeigen des Verlaufs in einer Tabelle

Die Tabellenansicht der historisierten Eigenschaften zeigt Eigenschaftswerte und deren Zeitstempel in einer Tabelle an.

Screenshot of the Data history explorer showing a table of historized values for a property.

Sie können die Symbole oberhalb der Tabelle verwenden, um die Tabelleneinstellungen zu steuern, einschließlich...

  • Ändern des Zeitraums für die Daten, die in der Tabelle enthalten sind.
  • Herunterladen der Tabellendaten für eine unabhängige Analyse.

Anzeigen der Beziehungen eines Zwillings

Sie können auch schnell den Code aller Beziehungen anzeigen, die sich auf einen bestimmten Zwilling beziehen (einschließlich eingehender und ausgehender Beziehungen).

Klicken Sie mit der rechten Maustaste auf einen Zwilling im Graphen, und wählen Sie Get relationships (Beziehungen abrufen) aus. Dadurch wird ein modales Dialogfeld Relationship Information (Beziehungsinformationen) geöffnet, das die JSON-Darstellung aller eingehenden und ausgehenden Beziehungen anzeigt.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The center of the screen displays a Relationship Information modal showing Incoming and Outgoing relationships.

Ändern der Anzeigeeigenschaft des Zwillings

Sie können konfigurieren, welche Eigenschaft Sie anzeigen möchten, um Zwillinge in Ihrem Zwillingsgraphen zu identifizieren. Die Standardeinstellung ist der $dtId-Wert, aber Sie können aus allen Eigenschaften auswählen, die in Ihrem Modellsatz vorhanden sind (auch diejenigen, die nicht auf jedem Zwilling vorhanden sind).

Um die Anzeigeeigenschaft zu ändern, verwenden Sie das Dropdownmenü Select Twin Display Name Property (Auswählen der Anzeigenamenseigenschaft des Zwillings). Das Dropdownmenü ist nach der Anzahl der Modelle geordnet, die die Eigenschaft enthalten.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Select Twin Display Name Property button is highlighted, showing a menu that lists different properties of the twins in the graph.

Wenn Sie eine Eigenschaft auswählen, die nicht auf jedem Zwilling vorhanden ist, werden alle Zwillinge im Graphen, die nicht über diese Eigenschaft verfügen, mit einem Sternchen (*) gefolgt von ihrem $dtId-Wert angezeigt.

Bearbeiten des Layouts des Zwillingsgraphen

Sie können die Zwillinge in verschiedenen Konfigurationen neu anordnen, indem Sie auf sie klicken und sie auf dem Bildschirm „Twin Graph“ verschieben.

Sie können auch einen von mehreren Layoutalgorithmen über die Optionen im Menü Choose Layout (Layout wählen) auf den Graphen anwenden.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Choose Layout button is highlighted, showing a menu with the layout options Cola, Dagre, fCoSE, and Klay.

Steuern der Erweiterung des Zwillingsgraphen

Beim Anzeigen eines Abfrageergebnisses im Bereich Twin Graph können Sie auf einen Zwilling doppelklicken, damit der Graph seine Beziehungen und zugehörigen Zwillinge abruft und diese anzeigt, wenn sie nicht bereits in der Ansicht vorhanden sind. Sie können diese Erweiterung anpassen, indem Sie eine Größe und Richtung festlegen, um zu bestimmen, wie viele Zwillinge abgerufen werden sollen.

Verwenden Sie die Option Expansion Level (Erweiterungsebene), um die Anzahl der Ebenen festzulegen, die erweitert werden sollen. Diese Zahl gibt an, wie viele Ebenen von Beziehungen vom ausgewählten Zwilling abgerufen werden sollen.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Expansion Level button is highlighted.

Verwenden Sie die Schaltfläche Expansion Direction (Erweiterungsrichtung), um anzugeben, welchen Beziehungstypen beim Erweitern gefolgt werden soll. Auf diese Weise können Sie zwischen eingehenden, ausgehenden oder eingehenden sowie ausgehenden Beziehungen auswählen.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Expansion Direction button is highlighted, showing a menu with the options In, Out, and In/Out.

Anzeigen und Ausblenden von Zwillingsgraphelementen

Sie können die Option umschalten, um Zwillinge oder Beziehungen in der Graphenansicht auszublenden.

Um einen Zwilling oder eine Beziehung auszublenden, klicken Sie im Fenster Twin Graph mit der rechten Maustaste darauf. Dadurch wird ein Menü mit Optionen zum Ausblenden des Elements oder anderer verwandter Elemente geöffnet.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and there's a menu containing options to Hide selected, Hide selected + Children, Hide all others, and Hide non children.

Sie können auch mehrere Zwillinge oder Beziehungen gleichzeitig ausblenden, indem Sie die Tasten STRG/CMD oder UMSCHALT drücken, um mehrere Elemente desselben Typs im Graphen gleichzeitig auszuwählen. Klicken Sie wie zuvor beschrieben mit der rechten Maustaste, um die Optionen zum Ausblenden anzuzeigen.

Um alle Zwillinge erneut anzuzeigen, nachdem einige ausgeblendet waren, verwenden Sie die Schaltfläche Show All (Alle anzeigen). Um alle Beziehungen anzuzeigen, verwenden Sie die Schaltfläche Show All Relationships (Alle Beziehungen anzeigen).

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Show All and Show All Relationships buttons are highlighted.

Filtern und Hervorheben von Zwillingsgraphelementen

Sie können die Zwillinge und Beziehungen, die im Diagramm angezeigt werden, nach Text filtern, indem Sie dieses Filtersymbol auswählen:

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The text filter icon is selected, showing the Filter tab where you can enter a search term.

Sie können die Zwillinge und Beziehungen, die im Diagramm erscheinen, auch durch Text hervorheben, indem Sie das Symbol Hervorheben wählen:

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The text filter icon is selected, showing the Highlight tab where you can enter a search term.

Verwalten von Zwillingen und Graphen

Der Azure Digital Twins-Explorer bietet mehrere Möglichkeiten zum Verwalten der Zwillinge und Beziehungen in Ihrer Instanz.

In diesem Abschnitt wird beschrieben, wie Sie die folgenden Verwaltungsaktivitäten durchführen:

Informationen zu Anzeigeoptionen für Zwillinge und Beziehungen finden Sie unter Untersuchen von Zwillingen und des Zwillingsgraphen.

Anzeigen einer flachen Liste von Zwillingen und Beziehungen

Im Bereich Zwillinge wird eine flache Liste der Zwillinge und der zugehörigen Beziehungen angezeigt. Sie können Zwillinge nach dem Namen suchen und diese erweitern, um Details zu ihren eingehenden und ausgehenden Beziehungen zu erhalten.

Screenshot of Azure Digital Twins Explorer Twins panel. A twin is highlighted and its relationships are shown.

Erstellen von Zwillingen

Sie können einen neuen digitalen Zwilling aus seiner Modelldefinition im Bereich Models (Modelle) erstellen.

Um einen Zwilling aus einem Modell zu erstellen, suchen Sie nach diesem Modell in der Liste, und wählen Sie dann neben dem Modellnamen die Menüpunkte. Wählen Sie anschließend Create a Twin (Einen Zwilling erstellen). Sie werden aufgefordert, einen Namen für den neuen Zwilling einzugeben, der eindeutig sein muss. Speichern Sie den Zwilling dann. Er wird Ihrem Graphen hinzugefügt.

Screenshot of Azure Digital Twins Explorer Models panel. The menu dots for a single model are highlighted, and the menu option to Create a Twin is also highlighted.

Um Ihrem Zwilling Eigenschaftswerte hinzuzufügen, siehe Eigenschaften von Zwillingen und Beziehungen bearbeiten.

Erstellen von Beziehungen

Um eine Beziehung zwischen zwei Zwillingen zu erstellen, wählen Sie zunächst den Quellzwilling für die Beziehung im Fenster Twin Graph (Zwillingsdiagramm) aus. Halten Sie als dann eine Taste STRG/CMD oder UMSCHALT gedrückt, während Sie einen zweiten Zwilling als Ziel der Beziehung auswählen.

Sobald die beiden Zwillinge gleichzeitig ausgewählt sind, klicken Sie mit der rechten Maustaste auf den Zielzwilling, um ein Menü mit der Option zum Hinzufügen von Beziehungen zwischen ihnen aufzurufen.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA and Consumer twins are selected, and a menu shows the option to Add relationships.

Dadurch wird das Dialogfeld Beziehung erstellen geöffnet, das mit dem Quellzwilling und dem Zielzwilling der Beziehung aufgefüllt ist. (Sie können auch das Symbol Beziehung tauschen verwenden, um sie zu vertauschen.) Das verfügbare Dropdownmenü Beziehung enthält die möglichen Arten von Beziehungen für den Quellzwilling gemäß seines DTDL-Modells. Wählen Sie eine Option für den Beziehungstyp aus, und speichern Sie die neue Beziehung.

Zwillings- und Beziehungseigenschaften bearbeiten

Um die Eigenschaftswerte eines Zwillings oder einer Beziehung anzuzeigen, wählen Sie das Element im Bereich Twin Graph aus, und verwenden Sie die Schaltfläche Toggle property inspector (Eigenschaftenanalyse umschalten), um den Bereich Zwillingseigenschaften bzw. den Bereich Beziehungseigenschaften zu erweitern.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and the Twin Properties panel is expanded, showing the properties of the twin.

Sie können diesen Bereich verwenden, um beschreibbare Eigenschaften direkt zu bearbeiten. Aktualisieren Sie ihre Werte inline und wählen Sie die Schaltfläche Änderungen speichern oben im Bedienfeld, um sie zu speichern. Wenn die Aktualisierung gespeichert wird, wird auf dem Bildschirm ein modales Fenster mit dem JSON Patch-Vorgang angezeigt, der von der Update-API angewendet wurde.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The center of the screen displays a Path Information modal showing JSON Patch code.

Tipp

Die in den Dialogfeldern Zwillingseigenschaften und Beziehungseigenschaften angezeigten Eigenschaften werden jeweils mit einem Symbol dargestellt, das den Typ des Feldes aus dem DTDL-Modell angibt. Für weitere Informationen über die Typensymbole siehe Datentypensymbole.

Löschen von Zwillingen und Beziehungen

Um einen Zwilling oder eine Beziehung zu löschen, klicken Sie im Fenster Twin Graph mit der rechten Maustaste darauf. Dadurch wird ein Menü mit einer Option zum Löschen des Elements angezeigt.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and there's a menu containing an option to Delete twin(s).

Sie können auch mehrere Zwillinge oder Beziehungen gleichzeitig löschen, indem Sie die Tasten STRG/CMD oder UMSCHALT drücken, um mehrere Elemente desselben Typs im Graphen gleichzeitig auszuwählen. Klicken Sie wie zuvor beschrieben mit der rechten Maustaste, um die Elemente zu löschen.

Sie können auch alle Zwillinge in Ihrer Instanz gleichzeitig löschen, indem Sie auf der oberen Symbolleiste die Schaltfläche Delete All Twins (Alle Zwillinge löschen) verwenden.

Screenshot of Azure Digital Twins Explorer. The Delete All Twins icon is selected.

Untersuchen von Modellen und des Modellgraphen

Modelle können sowohl im Bereich Models (Modelle) auf der linken Seite des Azure Digital Twins-Explorer-Bildschirms als auch im Bereich Model Graph (Modellgraph) in der Mitte des Bildschirms angezeigt werden.

Der Bereich Models (Modelle): Screenshot of Azure Digital Twins Explorer. The Models panel is highlighted.

Der Bereich Model Graph (Modellgraph): Screenshot of Azure Digital Twins Explorer. The Model Graph panel is highlighted.

Hinweis

Derzeit unterstützt Azure Digital Twins Explorer dtDL v2-Modelle vollständig und unterstützt eingeschränkte Funktionen für DTDL v3-Modelle. In Azure Digital Twins Explorer können DTDL v3-Modelle im Bereich "Modelle" angezeigt werden, und Zwillinge, die mit DTDL v3-Modellen erstellt wurden, können angezeigt und bearbeitet werden (einschließlich der Modelle mit Arrayeigenschaften). DTDL v3-Modelle werden jedoch nicht im Bereich "Modelldiagramm" angezeigt, und sie können nicht mit Azure Digital Twins Explorer importiert werden. Um DTDL v3-Modelle in Ihre Instanz zu importieren, verwenden Sie eine andere Entwicklerschnittstelle wie die APIs und SDKs oder die Azure CLI.

Sie können diese Bereiche verwenden, um Ihre Modelle anzuzeigen.

Der Bereich „Model Graph“ bietet auch mehrere Möglichkeiten zum Anpassen der Graphanzeige:

Modelle anzeigen

Sie können eine unformatierte Liste der Modelle in Ihrer Instanz im Bereich Models (Modelle) anzeigen. Diese Liste kann über die Suchleiste im Bereich durchsucht werden.

Sie können den Bereich Model Graph (Modellgraph) verwenden, um eine grafische Darstellung der Modelle in Ihrer Instanz zusammen mit den Beziehungen, der Vererbung und den Komponenten, die sie miteinander verbinden, anzuzeigen.

Hinweis

Derzeit unterstützt Azure Digital Twins Explorer dtDL v2-Modelle vollständig und unterstützt eingeschränkte Funktionen für DTDL v3-Modelle. In Azure Digital Twins Explorer können DTDL v3-Modelle im Bereich "Modelle" angezeigt werden, und Zwillinge, die mit DTDL v3-Modellen erstellt wurden, können angezeigt und bearbeitet werden (einschließlich der Modelle mit Arrayeigenschaften). DTDL v3-Modelle werden jedoch nicht im Bereich "Modelldiagramm" angezeigt, und sie können nicht mit Azure Digital Twins Explorer importiert werden. Um DTDL v3-Modelle in Ihre Instanz zu importieren, verwenden Sie eine andere Entwicklerschnittstelle wie die APIs und SDKs oder die Azure CLI.

Anzeigen der Modelldefinition

Um die vollständige Definition eines Modells anzuzeigen, suchen Sie dieses Modell im Bereich Models (Modelle), und wählen Sie die Menüpunkte neben dem Modellnamen. Wählen Sie anschließend View Model (Modell anzeigen). Dadurch wird ein modales Dialogfeld Model Information (Modellinformationen) angezeigt, das die unformatiert DTDL-Definition des Modells enthält.

Screenshot of Azure Digital Twins Explorer Models panel. The menu dots for a single model are highlighted, and the menu option to View Model is also highlighted.

Sie können auch die vollständige Definition eines Modells anzeigen, indem Sie es im Bereich Model Graph (Modellgraph) auswählen und die Schaltfläche Toggle model details (Modelldetails umschalten) verwenden, um den Bereich Model Detail (Modelldetails) zu erweitern. In diesem Bereich wird auch der vollständige DTDL-Code für das Modell angezeigt.

Screenshot of Azure Digital Twins Explorer Model Graph panel. The Floor model is selected, and the Model DetailS panel is expanded, showing the DTDL code of the model.

Bearbeiten des Modellgraphlayouts

Sie können die Modelle in verschiedenen Konfigurationen neu anordnen, indem Sie auf sie klicken und sie auf dem Bildschirm „Model Graph“ verschieben.

Sie können auch einen von mehreren Layoutalgorithmen über die Optionen im Menü Layout wählen auf den Graphen anwenden.

Screenshot of Azure Digital Twins Explorer Model Graph panel. The Choose Layout button is highlighted, showing a menu with the layout options Cola, Dagre, fCoSE, Klay, and d3Force.

Filtern und Hervorheben von Modellgraphelementen

Sie können die Typen von Modellverweise filtern, die im Modelldiagramm angezeigt werden. Wenn Sie einen der Verweistypen über die Schalter in diesem Menü deaktivieren, wird verhindert, dass dieser Verweistyp im Diagramm angezeigt wird.

Screenshot of Azure Digital Twins Explorer Model Graph panel. The filter menu for Relationships, Inheritance, and Components are highlighted.

Sie können auch die Modelle und Bezüge filtern, die im Diagramm angezeigt werden, nach Text, indem Sie dieses Filtersymbol auswählen:

Screenshot of Azure Digital Twins Explorer Model Graph panel. The text filter icon is selected, showing the Filter tab where you can enter a search term.

Sie können die Modelle und Verweise hervorheben, die im Diagramm angezeigt werden, indem Sie dieses Symbol "Hervorheben " auswählen:

Screenshot of Azure Digital Twins Explorer Model Graph panel. The text filter icon is selected, showing the Highlight tab where you can enter a search term.

Hochladen von Modellimages

Sie können benutzerdefinierte Images hochladen, um verschiedene Modelle in den Ansichten „Model Graph“ (Modellgraph) und Twin Graph (Zwillingsgraph) darzustellen. Sie können Images für einzelne Modelle oder für mehrere Modelle gleichzeitig hochladen.

Hinweis

Diese Images werden im lokalen Browserspeicher gespeichert. Dies bedeutet, dass die Images in anderen Browsern als dem, in dem Sie sie gespeichert haben, nicht verfügbar sind, und dass sie auf unbestimmte Zeit im Browserspeicher verbleiben, bis der lokale Speicher gelöscht wird.

Um ein Image für ein einzelnes Modell hochzuladen, suchen Sie dieses Modell im Bereich Models (Modelle), und wählen Sie die Menüpunkte neben dem Modellnamen aus. Wählen Sie anschließend Upload Model Image (Modellimage hochladen). Navigieren Sie auf Ihrem Computer im angezeigten Dateiauswahlfeld zu der Imagedatei, die Sie für dieses Modell hochladen möchten. Wählen Sie Open (Öffnen) aus, um sie hochzuladen.

Screenshot of Azure Digital Twins Explorer Models panel. The menu dots for a single model are highlighted, and the menu option to Upload Model Image is also highlighted.

Sie können auch einen Massenupload von Modellimages ausführen.

Verwenden Sie zunächst die folgenden Anweisungen, um die Imagedateinamen vor dem Hochladen festzulegen. Dies ermöglicht dem Azure Digital Twins-Explorer, die Images nach dem Hochladen automatisch den richtigen Modellen zuzuweisen.

  1. Beginnen Sie mit dem Wert der Modell-ID (z. B. dtmi:example:Floor;1).
  2. Ersetzen Sie Vorkommen von „:“ durch „_“ (das Beispiel wird zu dtmi_example_Floor;1).
  3. Ersetzen Sie Vorkommen von „;“ durch „-“ (das Beispiel wird zu dtmi_example_Floor-1).
  4. Stellen Sie sicher, dass die Datei über eine Imageerweiterung verfügt (das Beispiel wird ähnlich wie dtmi_example_Floor-1.png).

Hinweis

Wenn Sie versuchen, ein Image hochzuladen, das gemäß den oben genannten Kriterien keinem vorhandenen Modell entspricht, wird das Image weder hochgeladen noch gespeichert.

Um Images gleichzeitig hochzuladen, verwenden Sie das Symbol Modellimages hochladen oben im Bereich „Models“ (Modelle). Wählen Sie im Dateiauswahlfeld aus, welche Imagedateien hochgeladen werden sollen.

Screenshot of Azure Digital Twins Explorer Models panel. The Upload Model Images icon is highlighted.

Verwalten von Modellen

Sie können den Bereich Models (Modelle) auf der linken Seite des Azure Digital Twins-Explorer-Bildschirms verwenden, um Verwaltungsaktivitäten für den gesamten Modellsatz oder für einzelne Modelle durchzuführen.

Screenshot of Azure Digital Twins Explorer. The Models panel is highlighted.

In diesem Bereich können Sie die folgenden Modellverwaltungsaktivitäten durchführen:

Informationen zu den Anzeigeoptionen für Modelle finden Sie unter Untersuchen von Modellen und des Modellgraphen.

Hochladen von Modellen

Sie können Modelle von Ihrem Computer hochladen, indem Sie Modelldateien einzeln auswählen oder aber einen ganzen Ordner mit Modelldateien auf einmal hochladen. Wenn Sie eine einzige JSON-Datei hochladen, die den Code für viele Modelle enthält, überprüfen Sie unbedingt die Einschränkungen beim Massenupload von Modellen.

Hinweis

Derzeit unterstützt Azure Digital Twins Explorer dtDL v2-Modelle vollständig und unterstützt eingeschränkte Funktionen für DTDL v3-Modelle. In Azure Digital Twins Explorer können DTDL v3-Modelle im Bereich "Modelle" angezeigt werden, und Zwillinge, die mit DTDL v3-Modellen erstellt wurden, können angezeigt und bearbeitet werden (einschließlich der Modelle mit Arrayeigenschaften). DTDL v3-Modelle werden jedoch nicht im Bereich "Modelldiagramm" angezeigt, und sie können nicht mit Azure Digital Twins Explorer importiert werden. Um DTDL v3-Modelle in Ihre Instanz zu importieren, verwenden Sie eine andere Entwicklerschnittstelle wie die APIs und SDKs oder die Azure CLI.

Um ein Modell oder mehrere Modelle hochzuladen, die einzeln ausgewählt wurden, wählen Sie das Symbol Modell hochladen aus, das einen Pfeil zeigt, der nach oben weist.

Screenshot of Azure Digital Twins Explorer Models panel. The Upload a model icon is highlighted.

Navigieren Sie auf Ihrem Computer im angezeigten Dateiauswahlfeld zu den Modellen, die Sie hochladen möchten. Sie können eine oder mehrere JSON-Modelldateien auswählen und Öffnen auswählen, um sie hochzuladen.

Um einen Ordner mit Modellen (einschließlich aller darin gespeicherten Inhalte) hochzuladen, wählen Sie das Symbol Modellverzeichnis hochladen aus, das einen Dateiordner zeigt.

Screenshot of Azure Digital Twins Explorer Models panel. The Upload a directory of Models icon is highlighted.

Navigieren Sie im angezeigten Dateiauswahlfeld auf Ihrem Computer zu einem Ordner mit JSON-Modelldateien. Wählen Sie Öffnen aus, um diesen Ordner der obersten Ebene und seinen Gesamten Inhalt hochzuladen.

Wichtig

Wenn ein Modell in seiner Definition auf ein anderes Modell verweist (z. B. beim Definieren von Beziehungen oder Komponenten), muss das Modell, auf das verwiesen wird, in der Instanz vorhanden sein, um das Modell hochzuladen, das es verwendet. Wenn Sie Modelle nacheinander hochladen, bedeutet dies, dass Sie das Modell hochladen sollten, auf das verwiesen wird, bevor Sie Modelle hochladen, die es verwenden. Wenn Sie Modelle in einem Massenvorgang hochladen, können Sie alle in demselben Import auswählen. Azure Digital Twins leitet dann die Reihenfolge ab, in der sie hochgeladen werden sollen. Wenn Sie aber mehr als 50 Modelle in derselben Datei hochladen, lesen Sie die Einschränkungen beim Massenupload von Modellen.

Einschränkungen beim Massenupload von Modellen

Die Einschränkungen in diesem Abschnitt gelten für Modelle, die in einer einzelnen JSON-Datei enthalten sind und in Azure Digital Twins-Explorer gleichzeitig hochgeladen werden.

Es gibt zwar keinen Grenzwert für die Anzahl von Modellen, die Sie in eine einzelne JSON-Datei einbeziehen können, aber es gibt besondere Überlegungen bei Dateien mit mehr als 50 Modellen. Wenn Sie mehr als 50 Modelle in derselben Modelldatei hochladen, folgen Sie diesen Tipps:

  • Wenn es Modelle gibt, die von anderen (in derselben Datei definierten) Modellen erben, platzieren Sie sie am Ende der Liste.
  • Wenn es Modelle mit einem Verweis auf andere (in derselben Datei als „Komponenten“ definierte) Modelle gibt, platzieren Sie sie ebenfalls am Ende der Liste.
  • Überprüfen Sie Folgendes: Überall dort, wo ein Modell auf ein anderes Modell verweist, das in derselben Datei (entweder durch Vererbung oder als Komponente) definiert wurde, wird das Modell mit dem Verweis in der Liste später aufgeführt als die Modelldefinition, auf die verwiesen wird.

Dadurch wird sichergestellt, dass Modellabhängigkeiten während des Uploadvorgangs einwandfrei aufgelöst werden.

Löschen von Modellen

Sie können den Bereich „Models“ (Modelle) verwenden, um einzelne Modelle oder alle Modelle in Ihrer Instanz gleichzeitig zu löschen.

Um ein einzelnes Modell zu löschen, suchen Sie dieses Modell in der Liste, und wählen Sie die Menüpunkte neben dem Modellnamen aus. Wählen Sie anschließend Delete Model (Modell löschen).

Screenshot of Azure Digital Twins Explorer Models panel. The menu dots for a single model are highlighted, and the menu option to Delete Model is also highlighted.

Um alle Modelle in Ihrer Instanz gleichzeitig zu löschen, wählen Sie oben im Bereich „Models“(Modelle) das Symbol „Alle Modelle löschen“ aus.

Screenshot of Azure Digital Twins Explorer Models panel. The Delete All Models icon is highlighted.

Aktualisieren von Modellen

Wenn Sie den Azure Digital Twins-Explorer öffnen, sollten im Bereich „Models“ (Modelle) automatisch alle verfügbaren Modelle in Ihrer Umgebung angezeigt werden.

Sie können den Bereich jedoch jederzeit manuell aktualisieren, um die Liste aller Modelle in Ihrer Azure Digital Twins-Instanz erneut zu laden. Wählen Sie hierzu das Symbol Refresh models (Modelle aktualisieren) aus.

Screenshot of Azure Digital Twins Explorer Models panel. The Refresh models icon is highlighted.

Importieren/Exportieren eines Graphen

Im Bereich Twin Graph (Zwillingsgraph) sind Optionen zum Importieren und Exportieren von Graphfeatures verfügbar.

Importieren eines Graphen

Sie können das Importfeature verwenden, um Ihrer Instanz Zwillinge, Beziehungen und Modelle hinzuzufügen. Dieses Feature kann nützlich sein, um viele Zwillinge, Beziehungen und/oder Modelle gleichzeitig zu erstellen.

Hinweis

Wenn Ihre Graph-Importdatei Modelle enthält, unterliegen sie den Einschränkungen beim Massenupload von Modellen.

Erstellen einer Importdatei

Der erste Schritt beim Importieren eines Graphen ist das Erstellen einer Datei, die die Zwillinge und Beziehungen darstellt, die Sie hinzufügen möchten.

Die Importdatei kann in einem der beiden folgenden Formate vorliegen:

  • Im JSON-basierten Format, das beim Graphexport generiert wird. Dieses Format kann Zwillinge, Beziehungen und/oder Modelle enthalten.
  • Im benutzerdefinierten Excel-basierte Format, das im weiteren Verlauf dieses Abschnitts beschrieben wird. Mit diesem Format können Sie Zwillinge und Beziehungen hochladen.
Erstellen einer Importdatei in Excel

Verwenden Sie das folgende Format zum Erstellen eines benutzerdefinierten Graphen in Excel, der Zwillinge und Beziehungen in Azure Digital Twins-Explorer hochladen kann.

Jede Zeile stellt ein zu erstellendes Element dar: einen Zwilling, eine Beziehung oder eine Kombination aus Zwilling und entsprechender Beziehung. Verwenden Sie die folgenden Spalten, um die Zwillings- oder Beziehungsdaten zu strukturieren. Die Spaltennamen können angepasst werden, sie sollten jedoch in dieser Reihenfolge bleiben.

ModelID ID Beziehung (Quelle) Name der Beziehung Anfängliche Daten
(Optional)
Die DTMI-ID des Modells, das für den neuen Zwilling verwendet werden soll. Diese Modelldefinition sollte bereits in der Instanz vorhanden sein.

Sie können diese Spalte für eine Zeile leer lassen, wenn diese Zeile nur eine Beziehung (keine Zwillinge) erstellen soll.
(Erforderlich)
Die eindeutige ID für einen Zwilling.

Wenn in dieser Zeile ein neuer Zwilling erstellt wird, ist dieser Wert die ID des neuen Zwillings.
Wenn in der Zeile Beziehungsinformationen enthalten sind, wird diese ID als Ziel der Beziehung verwendet.
(Optional)
Die ID eines Zwillings, der der Quellzwilling für eine neue Beziehung sein soll.

Sie können diese Spalte für eine Zeile leer lassen, wenn diese Zeile nur einen Zwilling (keine Beziehungen) erstellen soll.
(Optional)
Der Name für die neue Beziehung, die erstellt werden soll. Die Beziehungsrichtung verläuft vom Zwilling in Spalte C zum Zwilling in Spalte B.
(Optional)
Eine JSON-Zeichenfolge, die Eigenschafteneinstellungen für den zu erstellenden Zwilling enthält. Die Eigenschaften müssen mit den Eigenschaften übereinstimmen, die im Modell in Spalte A definiert sind.

Hier sehen Sie eine XLSX-Beispieldatei, mit der ein kleiner Graph mit zwei Etagen und zwei Räumen erstellt wird.

Screenshot of graph data in Excel. The column headers correspond to the fields above, in order, and the rows contain corresponding data values.

Sie können diese Datei und andere XLSX-Graphbeispiele im Azure Digital Twins-Explorer-Repository auf GitHub anzeigen.

Hinweis

Die in der XLSX-Datei beschriebenen Eigenschaften und Beziehungen müssen mit den in den Modelldefinitionen für die zugehörigen Zwillinge definierten Eigenschaften und Beziehungen übereinstimmen.

Importieren einer Datei in Azure Digital Twins-Explorer

Sobald eine Datei auf Ihrem Computer vorhanden ist, die für den Import bereit ist, wählen Sie im Bereich „Twin Graph“ (Zwillingsgraph) das Symbol Graph importieren aus.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Import Graph button is highlighted.

Navigieren Sie im angezeigten Dateiauswahlfeld auf Ihrem Computer zu der Graphdatei (XLSX- oder JSON-Datei), die Sie hochladen möchten, und wählen Sie Öffnen aus, um sie hochzuladen.

Azure Digital Twins öffnet einen Bereich Import, in dem eine Vorschau des zu importierenden Graphen angezeigt wird. Wählen Sie zur Bestätigung in der oberen rechten Ecke des Bereichs auf das Symbol Speichern.

Wenn der Import erfolgreich ist, wird in einem modalen Fenster die Anzahl der hochgeladenen Modelle, Zwillinge und Beziehungen angezeigt.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The center of the screen displays an Import Successful modal showing four twins imported and two relationships imported.

Exportieren von Graphen und Modellen

Sie können die Exportfunktion verwenden, um teilweise oder vollständige Diagramme zu exportieren, einschließlich Modellen, Zwillingen und Beziehungen. Der Export serialisiert die Zwillinge und Beziehungen aus den letzten Abfrageergebnissen sowie alle Modelle in der Instanz in ein JSON-basiertes Format, das Sie auf Ihren Computer herunterladen können.

Verwenden Sie zunächst den Bereich Abfrage-Explorer, um eine Abfrage auszuführen, die die Zwillinge und Beziehungen auswählt, die Sie herunterladen möchten. Dadurch werden sie im Bereich „Twin Graph“ (Zwillingsgraph) mit Daten aufgefüllt.

Tipp

Die Abfrage zum Anzeigen aller Zwillinge und Beziehungen ist SELECT * FROM digitaltwins.

Sobald im Bereich „Twin Graph“ der Teil des Diagramms angezeigt wird, den Sie herunterladen möchten, wählen Sie das Symbol Graph exportieren aus.

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Export Graph button is highlighted.

Durch diese Aktion wird ein Link Download im Feld „Twin Graph“ aktiviert. Wählen Sie diesen Link aus, um eine JSON-basierte Darstellung des Abfrageergebnisses und aller Modelle in Ihrer Instanz auf Ihren Computer herunterzuladen.

Tipp

Diese Datei kann bearbeitet und/oder über das Importfeature erneut in Azure Digital Twins hochgeladen werden.

Sie können einen Link zu Ihrer Azure Digital Twins-Explorer-Umgebung für andere Benutzer freigeben, um an Aufgaben zusammenzuarbeiten. In diesem Abschnitt wird beschrieben, wie Sie einen Link zu Ihrer Azure Digital Twins-Explorer-Umgebung generieren. Diese kann optional eine bestimmte Abfrage enthalten, die beim Öffnen des Links ausgeführt werden soll. Außerdem wird in diesem Abschnitt beschrieben, welche Berechtigungen der Empfänger für die Interaktion mit Ihren Zwillingsdaten benötigt.

Anforderungen an den Empfängerzugriff

Damit der Empfänger den Link öffnen und die Instanz im Azure Digital Twins-Explorer anzeigen kann, muss er sich bei seinem Azure-Konto anmelden und Azure Digital Twins-Datenleser-Zugriff auf die Instanz haben (weitere Informationen zu Azure Digital Twins-Rollen finden Sie unter Sicherheit).

Damit der Empfänger Änderungen am Graphen und an den Daten vornehmen kann, muss er die Rolle Azure Digital Twins-Datenbesitzer für die Instanz innehaben.

Wenn Sie einen Link zu Ihrer Azure Digital Twins-Explorer-Umgebung, die eine bestimmte Abfrage enthält, generieren möchten, geben Sie die zu erfassende Abfrage im Abfrage-Explorer ein. Wählen Sie dann die Schaltfläche Freigeben aus, um den vollständigen Link zu kopieren.

Screenshot of Azure Digital Twins Explorer Query Explorer panel. The query text and the Send button are highlighted.

Für das Beispiel und die Abfrage im vorstehenden Screenshot erzeugt die Schaltfläche Freigeben diesen Link: https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins%20T%20WHERE%20T.InFlow%20%3E%2070&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>. Der Link enthält die Mandanten-ID und den Hostnamen der Azure Digital Twins-Instanz sowie formatierten Abfragetext.

Sie können diese URL freigeben, damit eine andere Person auf Ihre Instanz und diese Abfrage zugreifen kann. Wenn sie Azure Digital Twins-Explorer über den Link öffnet, werden die Ergebnisse der Abfrage im Bereich Twin Graph (Zwillingsgraph) automatisch aufgefüllt.

Wenn Sie einen Link zu Ihrer Azure Digital Twins-Explorer-Umgebung freigeben möchten, ohne dass eine bestimmte Abfrage angefügt ist, kopieren Sie zuerst den Link zu Ihrer Instanz mithilfe der Schaltfläche Freigeben.

Screenshot of Azure Digital Twins Explorer Query Explorer panel. Only the Send button is highlighted.

Entfernen Sie dann den Abfrageparameter manuell aus dem Ergebnis.

Beispielsweise würde die Schaltfläche Freigeben im vorstehenden Screenshot diesen Link erzeugen: https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>. Sie können den Teil query=SELECT%20*%20FROM%20digitaltwins& entfernen, um die URL https://explorer.digitaltwins.azure.net/?tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name> zu erzeugen.

Geben Sie dann diese URL frei, damit eine andere Person auf Ihre Instanz zugreifen kann. Wenn sie Azure Digital Twins-Explorer über den Link öffnet, wird sie mit Ihrer Instanz verbunden und sieht keine vorab ausgefüllten Abfrageergebnisse.

Barrierefreiheit und erweiterte Einstellungen

Sie können mehrere erweiterte Einstellungen für Azure Digital Twins-Explorer aktivieren, um Ihre Benutzeroberfläche anzupassen oder den Zugriff zu erleichtern.

Über das Symbol Tastaturkurzbefehle in der Symbolleiste oben rechts können Sie eine Liste der Tastaturkurzbefehle anzeigen, mit denen Sie im Azure Digital Twins-Explorer navigieren können.

Screenshot of Azure Digital Twins Explorer. The Keyboard Shortcuts icon is highlighted in the top toolbar.

Unter dem Menüpunkt Einstellungen in der oberen rechten Symbolleiste können Sie auf verschiedene erweiterte Funktionen zugreifen:

  • Eager Loading: Wenn eine Abfrage Zwillinge zurückgibt, die Beziehungen zu anderen Zwillingen aufweisen, die nicht in den Abfrageergebnissen enthalten sind, werden die „fehlenden“ Zwillinge von dieser Funktion vor dem Rendern des Graphen geladen.
  • Zwischenspeichern: Wenn dieses Feature aktiviert ist, verwaltet der Azure Digital Twins-Explorer einen lokalen Cache mit Beziehungen und Modellen im Arbeitsspeicher, um die Abfrageleistung zu verbessern. Diese Caches werden bei Schreibvorgängen für die relevanten Elemente sowie bei der Browseraktualisierung gelöscht. Dieses Feature ist standardmäßig deaktiviert.
  • Konsole: Dieses Feature ermöglicht die Anzeige eines Konsolenfensters, das einfache Shellfunktionen für das Arbeiten mit dem Graphen verwenden kann.
  • Ausgabe: Dieses Feature ermöglicht die Anzeige eines Ausgabefensters, das eine Diagnosenablaufverfolgung von Vorgängen zeigt.
  • Hoher Kontrast: Dieses Feature ändert die Farben des Azure Digital Twins-Explorers, sodass sie mit größerem Kontrast angezeigt werden.

Sie können das Bereichslayout anpassen, indem Sie die Positionen der Bereiche bearbeiten, aus denen der Azure Digital Twins-Explorer besteht (Abfrage-Explorer, Zwillinge, Modelle, Zwillingsgraph, Modellgraph). Um einen Bereich an eine andere Position zu verschieben, klicken Sie auf den Bereichsnamen, halten die Maustaste gedrückt und ziehen ihn an die neue gewünschte Position.

Screenshot of Azure Digital Twins Explorer. The names of the Query Explorer, Models, Twin Graph, and Model Graph panels are highlighted.

Die Bereichspositionen werden bei der Aktualisierung des Browserfensters zurückgesetzt.

Nächste Schritte

Erfahren Sie mehr über das Schreiben von Abfragen für den Azure Digital Twins-Zwillingsgraphen: