Créer une tâche d'appel de service par lot - IoT Platform - Centre de documentation Alibaba Cloud

Pour appeler des services asynchrones sur plusieurs appareils simultanément, créez une tâche de configuration de propriétés par lot dans la console IoT Platform. Cette rubrique explique comment créer une telle tâche et consulter ses informations. Elle décrit également les topics utilisés lors de l'exécution de la tâche ainsi que les formats de message correspondants.

Prérequis

Un modèle Thing Specification Language (TSL) est défini pour le produit auquel appartiennent les appareils dont vous souhaitez appeler les services asynchrones, et ces services partagent le même identifiant. Pour plus d'informations, consultez la page Importer un modèle TSL.
La fonctionnalité d'appel de service TSL est configurée pour les appareils. Pour en savoir plus, reportez-vous aux Instructions.

Processus de gestion des tâches

Créez une tâche d'appel de service par lot.

Dans la console IoT Platform, accédez à votre instance. Dans le volet de navigation de gauche, choisissez Maintenance > Tasks. Sur la page Tasks, cliquez sur Create Task.

Sur la page Create Task, configurez les paramètres des étapes Create Task et Task Configuration selon les instructions, puis cliquez sur Complete. Placez le pointeur sur l'icône située à côté d'un paramètre pour afficher des informations à son sujet. Le tableau suivant présente la description des paramètres.

Create Task

Parameter	Description
Task Name	Spécifiez un nom valide pour la tâche. Vous pouvez choisir un nom personnalisé.
Task Type	Définissez ce paramètre sur Batch Service Call Task.
Task Description	Indiquez des informations telles que l'objectif de la tâche, ce qui permet d'identifier facilement les différentes tâches.
Destination Device, Product, or Group	Sélectionnez les appareils cibles pour la tâche. Vous pouvez effectuer cette sélection par appareil, par produit ou par groupe. Important Si vous sélectionnez des appareils par groupe, vous ne pouvez pas choisir un groupe dynamique.
Task Execution Rules Issued to Devices	Téléchargez un fichier de règles. Ce fichier doit être au format `JSON` et sa taille ne doit pas dépasser 64 Ko. Cliquez sur Download Template pour obtenir un modèle de règle. L'exemple de code ci-dessous définit un service TSL nommé Data Computing, dont l'identifier est Operation_Service, dont la méthode d'Invoke Method est définie sur Asynchronous et dont les paramètres d'entrée sont NumberA et NumberB, tous deux de type int32 : `{ "serviceIdentifier": "Operation_Service", "params": { "NumberA": 32, "NumberB": 56 } }` serviceIdentifier : spécifie l'identifiant unique du service. Pour consulter l'identifiant de service d'un appareil, accédez à l'onglet Define Feature du produit auquel appartient l'appareil dans la console IoT Platform. Si un service dont l'identifiant est `Operation_Service` appartient à un module personnalisé nommé `testFb`, définissez la paire clé-valeur comme suit : `"serviceIdentifier": "testFb:Operation_Service"`. Le module personnalisé n'est pas le module par défaut. params : spécifie le paramètre d'entrée du service. Vous pouvez configurer plusieurs paramètres d'entrée pour params.

Sub-task configuration

Parameter	Description
Sub-task Execution Rate	Spécifiez le nombre de sous-tâches à pousser par minute. Ce paramètre est obligatoire.
Sub-task Execution Timeout	Ce paramètre s'applique uniquement aux tâches personnalisées. Vous n'avez pas besoin de le configurer.

| Sub-task Start Time | Ce paramètre est facultatif.

L'heure est relative au moment où vous configurez ce paramètre.

Une fois la tâche créée, elle est initialisée et attend l'heure planifiée pour démarrer.

Après avoir créé la tâche, IoT Platform appelle l'opération InvokeThingService ou InvokeThingsService pour invoquer le service et pousse de manière asynchrone une requête vers l'appareil spécifié. L'appareil renvoie ensuite une réponse asynchrone à IoT Platform.
Exemple de message :
```
{
    "id": "123",
    "version": "1.0",
    "params": {
        "Power": "on",
        "WF": "2"
    },
    "method": "thing.service.${tsl.service.identifier}"
}
```
Le champ params contient les mêmes données que le champ params présent dans le fichier de règles. La valeur {tsl.service.identifier} correspond à celle du paramètre serviceIdentifier dans le fichier de règles. Dans cet exemple, le message utilisé est le suivant :
```
{
  "id": "123",
  "version": "1.0",
  "params": {
    "NumberA": 32,
    "NumberB": 56
  },
  "method": "thing.service.Operation_Service"
}
```
Pour plus d'informations sur les notes d'utilisation correspondantes dans le protocole Alink, consultez la section Appel de service d'appareil (asynchrone).

Sur la page Maintenance > Tasks de votre instance, consultez les tâches créées ainsi que leur état actuel.

Important

Une tâche dont l'état est

timed out

ne peut pas être replanifiée pour exécution.

Le décompte commence dès la création de la tâche. Si toutes les sous-tâches ne sont pas terminées dans un délai de sept jours, l'état de la tâche passe à timed out.

Les opérations suivantes sont disponibles :

Annulez une tâche dont l'état est processing.

Cliquez sur View à côté d'une tâche pour ouvrir sa page de détails, où vous pourrez consulter les informations relatives à la tâche ainsi que les statistiques d'exécution des sous-tâches.

Tab	Description
Task Information	Consultez les informations de la tâche, modifiez la description de la tâche et la configuration des sous-tâches, et téléchargez le fichier de tâche de l'appareil.
Task Summary	Affichez les statistiques des sous-tâches regroupées par état. Cliquez sur View à côté d'un appareil pour accéder à sa page Device Details : Dans l'onglet Task, consultez la liste de toutes les tâches associées à l'appareil. Dans l'onglet Device Log, cliquez sur Go to View. Dans l'onglet cloud run log, sélectionnez cloud-to-device message dans la liste déroulante workload type pour afficher les journaux des tâches de l'appareil. Si une sous-tâche a échoué, cliquez sur Execution Details pour connaître la cause de l'échec. Si une sous-tâche est dans l'état timed out ou failed, cliquez sur le bouton d'état correspondant pour afficher la liste des sous-tâches dans cet état. Cliquez sur Rerun au-dessus de la liste pour réexécuter toutes les sous-tâches ayant expiré ou échoué pour la tâche actuelle.

Cliquez sur Delete à côté de la tâche cible, puis sur OK.

Avertissement
La suppression d'une tâche d'appareil entraîne l'effacement de toutes les données associées. Si des services dépendent de cette tâche, ils pourraient devenir indisponibles ou votre activité pourrait être impactée. Agissez avec prudence.