IoT Platform:Crear una tarea de configuración masiva de propiedades

Requisitos previos

• Se agregó una propiedad del modelo TSL al producto al que pertenecen los dispositivos. Los dispositivos deben tener el mismo identificador de propiedad. Para obtener más información, consulte Add a TSL model.

• Los dispositivos se programaron para configurar propiedades del modelo TSL. Para obtener más información, consulte Set properties of a TSL model.

Flujo de trabajo

1. Cree una tarea de configuración masiva de propiedades.

   1. En la IoT Platform console, vaya a su instancia. En el panel de navegación izquierdo, seleccione Maintenance > Tasks. En la página Tasks, haga clic en Create Task.

   2. En la página Create Task, configure la tarea y las subtareas. Haga clic en el icono de ayuda junto al nombre de un parámetro para obtener más información.

      • Configuración de la tarea

        Parámetro	Descripción
        Task Name	Introduzca un nombre personalizado para la tarea que cumpla con las convenciones de nomenclatura.
        Task Type	Seleccione Batch Property Setting Task.
        Task Description	Introduzca una descripción, como el propósito de la tarea. Esto le ayuda a identificar las distintas tareas.
        Target Device, Product, or Group	Seleccione los dispositivos destino para la tarea. Puede seleccionarlos por dispositivo, producto o grupo. Importante Si selecciona dispositivos por grupo, no puede seleccionar un grupo dinámico.
        Task Execution Rules for Devices	Cargue un archivo de reglas en formato .json. El tamaño del archivo no debe superar los 64 KB. Haga clic en Download Template para obtener una plantilla de archivo de reglas. Por ejemplo, suponga que una propiedad del modelo TSL de un producto es Temperature. El identifier es temperature y el data type es double. A continuación se muestra un ejemplo: { "params": { "temperature": 30.5 } } params: los parámetros para configurar propiedades. Se pueden incluir varias propiedades. temperature y 30.5: el identificador de la propiedad y su valor. Consulte el identificador de la propiedad en la pestaña Define Feature del producto en la IoT Platform console. Para la propiedad temperature dentro de un módulo personalizado testFb (que no es un módulo predeterminado), el parámetro es "testFb:temperature":30.5.

      • Configuración de subtareas

        Parámetro	Descripción
        Sub-task Execution Rate	Especifique el número de subtareas que se enviarán por minuto. Este parámetro es obligatorio.
        Sub-task Execution Timeout	Este parámetro solo aplica a tareas personalizadas. No es necesario configurarlo.
        Sub-task Start Time	Este parámetro es opcional. La hora es relativa al momento en que configura este ajuste. Una vez creada la tarea, esta se inicializa y espera la hora programada para comenzar.

   3. Haga clic en Complete.

2. Después de crear la tarea, IoT Platform llama a la operación de API SetDeviceProperty o SetDevicesProperty para enviar comandos de configuración de propiedades a los dispositivos. Posteriormente, los dispositivos devuelven respuestas a IoT Platform.

   Formato de datos (mobile terminated)	Topics de solicitud y respuesta
   Pass-through/custom	Topic de solicitud: /sys/${productKey}/${deviceName}/thing/model/down_raw Topic de respuesta: /sys/${productKey}/${deviceName}/thing/model/down_raw_reply
   Alink JSON	Topic de solicitud: /sys/${productKey}/${deviceName}/thing/service/property/set Topic de respuesta: /sys/${productKey}/${deviceName}/thing/service/property/set_reply

   El siguiente código muestra un mensaje de ejemplo:

   {
       "id": "123",
       "version": "1.0",
       "params": {
           "temperature": "30.5"
       },
       "method": "thing.service.property.set"
   }

   El campo params contiene los mismos datos que el campo params del archivo de reglas de la tarea.

   Para obtener más información sobre el protocolo Alink para configurar propiedades de dispositivos, consulte Set device properties.

3. En la página Maintenance > Tasks de su instancia, consulte las tareas creadas y su estado actual.

   Importante

   Una tarea con estado

   timed out

   no se puede programar nuevamente para su ejecución.

   El temporizador comienza cuando se crea la tarea. Si no todas las subtareas se completan dentro de siete días, el estado de la tarea cambia a timed out.

   Realice las siguientes operaciones:

   • Cancelar una tarea que se encuentra en estado processing.

   • Haga clic en View junto a una tarea para abrir su página de detalles, donde puede consultar la información de la tarea y las estadísticas de ejecución de subtareas.

     Pestaña	Descripción
     Task Information	Permite consultar la información de la tarea, modificar la descripción de la tarea y la configuración de subtareas, así como descargar el archivo de tareas del dispositivo.
     Task Summary	Permite ver estadísticas de subtareas agrupadas por estado. Haga clic en View junto a un dispositivo para ir a su página Device Details: En la pestaña Task, consulte la lista de todas las tareas del dispositivo. En la pestaña Device Log, haga clic en Go to View. En la pestaña cloud run log, seleccione cloud-to-device message en la lista desplegable workload type para consultar los registros de tareas del dispositivo. Si una subtarea presentó errores, haga clic en Execution Details para consultar la causa del error. Si una subtarea está en estado timed out o failed, haga clic en el botón de estado correspondiente para ver la lista de subtareas en ese estado. Haga clic en Rerun encima de la lista para volver a ejecutar todas las subtareas que expiraron o presentaron errores en la tarea actual.

   • Haga clic en Delete junto a la tarea objetivo y luego haga clic en OK.

     Aviso

     Al eliminar una tarea de dispositivo, se borran todos los datos relacionados. Si algún servicio depende de esta tarea, podría dejar de estar available o su negocio podría verse afectado. Proceda con precaución.