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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Créez une action pour collecter les valeurs de sortie. Transmettez ensuite les valeurs à une action parent en tant qu’objet dynamique.

    Avant de commencer

    Rôle requis : action_designer ou admin
    Remarque :
    Les sorties dynamiques ne sont pas disponibles dans le système de base. Pour utiliser des sorties dynamiques dans Studio de workflow, vous devez Demander un Hub d'intégration module d'extension.

    Pourquoi et quand exécuter cette tâche

    Ces étapes vous permettent de créer une action générique de collecte de données pour une sortie dynamique. Pour voir des exemples d’actions de collecte de données pour des sorties dynamiques, reportez-vous à la section Introduction aux sorties dynamiques.

    Procédure

    1. Accédez à la Tout > Automatisation des processus > Studio de workflow.
    2. Sur la page d’accueil, sélectionnez Actions.
    3. Sélectionner Nouveau > Nouvelle action.
    4. Dans le champ Nom , saisissez un nom pour votre action, choisissez le périmètre de l’application approprié, puis sélectionnez Soumettre.
    5. Dans Plan d’action, sélectionnez 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 les 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 REST et REST dans Centre d’intégration.
    6. Dans Plan d’action, sélectionnez 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 la 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 du script peut comporter d’autres variables de sortie, mais une seule doit être de type JSON.
      • Formatez la variable de sortie JSON afin 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
        • date/heure
        • choix
        • booléen
        • objet
        • tableau.chaîne
        • array.integer
        • array.datetime
        • tableau.choix
        • tableau.booléen
        • tableau.objet
    7. Dans Plan d’action, sélectionnez Sorties.
      1. Créez une sortie de type Sortie dynamique.
        Remarque :
        Si les sorties dynamiques ne sont pas disponibles en tant qu’option de type de données, il vous manque un Hub d'intégration abonnement.
      2. Dans les options dynamiques, sélectionnez une action de collecte de données pour l’option Action .
        Pour obtenir des exemples d’actions dynamiques de collecte de données de sortie, reportez-vous à la section Introduction aux sorties dynamiques.
      3. Facultatif : Si nécessaire, définissez l’option d’entrée Dépend d’un autre et sélectionnez l’entrée.
      Créez une sortie de type Objet dynamique.
    8. Sélectionnez 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é.
    9. Sélectionnez Publier pour rendre l’action disponible à d’autres flux ou actions dans le même périmètre de l’application.

      Utilisez votre action de collecte de données pour renseigner les valeurs de schéma d’un objet dynamique.

      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 parent.