Compreender o parser de modelos de duplos digitais

A DTDL (Digital Twins Definition Language) é descrita na especificação DTDL. Os usuários podem usar o pacote NuGet do Digital Twins Model Parser para validar e consultar um modelo DTDL v2 ou v3. O modelo DTDL pode ser definido em vários arquivos.

Instalar o analisador de modelo DTDL

O analisador está disponível em NuGet.org com o ID: DTDLParser. Para instalar o analisador, use qualquer gerenciador de pacotes NuGet compatível, como o do Visual Studio ou da dotnet CLI.

dotnet add package DTDLParser

Nota

No momento da escrita, a versão do analisador é 1.0.52.

Use o analisador para validar e inspecionar um modelo

O DTDLParser é uma biblioteca que você pode usar para:

• Determine se um ou mais modelos são válidos de acordo com as especificações de idioma v2 ou v3.
• Identificar erros de modelagem específicos.
• Inspecione o conteúdo do modelo.

Um modelo pode ser composto por uma ou mais interfaces descritas em arquivos JSON. Você pode usar o analisador para carregar todos os arquivos que definem um modelo e, em seguida, validar todos os arquivos como um todo, incluindo quaisquer referências entre os arquivos.

O repositório DTDLParser para .NET inclui os seguintes exemplos que ilustram o uso do analisador:

• DTDLParserResolveSample mostra como analisar uma interface com referências externas, resolver as dependências usando o Azure.IoT.ModelsRepository cliente.
• DTDLParserJSInteropSample mostra como usar o DTDL Parser do JavaScript em execução no navegador, usando o .NET JSInterop.

O repositório DTDLParser para .NET também inclui uma coleção de tutoriais que mostram como usar o analisador para validar e inspecionar modelos.

Próximos passos

A API do analisador de modelo analisada neste artigo permite que muitos cenários automatizem ou validem tarefas que dependem de modelos DTDL. Por exemplo, você pode criar dinamicamente uma interface do usuário a partir das informações no modelo.