Edición de una plantilla de dispositivo

Una plantilla de dispositivo incluye un modelo que describe cómo interactúa un dispositivo con IoT Central. Este modelo define las funcionalidades del dispositivo y cómo ioT Central interactúa con ellos. Los dispositivos pueden enviar datos de telemetría y valores de propiedad a IoT Central, IoT Central puede enviar actualizaciones de propiedades y comandos a un dispositivo. IoT Central también usa el modelo para definir interacciones con características de IoT Central, como trabajos, reglas y exportaciones.

Los cambios en el modelo de una plantilla de dispositivo pueden afectar a toda la aplicación, incluidos los dispositivos conectados. Los cambios en una funcionalidad usada por reglas, exportaciones, grupos de dispositivos o trabajos pueden provocar que se comporten inesperadamente o no funcionen en absoluto. Por ejemplo, si quita una definición de telemetría de una plantilla:

• IoT Central ya no puede interpretar ese valor. IoT Central muestra los datos del dispositivo que no puede interpretar como Datos no modelados en la página de Datos en bruto del dispositivo.
• IoT Central ya no incluye el valor en las exportaciones de datos.

Para ayudarle a evitar consecuencias imprevistas de editar una plantilla de dispositivo, en este artículo se incluyen recomendaciones basadas en la fase actual del ciclo de vida de desarrollo. En general, cuanto más temprano se esté en el ciclo de vida de desarrollo, más tolerante se puede ser a los cambios en la plantilla de dispositivos.

Para más información sobre las plantillas de dispositivo y cómo crear una, consulte ¿Qué son las plantillas de dispositivo? y Creación de una plantilla de dispositivo en la aplicación de Azure IoT Central.

Para obtener información sobre cómo administrar plantillas de dispositivo mediante la API REST de IoT Central, consulte Uso de la API rest de IoT Central para administrar plantillas de dispositivo.

Modificación de una plantilla de dispositivo

Los cambios aditivos, como agregar una funcionalidad o una interfaz a un modelo, no son cambios de interrupción. Puede realizar cambios aditivos en un modelo en cualquier fase del ciclo de vida de desarrollo.

Los cambios importantes incluyen quitar partes de un modelo o cambiar un nombre de funcionalidad o un tipo de esquema. Estos cambios podrían hacer que las características de la aplicación, como reglas, exportaciones o paneles muestren mensajes de error y dejen de funcionar.

En las primeras fases de desarrollo de dispositivos, mientras continúas con el diseño y la prueba del modelo, hay una mayor tolerancia para realizar cambios directamente en el modelo del dispositivo. Antes de conectar dispositivos de producción a una plantilla de dispositivo, puede editar la plantilla de dispositivo directamente. IoT Central aplica esos cambios automáticamente a los dispositivos al publicar la plantilla de dispositivo.

Después de conectar dispositivos de producción a una plantilla de dispositivo, evalúe el impacto de los cambios antes de editar una plantilla de dispositivo. No debe realizar cambios importantes en una plantilla de dispositivo en producción. Para realizar estos cambios, cree una nueva versión de la plantilla de dispositivo. Pruebe la nueva plantilla de dispositivo y, a continuación, migre los dispositivos de producción a la nueva plantilla en un tiempo de inactividad programado.

Actualización de una plantilla de dispositivo IoT Edge

Para un dispositivo IoT Edge, el modelo agrupa las funcionalidades por módulos que corresponden a los módulos de IoT Edge que se ejecutan en el dispositivo. El manifiesto de implementación es un documento JSON independiente que indica a un dispositivo IoT Edge qué módulos instalar, cómo configurarlos y qué propiedades tiene el módulo. Si modifica un manifiesto de implementación, puede actualizar la plantilla de dispositivo para incluir los módulos y propiedades definidos en el manifiesto:

1. Vaya al nodo Módulos de la plantilla de dispositivo.
2. En la página Resumen de módulos , seleccione Importar módulos desde el manifiesto.
3. Seleccione el manifiesto de implementación adecuado y seleccione Importar.

Para más información, consulte Dispositivos IoT Edge e IoT Central.

Editar y publicar acciones

Las siguientes acciones son útiles al editar una plantilla de dispositivo:

