Partilhar via

Biblioteca de cliente do Azure Model Parser para JavaScript – versão 1.0.0-beta.2

  • Artigo

Utilize esta biblioteca para analisar os seus modelos DTDL e validar que a estrutura está em conformidade com a especificação DTDL.

A Linguagem DTDL (Digital Twin Definition Language) define um esquema baseado em JSON-LD para criar modelos de Duplo Digital. À medida que a especificação DTDL evolui, este analisador será atualizado em conformidade. Uma das principais características do Azure Digital Twins é a capacidade de definir o seu próprio vocabulário e criar o seu grafo duplo nos termos autodefinidos da sua empresa. Esta capacidade é fornecida através de modelos fornecidos pelo utilizador. Pode considerar os modelos como os substantivos numa descrição do seu mundo.

Saiba mais sobre o DTDL aqui.

Introdução

Ambientes atualmente suportados

Veja a nossa política de suporte para obter mais detalhes.

Pré-requisitos

Nenhum.

Instalar o pacote @azure/dtdl-parser

Instale a biblioteca de cliente Do Digital Twins Model Parser para JavaScript com npm:

npm install @azure/dtdl-parser

Aceder ao Repositório do Modelo DTDL Público

Se ainda não tiver escrito um modelo DTDL, pode aceder ao repositório completo de modelos DTDL disponíveis publicamente aqui: Github: Repositório de modelos de Plug and Play IoT com DTDL

Browser support (Suporte do browser)

Pacote JavaScript

Para utilizar esta biblioteca de cliente no browser, primeiro tem de utilizar um bundler. Para obter detalhes sobre como fazê-lo, veja a nossa documentação de agrupamento.

Conceitos-chave

Analisador de DTDL

O DTDL (Digital Twins Definition Language) define um contrato para interagir com modelos de dispositivos Plug and Plan do Digital Twin. O Analisador DTDL é um analisador langauge parcialmente escrito à mão, parcialmente gerado com base numa definição de esquema DTDL, que pode validar se uma cadeia fornecida está em conformidade com as definições de langauge DTDL.

Pode saber mais sobre o DTDL para modelos ao ler "Saiba mais sobre modelos duplos e como defini-los no (Azure Digital Twins](https://docs.microsoft.com/azure/digital-twins/concepts-models)

Exemplos

Analisar um Modelo DTDL

Para analisar um modelo DTDL de exemplo, comece com um que já tenha escrito ou utilize um localizado na base de dados DTDL pública. Vamos obter um modelo de exemplo do repositório de modelos:

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

Resolução de problemas

Registo

NOTA: atualmente, este pacote não suporta o Registo do Azure, mas terá suporte para a versão ga.

Ativar o registo pode ajudar a descobrir informações úteis sobre falhas. Para ver um registo de pedidos e respostas HTTP, defina a variável de AZURE_LOG_LEVEL ambiente como info. Em alternativa, o registo pode ser ativado no runtime ao chamar setLogLevel no @azure/logger:

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

setLogLevel("info");

Para obter instruções mais detalhadas sobre como ativar os registos, pode ver os documentos do pacote @azure/logger.

Passos seguintes

Veja o diretório de exemplos para obter exemplos detalhados que demonstram como utilizar as bibliotecas de cliente.

Contribuir

Se quiser contribuir para esta biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.

Impressões