Freigeben über


Azure Digital Twins (Vorschau)

Azure Digital Twins ist eine IoT-Plattform (Internet of Things), mit der Sie eine digitale Darstellung von realen Dingen, Orten, Geschäftsprozessen und Menschen erstellen können. Mit diesem Connector können Sie Vorgänge für digitale Zwillinge und Modelle ausführen sowie ADT-Abfragen ausführen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Norm Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Microsoft
URL https://azure.microsoft.com/support/
Connectormetadaten
Herausgeber Microsoft Corporation
Webseite https://azure.microsoft.com/products/digital-twins/
Datenschutzrichtlinie https://privacy.microsoft.com
Kategorien Internet der Dinge

Azure Digital Twins ist eine IoT-Plattform (Internet of Things), mit der Sie eine digitale Darstellung von realen Dingen, Orten, Geschäftsprozessen und Menschen erstellen können. Gewinnen Sie Einblicke, die Ihnen helfen, bessere Produkte zu fördern, Vorgänge und Kosten zu optimieren und bahnbrechende Kundenerfahrungen zu schaffen. Diese Connectors ermöglichen die Interaktion mit der digitalen Zwillings-API. Es ermöglicht Es Ihnen, die Zwillinge zu erstellen, zu verwalten und abzufragen.

Voraussetzungen

Sie benötigen Folgendes, um fortzufahren:

  • Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature
  • Ein Azure-Abonnement
  • Die Power Platform CLI-Tools
  • Azure Digital Twins-Instanz

So erhalten Sie Anmeldeinformationen

Verwenden Sie Ihre Microsoft Entra ID-Benutzer-ID und Ihr Kennwort, das über die Berechtigung zum Zugriff auf die Endpunkte digitaler Zwillinge verfügt.

Erste Schritte mit Ihrem Connector

Bekannte Probleme und Einschränkungen

  • Da sich das ADT mit dynamischen Schemaantworten befasst. Der App-Entwickler sollte den JSON-Code vor dem Verbrauch analysieren. eg: Set(jsonVal, AzureDigitalTwins.GetTwinById(TextInput1.Text).result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.' $dtId');

Häufige Fehler und Abhilfemaßnahmen

  • Json-Parserfehler:
    • Incase the model doesn't match with the parsed json, you will receive a json parser error. Um dies zu lösen, überprüfen Sie bitte die Antwort-XML, und greifen Sie entsprechend auf die Werte zu.

Häufig gestellte Fragen

  • Können wir eine ADT-Instanz über den Connector erstellen?

    • Sie sollten zu Azure wechseln, um die ADT-Instanz zu erstellen und zu löschen.
  • Ist die Auslagerung verfügbar?

    • Die Seitenerstellung erfolgt innerhalb der App-Entwicklung mithilfe des Fortsetzungstokens.
  • Können wir auf mehrere ADT-Instanzen in einer App zugreifen?

    • Um auf die mehrere ADT-Instanzen zuzugreifen, muss eine neue Verbindung eingerichtet und in der Anwendung entsprechend verwendet werden.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
ADT-Instanzname: Schnur Geben Sie Ihren ADT-Instanz-URI ein. Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 300 60 Sekunden

Aktionen

Abfrage-API

Führt eine Abfrage aus, mit der Beziehungen durchlaufen und nach Eigenschaftswerten gefiltert werden können.

Aktualisieren des Zwillings

Aktualisiert Die Eigenschaften eines Zwillings.

Beziehung aktualisieren

Aktualisiert ganzzahlige Eigenschaften für eine Beziehung zwischen zwei digitalen Zwillingen.

Beziehung hinzufügen

Fügt eine Beziehung zwischen zwei digitalen Zwillingen hinzu.

Beziehung löschen

Löscht eine Beziehung zwischen zwei digitalen Zwillingen.

Beziehung nach ID abrufen

Ruft eine Beziehung zwischen zwei digitalen Zwillingen ab.

Beziehungen auflisten

Ruft alle ausgehenden Beziehungen von einem digitalen Zwilling ab.

Eigenschaft des Updatemodells

Aktualisiert die Metadaten für ein Modell.

Eingehende Beziehungen auflisten

Ruft alle eingehenden Beziehungen für einen digitalen Zwilling ab.

