Share via

Azure Model Parser-Clientbibliothek für JavaScript– Version 1.0.0-beta.2

  • Artikel

Verwenden Sie diese Bibliothek, um Ihre DTDL-Modelle zu analysieren und zu überprüfen, ob deren Struktur der DTDL-Spezifikation entspricht.

Die Digital Twin Definition Language (DTDL) definiert ein JSON-LD-basiertes Schema zum Erstellen von Digital Twin-Modellen. Während sich die DTDL-Spezifikation weiterentwickelt, wird dieser Parser entsprechend aktualisiert. Ein Hauptmerkmal von Azure Digital Twins ist die Fähigkeit, Ihr eigenes Vokabular zu definieren und Ihren Zwillingsgraph in den selbstdefinierten Begriffen Ihres Unternehmens zu erstellen. Diese Funktion wird mittels von Benutzern bereitgestellten Modellen ermöglicht. Sie können sich Modelle in einer Beschreibung Ihrer Umgebung als die Nomen vorstellen.

Weitere Informationen zu DTDL finden Sie hier.

Erste Schritte

Die derzeitig unterstützten Umgebungen

Ausführlichere Informationen finden Sie in der Supportrichtlinie.

Voraussetzungen

Keine.

Installieren Sie das Paket @azure/dtdl-parser.

Installieren Sie die Digital Twins Model Parser-Clientbibliothek für JavaScript mit npm:

npm install @azure/dtdl-parser

Zugreifen auf das öffentliche DTDL-Modellrepository

Wenn Sie noch kein DTDL-Modell geschrieben haben, können Sie hier auf das vollständige Repository der öffentlich verfügbaren DTDL-Modelle zugreifen: GitHub: Repository von IoT Plug & Play Modellen mit DTDL

Browserunterstützung

JavaScript-Paket

Um diese Clientbibliothek im Browser verwenden zu können, müssen Sie zunächst einen Bundler verwenden. Ausführliche Informationen dazu finden Sie in unserer Bündelungsdokumentation.

Wichtige Begriffe

DTDL-Parser

DTDL (Digital Twins Definition Language) definiert einen Vertrag für die Interaktion mit Modellen von Digital Twin Plug and Plan-Geräten. Der DTDL-Parser ist ein langauge-Parser, der teilweise handschriftliche, teilweise basierend auf einer DTDL-Schemadefinition generiert wird, die überprüfen kann, ob eine Zeichenfolge, die für ihn bereitgestellt wird, dtDL-Langaugedefinitionen entspricht.

Weitere Informationen zur DTDL für Modelle finden Sie unter Informationen zu Zwillingsmodellen und deren Definition in (Azure Digital Twins)(https://docs.microsoft.com/azure/digital-twins/concepts-models).

Beispiele

Analysieren eines DTDL-Modells

Um ein DTDL-Beispielmodell zu analysieren, beginnen Sie entweder mit einem, das Sie bereits geschrieben haben, oder verwenden Sie eines in der öffentlichen DTDL-Datenbank. Im Folgenden wird ein Beispielmodell aus dem Modellrepository abgerufen:

// example.js
async function main() {
  const client = new ModelsRepositoryClient();
  const dtmi = "dtmi:com:example:TemperatureController;1";
  const models = await client.getModels(dtmi);

  const modelParser = createParser(ModelParsingOption.PermitAnyTopLevelElement);
  modelParser.options = ModelParsingOption.PermitAnyTopLevelElement;
  Object.entries(models).forEach(([key, value]) => {
    console.log(`dtmi: ${key}`);
    const modelDict = await modelParser.parse([value]);
    Object.entries(modelDict).forEach(([key2, value2]) => {
      console.log(key2);
    });
  });
}

main().catch((err) => {
  console.error("The sample encountered an error:", err); 
});

Problembehandlung

Protokollierung

HINWEIS: Dieses Paket unterstützt derzeit nicht die Azure-Protokollierung, wird aber von der GA-Version unterstützt.

Die Aktivierung der Protokollierung kann hilfreiche Informationen über Fehler aufdecken. Um ein Protokoll von HTTP-Anforderungen und -Antworten anzuzeigen, legen Sie die Umgebungsvariable AZURE_LOG_LEVEL auf info fest. Alternativ kann die Protokollierung zur Laufzeit aktiviert werden, indem Sie setLogLevel in @azure/logger aufrufen:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Ausführlichere Anweisungen zum Aktivieren von Protokollen finden Sie in der Paketdokumentation zu @azure/logger.

Nächste Schritte

Im Beispielverzeichnis finden Sie ausführliche Beispiele, die die Verwendung der Clientbibliotheken veranschaulichen.

Mitwirken

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie die Anleitung für Mitwirkende, um mehr darüber zu erfahren, wie Sie den Code erstellen und testen können.

Aufrufe