IoT Platform:Crear una tarea de invocación de servicio por lotes

Requisitos previos

• Debe existir un modelo Thing Specification Language (TSL) definido para el producto al que pertenecen los dispositivos cuyos servicios asíncronos desea invocar, y dichos servicios deben compartir el mismo identificador. Para obtener más información, consulte Import a TSL model.

• La funcionalidad de invocación de servicio TSL debe estar configurada en los dispositivos. Para obtener más información, consulte Instructions.

Proceso de gestión de tareas

1. Cree una tarea de invocación de servicio por lotes.

   1. En la consola de IoT Platform, 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 los parámetros en los pasos Create Task y Task Configuration según las indicaciones y haga clic en Complete. Pase el puntero sobre el icono junto a un parámetro para consultar su descripción. A continuación se detalla la tabla de parámetros available.

      • Create Task

        Parámetro	Descripción
        Task Name	Especifique un nombre válido para la tarea. Puede definir un nombre personalizado.
        Task Type	Establezca este parámetro en Batch Service Call Task.
        Task Description	Proporcione información como el propósito de la tarea para facilitar su identificación.
        Destination Device, Product, or Group	Seleccione los dispositivos destino de la tarea. Puede seleccionarlos por dispositivo, producto o grupo. Importante Si selecciona dispositivos por grupo, no podrá elegir un grupo dinámico.
        Task Execution Rules Issued to Devices	Cargue un archivo de reglas. El archivo debe tener formato JSON y no superar los 64 KB de tamaño. Haga clic en Download Template para obtener una plantilla de reglas. El siguiente código de ejemplo define un servicio TSL llamado Data Computing, cuyo identifier es Operation_Service, con el parámetro Invoke Method establecido en Asynchronous, y cuyos parámetros de entrada son NumberA y NumberB, ambos del tipo de datos int32: { "serviceIdentifier": "Operation_Service", "params": { "NumberA": 32, "NumberB": 56 } } serviceIdentifier: especifica el identificador único del servicio. Para consultar el identificador de servicio de un dispositivo, vaya a la pestaña Define Feature del producto correspondiente en la consola de IoT Platform. Si un servicio con identificador Operation_Service pertenece a un módulo personalizado llamado testFb, establezca el par clave-valor como "serviceIdentifier": "testFb:Operation_Service". El módulo personalizado no es el módulo predeterminado. params: especifica los parámetros de entrada del servicio. Puede configurar varios parámetros de entrada en params.

      • Configuración de subtareas

        Parámetro	Descripción
        Sub-task Execution Rate	Especifique la cantidad 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 se calcula respecto al momento en que configura este ajuste. Una vez creada la tarea, esta se inicializa y espera hasta la hora programada para comenzar.

2. Después de crear la tarea, IoT Platform invoca la operación InvokeThingService o InvokeThingsService para invocar el servicio y envía una solicitud asíncrona al dispositivo especificado. Posteriormente, el dispositivo devuelve una respuesta asíncrona a IoT Platform.

   Mensaje de ejemplo:

   {
       "id": "123",
       "version": "1.0",
       "params": {
           "Power": "on",
           "WF": "2"
       },
       "method": "thing.service.${tsl.service.identifier}"
   }

   params contiene los mismos datos que params en el archivo de reglas. {tsl.service.identifier} contiene el mismo valor que serviceIdentifier en el archivo de reglas. En este ejemplo, se utiliza el siguiente mensaje:

   {
     "id": "123",
     "version": "1.0",
     "params": {
       "NumberA": 32,
       "NumberB": 56
     },
     "method": "thing.service.Operation_Service"
   }

   Para obtener más información sobre las notas de uso correspondientes en el protocolo Alink, consulte Device service invocation (asynchronous).

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 puede programarse 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.

   Puede realizar las siguientes operaciones:

   • Cancelar una tarea que se encuentre en estado processing.

   • Haga clic en View junto a una tarea para abrir su página de detalles, donde podrá 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 y la configuración de subtareas, así como descargar el archivo de tareas del dispositivo.
     Task Summary	Muestra estadísticas de subtareas agrupadas por estado. Haga clic en View junto a un dispositivo para ir a su página de Device Details: En la pestaña Task, consulte la lista completa de 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 presenta errores, haga clic en Execution Details para ver la causa del error. Si una subtarea tiene 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 hayan expirado o fallado en la tarea actual.

   • Haga clic en Delete junto a la tarea deseada y luego confirme con 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 afectar su negocio. Proceda con precaución.