Komponente abrufen

Ruft eine Komponente von einem digitalen Zwilling ab.

Komponente aktualisieren

Aktualisiert ganzzahlige Eigenschaften für eine Komponente eines Zwillings.

Modell hinzufügen

Lädt mindestens ein Modell hoch. Wenn ein Fehler auftritt, werden keine Modelle hochgeladen.

Modell löschen

Löscht ein Modell. Ein Modell kann nur gelöscht werden, wenn keine anderen Modelle darauf verweisen.

Modell nach ID abrufen

Ruft Modellmetadaten und optional die Modelldefinition ab.

Modelle auflisten

Ruft Modellmetadaten und optional Modelldefinitionen ab.

Senden von Komponententelemetrie

Sendet Telemetrie im Auftrag einer Komponente in einem digitalen Zwilling.

Telemetrie senden

Sendet Telemetrie im Auftrag eines digitalen Zwillings.

Twin by Id abrufen

Ruft einen digitalen Zwilling und seine Daten ab.

Twin hinzufügen

Fügt einen digitalen Zwilling hinzu oder ersetzt sie.

Twin löschen

Löscht einen digitalen Zwilling. Alle Beziehungen, die auf den digitalen Zwilling verweisen, müssen bereits gelöscht werden.

Abfrage-API

Führt eine Abfrage aus, mit der Beziehungen durchlaufen und nach Eigenschaftswerten gefiltert werden können.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage
query string

Fragen Sie die Twins ab.

continuationToken
continuationToken string

Link zum Abrufen des nächsten Satzes von Elementen.

Gibt zurück

Aktualisieren des Zwillings

Aktualisiert Die Eigenschaften eines Zwillings.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Anfrage
value string

Anforderung für die API.

Beziehung aktualisieren

Aktualisiert ganzzahlige Eigenschaften für eine Beziehung zwischen zwei digitalen Zwillingen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Beziehungs-ID
relationshipId True string

Die ID der Beziehung. Die ID ist innerhalb des digitalen Zwillings eindeutig und beachtet die Groß-/Kleinschreibung.

Anfrage
value string

Anforderung für die API.

Beziehung hinzufügen

Fügt eine Beziehung zwischen zwei digitalen Zwillingen hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Beziehungs-ID
relationshipId True string

Die ID der Beziehung. Die ID ist innerhalb des digitalen Zwillings eindeutig und beachtet die Groß-/Kleinschreibung.

Anfrage
value string

Anforderung für die API.

Gibt zurück

Beziehung löschen

Löscht eine Beziehung zwischen zwei digitalen Zwillingen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Beziehungs-ID
relationshipId True string

Die ID der Beziehung. Die ID ist innerhalb des digitalen Zwillings eindeutig und beachtet die Groß-/Kleinschreibung.

Beziehung nach ID abrufen

Ruft eine Beziehung zwischen zwei digitalen Zwillingen ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Beziehungs-ID
relationshipId True string

Die ID der Beziehung. Die ID ist innerhalb des digitalen Zwillings eindeutig und beachtet die Groß-/Kleinschreibung.

Gibt zurück

Beziehungen auflisten

Ruft alle ausgehenden Beziehungen von einem digitalen Zwilling ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Fortsetzungstoken
continuationToken string

Ein Token, das verwendet wird, um den nächsten Satz von Ergebnissen aus einer vorherigen Abfrage abzurufen.

Gibt zurück

Name Pfad Typ Beschreibung
value
value array of TwinRelationship

Die Sammlung von Zwillingsbeziehungen.

continuationToken
continuationToken string

Fortsetzungstoken die nächste Seite von Twin Relationship.

nextLink
nextLink string

URL zum Abrufen der nächsten Seite von Twin Relationship.

Eigenschaft des Updatemodells

Aktualisiert die Metadaten für ein Modell.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Modell-ID
modelid True string

Die ID des Modells. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Anfrage
value string

Anforderung für die API.

Eingehende Beziehungen auflisten

Ruft alle eingehenden Beziehungen für einen digitalen Zwilling ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Fortsetzungstoken
continuationToken string

Ein Token, das verwendet wird, um den nächsten Satz von Ergebnissen aus einer vorherigen Abfrage abzurufen.

Gibt zurück

