Azure Model Parser-clientbibliotheek voor JavaScript - versie 1.0.0-beta.2
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
- LTS-versies van Node.js
- Nieuwste versies van Safari, Chrome, Edge en Firefox.
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.
Verwante projecten
Azure SDK for JavaScript