IoT Platform:Transférer des données vers Function Compute

Prérequis

• Vous avez créé une instance IoT Platform dans une région prenant en charge le transfert de données vers Function Compute. Pour plus d'informations, consultez la page Disponibilité des fonctionnalités par région.

• Vous avez créé une source de données nommée DataSource et y avez ajouté un topic de communication TSL. Pour plus d'informations, consultez la section Ajouter une source de données.

• Créez un service et une fonction dans Function Compute. Vérifiez que la fonction est correctement configurée et s'exécute comme prévu. Consultez la documentation Function Compute.

  Important

  • Lors de la création de la fonction, définissez le paramètre Request Handler Type sur Handle Event Request.

  • Pour une instance Enterprise Edition, le service et la fonction Function Compute doivent se trouver dans la même région que l'instance.

Contexte

Le moteur de règles transfère les données des appareils vers Function Compute, où des scripts personnalisés exécutent votre logique métier.

Notes d'utilisation

Vous pouvez utiliser la nouvelle ou l'ancienne version de la fonctionnalité de transfert de données pour envoyer des informations vers Function Compute. Pour plus d'informations sur l'ancienne version, consultez la section Transférer des données vers Function Compute (FC).

Créer une destination de données

1. Connectez-vous à la console IoT Platform.

2. Sur la page Overview, localisez l'instance à gérer et cliquez sur son ID ou son nom.

3. Dans le volet de navigation de gauche, choisissez Message Forwarding > Data Forwarding.

4. Sur la page Data Forwarding, cliquez sur Go to New Version dans le coin supérieur droit.

   Remarque

   Si vous avez déjà effectué cette opération, vous êtes automatiquement redirigé vers la nouvelle version de la page Data Forwarding.

5. Cliquez sur l'onglet Data Destination. Dans cet onglet, cliquez sur Create Data Destination.

6. Dans la boîte de dialogue Create Data Destination, saisissez un nom pour la destination de données. Dans cet exemple, nous utilisons DataPurpose. Configurez les paramètres puis cliquez sur OK.

   Paramètre	Description
   Opération	Sélectionnez Send data to Function Compute (FC).
   Région	Sélectionnez la région de votre service Function Compute.
   Service	Sélectionnez un service Function Compute. Pour créer un service dans la console Function Compute, cliquez sur Create Service. Gérer les services.
   Version de la fonction	Sélectionnez une version de fonction : Use Default Version : appelle la version LATEST de la fonction. Select Version : utilise une version publiée spécifique du service. Pour créer une version dans la console Function Compute, cliquez sur Create Version. Gérer les versions. Select Alias : utilise un alias préconfiguré pour une version de service. Pour créer un alias dans la console Function Compute, cliquez sur Create Alias. Gérer les alias.
   Fonction	Sélectionnez la fonction cible. Pour créer une fonction dans la console Function Compute, cliquez sur Create Function. Gérer les fonctions.
   Autorisation	Accorde à IoT Platform l'autorisation d'écrire des données dans Function Compute. Si aucun rôle RAM n'existe, cliquez sur Create RAM Role pour créer un rôle RAM et une stratégie d'autorisation dans la console RAM. Créer un rôle RAM.

Configurer et démarrer un analyseur

1. Créez un analyseur nommé DataParser. Pour plus d'informations, consultez l'étape Étape 1 : Créer un analyseur.

2. Sur la page Parser Details, associez l'analyseur à la source de données créée.

   1. À l'étape Data Source de l'assistant, cliquez sur Associate Data Source.

   2. Dans la boîte de dialogue qui s'affiche, sélectionnez DataSource dans la liste déroulante Data Source, puis cliquez sur OK.

3. Sur la page Parser Details, associez l'analyseur à la destination de données créée.

   1. Cliquez sur Data Destination dans l'assistant. Dans la section Data Destination, cliquez sur Associate Data Destination.

   2. Dans la boîte de dialogue qui s'affiche, sélectionnez DataPurpose dans la liste déroulante Data Destination, puis cliquez sur OK.

   3. Dans la section Data Destination, affichez et enregistrez l'data destination ID. Dans cet exemple, l'ID est 1000.

      Lors de la rédaction du script de l'analyseur, vous devez utiliser l'data destination ID.

4. Sur la page Parser Details, cliquez sur Parser.

5. Dans l'éditeur de code, saisissez un script. Pour plus d'informations sur la modification d'un script, consultez la section Syntaxe du script.

   Pour plus d'informations sur les paramètres de fonction, consultez la liste des fonctions.

   // Use the payload() function to obtain the data that is submitted by devices and convert the data to JSON-formatted data. 
   var data = payload("json");
   // Forward submitted TSL data. 
   writeFc(1000, data);

6. Cliquez sur Debugging. Dans la boîte de dialogue qui s'affiche, sélectionnez un produit et un appareil, spécifiez un topic, puis saisissez les données de charge utile (payload) pour vérifier si le script s'exécute comme prévu.

   Les paramètres sont les suivants :

   • Topic : le topic de rapport des propriétés de l'appareil. Le chemin se termine par /thing/event/property/post.

   • Payload data : format JSON. Le champ items contient Temperature (valeur : 38) et Humidity (valeur : 25), ainsi que les champs productKey, deviceName et gmtCreate.

   Le résultat suivant indique que le script s'exécute correctement. L'onglet Run Result de la boîte de dialogue Debugging affiche la sortie : action: et transmit to fc[destinationId=1000].

7. Cliquez sur Publish.

8. Accédez à l'onglet Parser de la page Data Forwarding. Localisez l'analyseur DataParser et cliquez sur Start dans la colonne Actions pour démarrer l'analyseur.

9. Connectez-vous à la console Function Compute. Sur la page de détails de la fonction, cliquez sur l'onglet Logs pour afficher les journaux d'exécution de la fonction. Dans le coin supérieur droit de la page de détails, choisissez More > Monitoring pour consulter les statistiques de surveillance de la fonction.

   Important

   Les statistiques de surveillance d'une fonction sont générées 5 minutes après son exécution.