Azure Model Parser ügyfélkódtár JavaScripthez – 1.0.0-beta.2-es verzió

Ezzel a kódtárkal elemezheti a DTDL-modelleket, és ellenőrizheti, hogy azok struktúrája megfelel-e a DTDL specifikációjának.

A Digital Twin Definition Language (DTDL) egy JSON-LD-alapú sémát határoz meg a Digital Twin-modellek létrehozásához. A DTDL specifikációjának fejlődésével az elemző ennek megfelelően frissül. Az Azure Digital Twins egyik fő jellemzője, hogy saját szókincsét definiálhatja, és az ikergráfot a vállalkozása saját feltételei szerint hozhatja létre. Ezt a képességet a felhasználó által biztosított modellek biztosítják. A modelleket főnevekként tekintheti a világ leírásában.

További információ a DTDL-ről itt.

Első lépések

Jelenleg támogatott környezetek

• A Node.jsLTS-verziói
• A Safari, a Chrome, az Edge és a Firefox legújabb verziói.

További részletekért tekintse meg támogatási szabályzatunkat .

Előfeltételek

Nincsenek.

Telepítse a(z) @azure/dtdl-parser csomagot

Telepítse a Digital Twins Model Parser ügyfélkódtárat JavaScripthez a következővel npm:

npm install @azure/dtdl-parser

Hozzáférés a nyilvános DTDL-modelladattárhoz

Ha még nem írt DTDL-modellt, itt érheti el a nyilvánosan elérhető DTDL-modellek teljes tárházát: Github: Az IoT-Plug and Play modellek adattára a DTDL használatával

Böngészőtámogatás

JavaScript-csomag

Ahhoz, hogy ezt az ügyfélkódtárat a böngészőben használhassa, először egy kötegelőt kell használnia. Ennek részleteiért tekintse meg a csomagküldő dokumentációt.

Fő fogalmak

DTDL-elemző

A DTDL (Digital Twins Definition Language) egy szerződést határoz meg a Digital Twin Plug és Plan eszközök modelljeinek használatához. A DTDL-elemző egy részben kézzel írt langauge elemző, amely részben egy DTDL-sémadefiníció alapján jön létre, amely képes ellenőrizni, hogy a megadott sztring megfelel-e a DTDL langauge definícióinak.

A modellekhez készült DTDL-vel kapcsolatos további információkért olvassa el a "További információ az ikermodellekről és azok definiálásáról az (Azure Digital Twins) szolgáltatásban() című témakört.https://docs.microsoft.com/azure/digital-twins/concepts-models)

Példák

DTDL-modell elemzése

A DTDL-mintamodell elemzéséhez kezdje egy már megírt vagy a nyilvános DTDL-adatbázisban található modellel. Vegyünk egy mintamodellt a modellek adattárából:

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

Hibaelhárítás

Naplózás

MEGJEGYZÉS: Ez a csomag jelenleg nem támogatja az Azure-naplózást, de a ga kiadás támogatja.

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a környezeti változót a AZURE_LOG_LEVEL értékre info. A naplózás futásidőben is engedélyezhető a következő hívással setLogLevel@azure/logger:

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

setLogLevel("info");

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációt.

Következő lépések

Az ügyfélkódtárak használatát bemutató részletes példákért tekintse meg a mintakönyvtárat .

Közreműködés

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

Kapcsolódó projektek

• Javascripthez készült Microsoft Azure SDK