Name Pfad Typ Beschreibung
value
value array of IncomingRelationship

Die Sammlung eingehender Beziehungen.

continuationToken
continuationToken string

Fortsetzungstoken die nächste Seite von Twin Relationship.

nextLink
nextLink string

URL zum Abrufen der nächsten Seite der eingehenden Beziehung.

Komponente abrufen

Ruft eine Komponente von einem digitalen Zwilling ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

DTDL-Komponente
componentPath True string

Der Name der DTDL-Komponente.

Gibt zurück

Komponente aktualisieren

Aktualisiert ganzzahlige Eigenschaften für eine Komponente eines Zwillings.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

DTDL-Komponente
componentPath True string

Der Name der DTDL-Komponente.

Anfrage
value string

Anforderung für die API.

Modell hinzufügen

Lädt mindestens ein Modell hoch. Wenn ein Fehler auftritt, werden keine Modelle hochgeladen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
@id
@id string

Die ID des Modells, wie in der Modelldefinition angegeben.

@type
@type string

Schnittstellentyp.

Anzeigename
displayName string

Eine Sprachzuordnung, die die lokalisierten Anzeigenamen enthält, wie in der Modelldefinition angegeben.

@type
@type string

Eigenschaftstyp.

name
name string

Name der Eigenschaft.

Anzeigename
displayName string

Name der Eigenschaft.

schema
schema string

Schema der Prothese.

@context
@context string

Metadatenkontext.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
id
id string

Die ID des Modells, wie in der Modelldefinition angegeben.

additionalProperties
displayName.additionalProperties string

Eigenschaftswerte.

uploadTime
uploadTime string

Die Zeit, zu der das Modell in den Dienst hochgeladen wurde.

Stillgelegt
decommissioned boolean

Gibt an, ob das Modell außer Betrieb genommen wird. Außerbetrieb genommene Modelle können nicht von neu erstellten digitalen Zwillingen referenziert werden.

Modell löschen

Löscht ein Modell. Ein Modell kann nur gelöscht werden, wenn keine anderen Modelle darauf verweisen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Modell-ID
modelid True string

Die ID des Modells. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Modell nach ID abrufen

Ruft Modellmetadaten und optional die Modelldefinition ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Modell-ID
modelid True string

Die ID des Modells. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Modelldefinition einschließen
includeModelDefinition string

Wenn true, wird die Modelldefinition als Teil des Ergebnisses zurückgegeben.

Gibt zurück

Name Pfad Typ Beschreibung
id
id string

Die ID des Modells, wie in der Modelldefinition angegeben.

uploadTime
uploadTime string

Die Zeit, zu der das Modell in den Dienst hochgeladen wurde.

Stillgelegt
decommissioned boolean

Gibt an, ob das Modell außer Betrieb genommen wird. Außerbetrieb genommene Modelle können nicht von neu erstellten digitalen Zwillingen referenziert werden.

@id
model.@id string

Die ID des Modells, wie in der Modelldefinition angegeben.

@type
model.@type string

Schnittstellentyp.

contents
model.contents array of object

Antwortinhalte.

@type
model.contents.@type string

Eigenschaftstyp.

name
model.contents.name string

Name der Eigenschaft.

Anzeigename
model.contents.displayName string

Property displayName.

schema
model.contents.schema string

Schema der Eigenschaft.

@context
model.@context string

Metadatenkontext.

Modelle auflisten

Ruft Modellmetadaten und optional Modelldefinitionen ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Abhängigkeiten für das Modell
dependenciesFor string

Die Gruppe der Modelle, die ihre Abhängigkeiten abrufen. Wenn nicht angegeben, werden alle Modelle abgerufen.

Modelldefinition einschließen
includeModelDefinition string

Wenn true, wird die Modelldefinition als Teil des Ergebnisses zurückgegeben.

Fortsetzungstoken
continuationToken string

Ein Token, das verwendet wird, um den nächsten Satz von Ergebnissen aus einer vorherigen Abfrage abzurufen.

Gibt zurück

Name Pfad Typ Beschreibung
value
value array of object

Arraywerte.

id
value.id string

Die ID des Modells, wie in der Modelldefinition angegeben.

uploadTime
value.uploadTime string

Die Zeit, zu der das Modell in den Dienst hochgeladen wurde.

