Uso del analizador de modelos de Digital Twins

  • Artículo

El lenguaje de definición de Digital Twins (DTDL) se describe en la especificación de DTDL. Los usuarios pueden usar el paquete NuGet Digital Twins Model Parser para validar y consultar los modelos DTDL. Los modelos DTDL se pueden definir en varios archivos.

Instalación del analizador de modelos de DTDL

El analizador está disponible en NuGet.org con el identificador: DTDLParser. Para instalar el analizador, use cualquier administrador de paquetes de NuGet compatible, como el de Visual Studio o la CLI de dotnet.

dotnet add package DTDLParser

Nota:

En el momento de escribir este documento, la versión del analizador es la 1.0.52.

Usar el analizador para validar e inspeccionar un modelo

DTDLParser es una biblioteca que puede usar para:

  • Determine si uno o varios modelos son válidos según las especificaciones de lenguaje v2 o v3.
  • Identificar errores de modelado específicos.
  • Inspeccione el contenido del modelo.

Un modelo puede estar formado por una o varias interfaces descritas en archivos JSON. Puede usar el analizador para cargar todos los archivos que definen un modelo y, a continuación, validar todos los archivos como un todo, incluidas las referencias entre los archivos.

El repositorio DTDLParser para .NET incluye los ejemplos siguientes que muestran el uso del analizador:

  • DTDLParserResolveSample muestra cómo analizar una interfaz con referencias externas, resolver las dependencias mediante el Azure.IoT.ModelsRepository cliente.
  • DTDLParserJSInteropSample muestra cómo usar el analizador de DTDL desde JavaScript que se ejecuta en el explorador mediante JSInterop de .NET.

El repositorio DTDLParser para .NET también incluye una colección de tutoriales que muestran cómo usar el analizador para validar e inspeccionar modelos.

Pasos siguientes

La API del analizador de modelos revisada en este artículo permite muchos escenarios para automatizar o validar tareas que dependen de modelos de DTDL. Por ejemplo, podría crear de forma dinámica una interfaz de usuario a partir de la información del modelo.