• Guardar. Al cambiar parte de la plantilla de dispositivo, al guardar los cambios se crea un borrador al que puede volver. Estos cambios aún no afectan a los dispositivos conectados. Los dispositivos creados a partir de esta plantilla no tienen los cambios guardados hasta que se publiquen.
• Publicar. Al publicar la plantilla de dispositivo, se aplican los cambios guardados a las instancias de dispositivo existentes. Las instancias de dispositivo recién creadas siempre usan la plantilla publicada más reciente.
• Versionar una plantilla. Al versionar una plantilla de dispositivo, se crea una nueva versión de la plantilla con todos los cambios guardados más recientes. Los cambios realizados en una nueva versión no afectan a las instancias de dispositivo existentes. Para más información, consulte Versión de una plantilla de dispositivo.
• Control de las versiones de una interfaz. Cuando se genera una versión de una interfaz, se crea una nueva interfaz con todas las funcionalidades guardadas más recientes. Puede reutilizar una interfaz en varias ubicaciones dentro de una plantilla. Esa reutilización es la razón por la que un cambio realizado en una referencia a una interfaz cambia todos los lugares de la plantilla que usan la interfaz. Cuando se genera una versión de una interfaz, este comportamiento cambia porque la nueva versión es ahora una interfaz independiente. Para más información, consulte Versión de una interfaz.
• Migrar un dispositivo. Al migrar un dispositivo, la instancia de dispositivo cambia de una plantilla de dispositivo a otra. La migración de dispositivos puede causar una breve interrupción mientras IoT Central procesa los cambios. Para más información, consulte Migración de un dispositivo entre versiones.

Números de versión

Tanto los modelos de dispositivo como las interfaces tienen números de versión. Los distintos números de versión permiten que los modelos o interfaces compartan un @id valor, al tiempo que proporcionan un historial de actualizaciones. Los números de versión solo se incrementan si elige la versión de la plantilla o la interfaz, o si cambia deliberadamente el número de versión. Debe cambiar un número de versión al realizar un cambio importante en una plantilla o interfaz.

En el fragmento de código siguiente se muestra el modelo de dispositivo para un dispositivo termostato. El modelo de dispositivo tiene una sola interfaz. Puede ver el número de versión, 1, al final del@id campo.

{
  "@context": "dtmi:dtdl:context;2",
  "@id": "dtmi:com:example:Thermostat;1",
  "@type": "Interface",
  "displayName": "Thermostat",
  "description": "Reports current temperature and provides desired temperature control.",
  "contents": [
    // ...
  ]
}

Para ver esta información en la interfaz de usuario de IoT Central, seleccione Editar identidad en el editor de plantillas de dispositivo:

Versionar una plantilla de dispositivo

Para crear una versión de una plantilla de dispositivo:

1. Vaya a la página Plantillas de dispositivo.
2. Seleccione la plantilla de dispositivo que desea versionar.
3. Seleccione Versión en la parte superior de la página y asigne un nuevo nombre a la plantilla. IoT Central sugiere un nuevo nombre, que puede editar.
4. Selecciona Crear.

Ahora ha creado una nueva plantilla con una identidad única que no está asociada a ningún dispositivo existente.

Versión de una interfaz

Para crear una versión de una interfaz:

1. Vaya a la página Plantillas de dispositivo.
2. Seleccione la plantilla de dispositivo que tiene en modo borrador.
3. Seleccione la interfaz publicada que desea versionar y editar.
4. Seleccione Versión en la parte superior de la página de la interfaz.
5. Selecciona Crear.

Ahora que ha creado una nueva interfaz con una identidad única no se sincroniza con la versión de interfaz anterior.

Migración de un dispositivo entre versiones

Puede crear varias versiones de la plantilla de dispositivo. Con el tiempo, tendrá varios dispositivos conectados mediante estas plantillas de dispositivo. Puede migrar dispositivos de una versión de la plantilla de dispositivo a otra. En los pasos siguientes se describe cómo migrar un dispositivo:

1. Vaya a la página Dispositivos .

2. Seleccione el dispositivo que necesita migrar a otra versión.

3. Elija Migrar:

   

4. Seleccione la plantilla de dispositivo con la versión a la que desea migrar el dispositivo y seleccione Migrar.

Sugerencia

Puede usar un trabajo para migrar todos los dispositivos de un grupo de dispositivos a una nueva plantilla de dispositivo al mismo tiempo.