Créer une action de collecte de données pour un objet dynamique

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture

    • Créez une action pour collecter les valeurs de sortie. Ensuite, transmettez les valeurs à une action parente en tant qu’objet dynamique.

    Avant de commencer

    Rôle requis : action_designer ou admin

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Concepteur de flux.
    2. Sélectionner Nouveau > Nouvelle action.
    3. Dans le champ Nom , saisissez un nom pour votre action, choisissez le périmètre de l’application approprié, puis cliquez sur Soumettre.
    4. Dans Plan d’action, cliquez sur l’icône Ajouter une nouvelle étape ( icône Ajouter une nouvelle étape) sous Entrées et sélectionnez l’étape REST .
      Configurez votre étape REST pour obtenir des données à partir de l’URL de base et du chemin d’accès à la ressource appropriés avec tous les paramètres de requête applicables pour la méthode HTTP GET. Pour plus d’informations sur l’utilisation de l’étape REST dans Hub d'intégration, consultez Étape RESTet REST dans IntegrationHub.
    5. Dans Plan d’action, cliquez sur l’icône Ajouter une nouvelle étape ( icône Ajouter une nouvelle étape) sous votre étape REST et sélectionnez l’étape Script .
      Cette étape de script doit transformer la réponse du corps de réponse de l’étape REST en un format qui définit le schéma d’une sortie d’objet dynamique pour une action parente. Votre étape de script doit :
      • Avoir une seule variable de sortie JSON. L’étape de script peut avoir d’autres variables de sortie, mais une seule doit être de type JSON.
      • Formatez la variable de sortie JSON de sorte qu’elle contienne une propriété nommée data. Pour une sortie d’objet complexe, votre propriété de données doit avoir un format similaire à l’exemple suivant :
        {
       data: {
           type: "object",              
           //Required

           children: [                  
           //Required - This is a collection of field definitions

               {
                   name: "Name 1",      
                   //Required - Unique name

                   label: "Label 1",    
                   //Required - Display name

                   type: "string"       
                   //Required - Supported field type (See the Note below)

               },

               {
                   name: "Name 2",
                   label: "Label 2",
                   type: "string"
               }
           ]
       }
   }
        Pour une sortie de tableau d’objets complexes, votre propriété de données doit avoir un format similaire à l’exemple suivant :
        {
       data: {
           type: "object",                          
           //Required

           attributes: { child_type: "object" }     
           //Required - Indicates that the array's children are of type object

           children: [                              
           //Required - This is a collection of field definitions

               {
                   name: "Name 1",                  
                   //Required - Unique name

                   label: "Label 1",                
                   //Required - Display name

                   type: "string"                   
                   //Required - Supported field type (See the Note below)
               },

               {
                   name: "Name 2",
                   label: "Label 2",
                   type: "string"
               }
           ]
       }
   }
        Remarque :
        Les types de données d’action pris en charge pour la propriété type comprennent :
        • chaîne
        • entier
        • Datetime
        • Choix
        • booléen
        • objet
        • tableau.chaîne
        • array.integer
        • tableau.datetime
        • tableau.choix
        • tableau.booléen
        • tableau.objet
    6. Dans Plan d’action, cliquez sur Sorties.
      Créez une sortie nommée de type JSON. Ensuite, utilisez le sélecteur de pastilles de données ( Sélecteur de pastilles de données) pour affecter la pastille de données pour la variable de sortie JSON de votre étape de script au champ Valeur de la sortie d’action.
      Remarque :
      L’action peut avoir plusieurs sorties, mais il ne peut y en avoir qu’une de type JSON.
    7. Cliquez sur Enregistrer et testez l’action.
      Dans les détails de l’exécution, votre action de collecte de données s’exécute avec succès si la valeur d’exécution pour la sortie contient la propriété de données au format approprié.
    8. Cliquez sur Publier pour rendre l’action disponible pour d’autres flux ou actions dans le même périmètre de l’application.
      Vous pouvez maintenant utiliser votre action de collecte de données pour renseigner les valeurs de schéma d’un objet dynamique dans une action parente.Utilisez votre action de collecte de données pour renseigner les valeurs de schéma d’un objet dynamique.