Udostępnij za pośrednictwem

Biblioteka klienta analizatora modelu platformy Azure dla języka JavaScript — wersja 1.0.0-beta.2

  • Artykuł

Użyj tej biblioteki, aby przeanalizować modele DTDL i zweryfikować ich strukturę zgodną ze specyfikacją DTDL.

Język DTDL (Digital Twin Definition Language) definiuje schemat oparty na formacie JSON-LD do tworzenia modeli usługi Digital Twin. W miarę rozwoju specyfikacji DTDL ten analizator zostanie odpowiednio zaktualizowany. Kluczową cechą usługi Azure Digital Twins jest możliwość definiowania własnego słownictwa i tworzenia grafu bliźniaczej reprezentacji w zdefiniowanych przez siebie terminach firmy. Ta funkcja jest udostępniana za pośrednictwem modeli udostępnianych przez użytkownika. Modele można traktować jako owniki w opisie świata.

Dowiedz się więcej na temat języka DTDL tutaj.

Wprowadzenie

Obecnie obsługiwane środowiska

Aby uzyskać więcej informacji, zobacz nasze zasady pomocy technicznej .

Wymagania wstępne

Brak.

Instalowanie pakietu @azure/dtdl-parser

Zainstaluj bibliotekę klienta analizatora modeli usługi Digital Twins dla języka JavaScript przy użyciu polecenia npm:

npm install @azure/dtdl-parser

Uzyskiwanie dostępu do publicznego repozytorium modelu DTDL

Jeśli nie utworzono jeszcze modelu DTDL, możesz uzyskać dostęp do pełnego repozytorium publicznie dostępnych modeli DTDL tutaj: Github: Repozytorium modeli IoT Plug and Play przy użyciu języka DTDL

Obsługa przeglądarki

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw musisz użyć pakietu. Aby uzyskać szczegółowe informacje na temat tego, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów.

Kluczowe pojęcia

Analizator DTDL

DtDL (Digital Twins Definition Language) definiuje kontrakt na interakcję z modelami urządzeń Digital Twin Plug and Plan. Analizator DTDL to langauge parser, który jest częściowo napisany ręcznie, częściowo wygenerowany na podstawie definicji schematu DTDL, który może sprawdzić, czy podany ciąg jest zgodny z definicjami langauge DTDL.

Aby dowiedzieć się więcej na temat języka DTDL dla modeli, przeczytaj "Dowiedz się więcej o modelach bliźniaczych i sposobach ich definiowania w usłudze (Azure Digital Twins](https://docs.microsoft.com/azure/digital-twins/concepts-models)

Przykłady

Analizowanie modelu DTDL

Aby przeanalizować przykładowy model DTDL, zacznij od tego, który został już napisany lub użyj go znajdującego się w publicznej bazie danych DTDL. Pobierzmy przykładowy model z repozytorium modeli:

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

Rozwiązywanie problemów

Rejestrowanie

UWAGA: Ten pakiet obecnie nie obsługuje rejestrowania platformy Azure, ale będzie obsługiwał wydanie ogólnie dostępne.

Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań HTTP i odpowiedzi, ustaw zmienną AZURE_LOG_LEVEL środowiskową na info. Możesz też włączyć rejestrowanie w czasie wykonywania, wywołując polecenie w elemecie setLogLevel@azure/logger:

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

setLogLevel("info");

Aby uzyskać bardziej szczegółowe instrukcje dotyczące włączania dzienników, zapoznaj się z dokumentami dotyczącymi pakietu @azure/rejestratora.

Następne kroki

Zapoznaj się z katalogiem samples , aby zapoznać się ze szczegółowymi przykładami, które pokazują, jak używać bibliotek klienta.

Współtworzenie

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik współtworzenia , aby dowiedzieć się więcej na temat sposobu kompilowania i testowania kodu.

Wrażenia