Ajouter une tâche de définition de propriétés par lot - IoT Platform

Pour définir simultanément les valeurs de propriété de plusieurs appareils, utilisez la fonctionnalité de tâche de définition de propriétés par lot d'IoT Platform. Cette rubrique explique comment créer la tâche, décrit les topics et les formats de données utilisés lors de son exécution, et indique comment consulter son statut.

Prérequis

Une propriété du modèle TSL a été ajoutée au produit auquel les appareils appartiennent. Les appareils doivent partager le même identifiant de propriété. Pour plus d'informations, consultez la page Ajouter un modèle TSL.
Les appareils ont été programmés pour définir les propriétés du modèle TSL. Pour plus d'informations, consultez la page Définir les propriétés d'un modèle TSL.

Flux de travail

Créez une tâche de définition de propriétés par lot.

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

Sur la page Create Task, configurez la tâche et les sous-tâches. Cliquez sur l'icône d'aide située à côté du nom d'un paramètre pour obtenir plus d'informations.

Configuration de la tâche

Parameter	Description
Task Name	Saisissez un nom personnalisé pour la tâche, conforme aux conventions de nommage.
Task Type	Sélectionnez Batch Property Setting Task.
Task Description	Saisissez une description, telle que l'objectif de la tâche. Cela vous aide à distinguer les différentes tâches.
Target Device, Product, or Group	Sélectionnez les appareils cibles pour la tâche. Vous pouvez les sélectionner 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 for Devices	Importez un fichier de règles au format `.json`. La taille du fichier ne doit pas dépasser 64 Ko. Cliquez sur Download Template pour obtenir un modèle de fichier de règles. Par exemple, une propriété du modèle TSL d'un produit est Temperature. L'identifier est temperature et le data type est double. Le code suivant illustre cet exemple : `{ "params": { "temperature": 30.5 } }` params : les paramètres de définition des propriétés. Plusieurs propriétés peuvent être incluses. temperature et 30.5 : l'identifiant de la propriété et sa valeur. Vous pouvez consulter l'identifiant de la propriété dans l'onglet Define Feature du produit, depuis la console IoT Platform. Pour la propriété `temperature` associée à un module personnalisé `testFb` (et non un module par défaut), le paramètre est `"testFb:temperature":30.5`.

Configuration des sous-tâches

Parameter	Description
Sub-task Execution Rate	Spécifiez le nombre de sous-tâches à envoyer 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 effectuez cette configuration. Après la création d'une tâche, celle-ci est initialisée et attend l'heure planifiée pour démarrer.

Cliquez sur Complete.

Une fois la tâche créée, IoT Platform appelle l'opération d'API SetDeviceProperty ou SetDevicesProperty pour envoyer les commandes de définition de propriété aux appareils. Les appareils renvoient ensuite des réponses à IoT Platform.

Format des données (mobile terminated)	Topics de requête et de réponse
Pass-through/custom	Topic de requête : `/sys/${productKey}/${deviceName}/thing/model/down_raw` Topic de réponse : `/sys/${productKey}/${deviceName}/thing/model/down_raw_reply`
Alink JSON	Topic de requête : `/sys/${productKey}/${deviceName}/thing/service/property/set` Topic de réponse : `/sys/${productKey}/${deviceName}/thing/service/property/set_reply`

Le code suivant présente un exemple de message :

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

Le champ params contient les mêmes données que le champ params présent dans le fichier de règles de la tâche.

Pour plus d'informations sur le protocole Alink utilisé pour définir les propriétés des appareils, consultez la page Définir les propriétés des appareils.

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

Important

Une tâche dont le statut est

timed out

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

Le compteur démarre lors de 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, le statut de la tâche passe à timed out.

Vous pouvez effectuer les opérations suivantes :

Annulez une tâche qui se trouve dans l'état processing.

Cliquez sur View à côté d'une tâche pour ouvrir sa page de détails, où vous pouvez consulter les informations relatives à la tâche et 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	Consultez les statistiques des sous-tâches regroupées par statut. 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 consulter la cause de l'échec. Si une sous-tâche se trouve dans l'état timed out ou failed, cliquez sur le bouton de statut correspondant pour afficher la liste des sous-tâches dans cet état. Cliquez sur Rerun en haut 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 cliquez 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. Procédez avec prudence.