Delen via

Azure Model Parser-clientbibliotheek voor JavaScript - versie 1.0.0-beta.2

  • Artikel

Gebruik deze bibliotheek om uw DTDL-modellen te parseren en te controleren of hun structuur voldoet aan de DTDL-specificatie.

De Digital Twin Definition Language (DTDL) definieert een op JSON-LD gebaseerd schema voor het maken van Digital Twin-modellen. Naarmate de DTDL-specificatie zich ontwikkelt, wordt deze parser dienovereenkomstig bijgewerkt. Een belangrijk kenmerk van Azure Digital Twins is de mogelijkheid om uw eigen woordenlijst te definiëren en uw dubbelgrafiek te bouwen in de zelf gedefinieerde termen van uw bedrijf. Deze mogelijkheid wordt geboden via door de gebruiker geleverde modellen. U kunt modellen beschouwen als zelfstandige naamwoorden in een beschrijving van uw wereld.

Meer informatie over DTDL vindt u hier.

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Vereisten

Geen.

Installeer het pakket @azure/dtdl-parser

Installeer de Digital Twins Model Parser-clientbibliotheek voor JavaScript met npm:

npm install @azure/dtdl-parser

Toegang tot de openbare DTDL-modelopslagplaats

Als u nog geen DTDL-model hebt geschreven, hebt u hier toegang tot de volledige opslagplaats met openbaar beschikbare DTDL-modellen: Github: Opslagplaats van IoT Plug en Play-modellen met DTDL

Browserondersteuning

JavaScript-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Raadpleeg onze documentatie voor bundeling voor meer informatie over hoe u dit doet.

Belangrijkste concepten

DTDL-parser

DTDL (Digital Twins Definition Language) definieert een contract voor interactie met modellen van Digital Twin Plug en Plan-apparaten. De DTDL-parser is een langauge-parser die gedeeltelijk met de hand is geschreven en gedeeltelijk is gegenereerd op basis van een DTDL-schemadefinitie, waarmee kan worden gecontroleerd of een tekenreeks die eraan is verstrekt, voldoet aan DTDL-langauge-definities.

Meer informatie over DTDL voor modellen vindt u in 'Meer informatie over dubbelmodellen en hoe u deze definieert in (Azure Digital Twins](https://docs.microsoft.com/azure/digital-twins/concepts-models)

Voorbeelden

Een DTDL-model parseren

Als u een DTDL-voorbeeldmodel wilt parseren, begint u met een model dat u al hebt geschreven of gebruikt u een model dat zich in de openbare DTDL-database bevindt. Laten we een voorbeeldmodel ophalen uit de opslagplaats voor modellen:

// 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); 
});

Problemen oplossen

Logboekregistratie

OPMERKING: dit pakket biedt momenteel geen ondersteuning voor Azure-logboekregistratie, maar biedt ondersteuning voor de GA-release.

Het inschakelen van logboekregistratie kan helpen bij het ontdekken van nuttige informatie over fouten. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de AZURE_LOG_LEVEL omgevingsvariabele in op info. Logboekregistratie kan ook worden ingeschakeld tijdens runtime door aan te roepen setLogLevel in de @azure/logger:

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

setLogLevel("info");

Voor meer gedetailleerde instructies over het inschakelen van logboeken kunt u de @azure-/loggerpakketdocumenten bekijken.

Volgende stappen

Bekijk de map met voorbeelden voor gedetailleerde voorbeelden die laten zien hoe u de clientbibliotheken gebruikt.

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de handleiding voor bijdragen voor meer informatie over het bouwen en testen van de code.

Weergaven