Sdílet prostřednictvím

Klientská knihovna Azure Model Parser pro JavaScript – verze 1.0.0-beta.2

  • Článek

Pomocí této knihovny můžete analyzovat modely DTDL a ověřit, jestli jejich struktura odpovídá specifikaci DTDL.

DTDL (Digital Twin Definition Language) definuje schéma založené na formátu JSON-LD pro vytváření modelů Digital Twin. Jak se specifikace DTDL vyvíjí, bude tento analyzátor odpovídajícím způsobem aktualizován. Klíčovou charakteristikou služby Azure Digital Twins je schopnost definovat vlastní slovní zásobu a vytvořit graf dvojčat v sebedefinovaných pojmech vaší firmy. Tato funkce je poskytována prostřednictvím modelů poskytovaných uživatelem. Modely si můžete představit jako podstatná jména v popisu vašeho světa.

Další informace o DTDL najdete tady.

Začínáme

Aktuálně podporovaná prostředí

  • LtS verze Node.js
  • Nejnovější verze prohlížečů Safari, Chrome, Edge a Firefox.

Další podrobnosti najdete v našich zásadách podpory .

Požadavky

Žádné

Nainstalujte balíček @azure/dtdl-parser.

Nainstalujte klientskou knihovnu analyzátoru modelů Digital Twins pro JavaScript pomocí npm:

npm install @azure/dtdl-parser

Přístup k veřejnému úložišti modelů DTDL

Pokud jste ještě nenapsali model DTDL, můžete získat přístup k úplnému úložišti veřejně dostupných modelů DTDL tady: Github: Úložiště IoT Plug and Play modelů pomocí DTDL

Podpora prohlížečů

JavaScript Bundle

Pokud chcete tuto klientskou knihovnu používat v prohlížeči, musíte nejprve použít bundler. Podrobnosti o tom, jak to udělat, najdete v naší dokumentaci k sdružování.

Klíčové koncepty

Analyzátor DTDL

DTDL (Digital Twins Definition Language) definuje kontrakt pro interakci s modely zařízení Digital Twin Plug and Plan. Analyzátor DTDL je analyzátor jazyka, který je částečně ručně napsaný, částečně vygenerovaný na základě definice schématu DTDL, který může ověřit, jestli zadaný řetězec odpovídá definici jazyka DTDL.

Další informace o DTDL pro modely najdete v článku Další informace o modelech dvojčat a jejich definování v (Azure Digital Twins)(https://docs.microsoft.com/azure/digital-twins/concepts-models)

Příklady

Analýza modelu DTDL

Pokud chcete parsovat ukázkový model DTDL, začněte buď modelem, který jste už napsali, nebo použijte model umístěný ve veřejné databázi DTDL. Vezměme si ukázkový model z úložiště models:

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

Řešení potíží

protokolování

POZNÁMKA: Tento balíček v současné době nepodporuje protokolování Azure, ale bude mít podporu ve verzi GA.

Povolení protokolování může pomoct odhalit užitečné informace o selháních. Pokud chcete zobrazit protokol požadavků a odpovědí HTTP, nastavte proměnnou AZURE_LOG_LEVEL prostředí na info. Případně je možné protokolování povolit za běhu voláním setLogLevel v :@azure/logger

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

setLogLevel("info");

Podrobnější pokyny k povolení protokolů najdete v dokumentaci k balíčkům @azure/protokolovacího nástroje.

Další kroky

Podrobné příklady, které ukazují, jak používat klientské knihovny, najdete v adresáři ukázek .

Přispívání

Pokud chcete přispívat do této knihovny, přečtěte si prosím průvodce přispívání , kde se dozvíte více o tom, jak sestavit a otestovat kód.

Imprese