Szenario: Mit digitalen Zwillingen von IoT arbeiten
Um Ihre digitalen Zwillinge einzurichten, können Sie mit den digitalen Zwillingsinstanzen, Adaptern, Beziehungen und Modellen arbeiten.
Verwenden Sie diese Konzepte, um mit digitalen Zwillingsressourcen zu arbeiten.
Wenn Sie unstrukturierte Daten erhalten, müssen Sie eine Instanz für digitale Zwillinge erstellen. Ein digitales Zwillingsmodell und Adapter sind nicht erforderlich. Informationen hierzu finden Sie unter Szenario: Unstrukturierte Daten mit HTTPs senden.
Wenn Sie strukturierte Daten erhalten, müssen Sie eine digitale Zwillingsinstanz, ein Modell und einen Adapter erstellen.
- Digitale Zwillingsmodelle: Ein digitales Zwillingsmodell definiert die Semantik eines digitalen Zwillings und basiert auf den DTDL v3-Spezifikationen. Ein digitaler Zwilling verwendet einen Digital Twin Model Identifier (DTMI) als eindeutige ID.
Beispiel:
dtmi:com:yourcompany:iot:example;1 - Digitale Twin-Adapter: Übersetzen Sie Daten in digitale Zwillingsmodelle für Daten-Snapshots und erfasst, sofern konfiguriert, historisierte Daten. Die an den digitalen Zwillingsadapter übergebenen Daten sind ein JSON-Objekt, das die Daten und das Mapping enthält. Für strukturierte Daten sind digitale Zwillingsadapter erforderlich.
- Standardadapterformat: Wenn das Gerät so programmiert werden kann, dass Daten in dem Format gesendet werden, mit dem Sie arbeiten möchten, erstellen Sie einen Standardadapter für digitale Zwillinge. Ein bestimmtes Beispiel finden Sie unter Szenario: Gesendete strukturierte Daten in einem Standardformat mit HTTPs.
- Benutzerdefiniertes Adapterformat: Wenn das Gerät nicht so programmiert werden kann, dass Daten in dem Format gesendet werden, mit dem Sie arbeiten möchten, erstellen Sie einen benutzerdefinierten digitalen Zwillingsadapter. Ein bestimmtes Beispiel finden Sie unter Szenario: Senden strukturierter Daten in einem benutzerdefinierten Format mit HTTPs.
- Digitale Zwillingsbeziehungen: Verbindet mehrere digitale Zwillingsinstanzen. Wenn eine digitale Zwillingsbeziehung mit einer digitalen Zwillingsinstanz verknüpft ist, können Sie ein Diagramm des digitalen Zwillings und seiner Beziehungen zu anderen digitalen Zwillingsinstanzen erstellen. Ein bestimmtes Beispiel finden Sie unter Szenario: Digitale Zwillingsbeziehung abfragen.
Hinweis
Abhängig von der Schnittstelle, die Sie Payloads, Adapterzuordnungen, digitale Zwillingsmodelle, Attribute und Eigenschaften in Ihren Dateien verwenden, verwenden Sie eine andere Groß-/Kleinschreibung. Beispiel: Die API-Schnittstelle verwendet
Abhängig von der Schnittstelle, die Sie Payloads, Adapterzuordnungen, digitale Zwillingsmodelle, Attribute und Eigenschaften in Ihren Dateien verwenden, verwenden Sie eine andere Groß-/Kleinschreibung. Beispiel: Die API-Schnittstelle verwendet
camelCase, und die CLI-Schnittstelle verwendet das Format hyphenated-lowercase. Die CLI kann entweder das Format camelCase oder hyphenated-lowercase für das digitale Zwillingsmodell und die Adapterdateien für digitale Zwillinge akzeptieren und hyphenated-lowercase für Befehle und Parameter verwenden. Beispiel: - API:
digitalTwinInstanceId - CLI:
digital-twin-instance-id
Digitale Zwillingskonzepte
Wenn Sie mit Ihren digitalen Zwillingsressourcen arbeiten, verwenden Sie diese Schlüsselkonzepte:
- Referenz-JSON-Dateien für Spezifikationen und Adapter für digitale Zwillingsmodelle: Je nach Betriebssystem können Sie eine etwas andere Syntax mit Anführungszeichen, Schrägstrichen oder Speicherort der Datei standardmäßig verwenden. Wenn Sie einen Adapter mit der CLI hochladen, können Sie mit JSON-Dateien das Datenmapping angeben. Siehe CLI-Eingabe und -Ausgabe verwalten und JSON-Datei für komplexe Eingaben verwenden.
- Beispieldaten: Um Ihre Konfiguration einzurichten und zu testen, wird sie automatisch generiert, wenn Sie eine Instanz mit digitalem Zwilling erstellen, wenn Sie keinen externen Schlüssel hinzufügen. Verwenden Sie diesen externen Schlüssel als Gerätenutzernamen, um Daten zu posten.
- Modell- und Adapteroptionen für digitale Zwillinge: Erstellen Sie ein Modell für digitale Zwillinge, um es mit den Spezifikationen von DTDL v3 zu definieren, und erstellen Sie einen Adapter für digitale Zwillinge, um die Gerätedaten an das digitale Zwillingsmodell anzupassen.
- Externer Schlüssel und Authentifizierung: Um Ihre IoT-Konfiguration zu testen, verwenden Sie ein Vault Secret mit Basisauthentifizierung, um Beispieldaten aufzunehmen. Wenn Sie Daten über die Instanzen des digitalen Zwillings senden, geben Sie den Benutzernamen für das Gerät als
--external-keyund--auth-idals Gerätekennwort an. Die--auth-idkann ein Vault Secret oder ein mTLS-Zertifikat sein. Beim Erstellen der Instanz des digitalen Zwillings oder beim Aktualisieren der Instanz des digitalen Zwillings kann entweder das Secret oder die OCID des Zertifikats mit der Instanz des digitalen Zwillings verknüpft werden. - Externer Schlüssel und mTLS-Zertifikat: Wenn Sie ein mTLS-Zertifikat anstelle des Vault Secrets verwenden, muss der externe Schlüssel der allgemeine Name des Zertifikats sein. Um den allgemeinen Namen des Zertifikats zu ermitteln, können Sie Ihre Zertifikate auflisten und zu den Zertifikatsdetails gehen.
- Beziehungen: Digitale Zwillingsbeziehungen verknüpfen Instanzen in der Regel eine Quelle und ein Ziel sowie einen Inhaltspfad, der durch die Beziehungen Ihres digitalen Zwillingsmodells definiert ist. Beispiel:
servedBy.