Entender o analisador do modelo dos Gêmeos Digitais
A DTDL (Digital Twins Definition Language) é descrita na especificação DTDL. Os usuários podem usar o pacote NuGet do Analisador de Modelos dos Gêmeos Digitais para validar e consultar um modelo DTDL. 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 aquele no Visual Studio ou na CLI dotnet.
dotnet add package DTDLParser
Observação
No momento da elaboração deste artigo, a versão do analisador era 1.0.52.
Usar 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 da linguagem 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.ModelsRepositorycliente. - DTDLParserJSInteropSample mostra como usar o analisador DTDL do JavaScript em execução no navegador, usando .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óximas etapas
A API do analisador de modelo examinada neste artigo habilita muitos cenários para automatizar ou validar tarefas que dependem de modelos de DTDL. Por exemplo, você pode criar dinamicamente uma interface do usuário com base nas informações no modelo.