Stillgelegt
value.decommissioned boolean

Gibt an, ob das Modell außer Betrieb genommen wird. Außerbetrieb genommene Modelle können nicht von neu erstellten digitalen Zwillingen referenziert werden.

@id
value.model.@id string

Die ID des Modells, wie in der Modelldefinition angegeben.

@type
value.model.@type string

Schnittstellentyp.

contents
value.model.contents array of object

Antwortinhalte.

@type
value.model.contents.@type string

Eigenschaftstyp.

name
value.model.contents.name string

Name der Eigenschaft.

Anzeigename
value.model.contents.displayName string

Property displayName.

schema
value.model.contents.schema string

Schema der Eigenschaft.

@context
value.model.@context string

Metadatenkontext.

Anzeigename
value.model.displayName string

Modellanzeigename.

additionalProperties
value.displayName.additionalProperties string

Eigenschaftswerte.

continuationToken
continuationToken string

Fortsetzungstoken die nächste Seite von Twin Relationship.

nextLink
nextLink string

URL zum Abrufen der nächsten Seite von Modellen.

Senden von Komponententelemetrie

Sendet Telemetrie im Auftrag einer Komponente in einem digitalen Zwilling.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

DTDL-Komponente
componentPath True string

Der Name der DTDL-Komponente.

Nachrichten-ID
Message-Id True string

Ein eindeutiger Nachrichtenbezeichner (im Bereich der digitalen Zwillings-ID), der häufig für die Deduplizierung von Nachrichten verwendet wird.

Zeitstempel
Telemetry-Source-Time string

Ein RFC 3339-Zeitstempel, der die Uhrzeit angibt, zu der die Telemetrie gemessen wurde.

Komponenten-Telemetrieanforderung
value string

Senden von Telemetrieeingaben für Komponenten.

Telemetrie senden

Sendet Telemetrie im Auftrag eines digitalen Zwillings.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Nachrichten-ID
Message-Id True string

Ein eindeutiger Nachrichtenbezeichner (im Bereich der digitalen Zwillings-ID), der häufig für die Deduplizierung von Nachrichten verwendet wird.

Zeitstempel
Telemetry-Source-Time string

Ein RFC 3339-Zeitstempel, der die Uhrzeit angibt, zu der die Telemetrie gemessen wurde.

Telemetrieanforderung
value string

Telemetrieeingaben senden.

Twin by Id abrufen

Ruft einen digitalen Zwilling und seine Daten ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Gibt zurück

Body
TwinResult

Twin hinzufügen

Fügt einen digitalen Zwilling hinzu oder ersetzt sie.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Anfrage
value string

Anforderung für die API.

Gibt zurück

Body
TwinResult

Twin löschen

Löscht einen digitalen Zwilling. Alle Beziehungen, die auf den digitalen Zwilling verweisen, müssen bereits gelöscht werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Digitale Zwillings-ID
twinid True string

Die ID des digitalen Zwillings. Die ID ist innerhalb des Diensts eindeutig und die Groß-/Kleinschreibung wird beachtet.

Definitionen

IncomingRelationship

Name Pfad Typ Beschreibung
$sourceId
$sourceId string

Quell-ID.

$relationshipId
$relationshipId string

Beziehungs-ID.

$relationshipName
$relationshipName string

Beziehungsname.

$relationshipLink
$relationshipLink string

Beziehungslink.

TwinRelationship

Name Pfad Typ Beschreibung
$sourceId
$sourceId string

Quell-ID.

$relationshipId
$relationshipId string

Beziehungs-ID.

$targetId
$targetId string

Ziel-ID.

$relationshipName
$relationshipName string

Beziehungsname.

$etag
$etag string

E-Tag-Link.

additionalProperties
additionalProperties string

Eigenschaftswerte.

TwinResult

Name Pfad Typ Beschreibung
Ergebnis
result string

Ergebnisse des Zwillings.

GetComponentResult

Name Pfad Typ Beschreibung
Ergebnis
result string

Ergebnisse des Zwillings.

QueryResult

Name Pfad Typ Beschreibung
Wert
value string

Ergebnisse des Zwillings.

Fortsetzungstoken
continuationToken string

Link zum Abrufen des nächsten Satzes von Elementen.