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

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

    • Créez une action de collecte de données pour générer une liste d’options de choix pour une entrée de choix dynamique.

    Avant de commencer

    • Rôle requis : action_designer ou admin
    • Créer des informations d’identification et des connexions pour votre point de terminaison REST

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Concepteur de flux.
    2. Sélectionner Créer > Action.
    3. Dans le champ Nom , saisissez un nom pour votre action, choisissez le périmètre de l’application approprié, puis sélectionnez Soumettre.
    4. 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 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 le plan d’action sous l’étape REST, sélectionnez l’icône Ajouter une nouvelle étape ( icône Ajouter une nouvelle étape) et sélectionnez l’étape Script .
      1. Dans Variables d’entrée, sélectionnez Créer une variable.
        Cette variable d’entrée stocke le corps de la réponse REST.
        Par exemple, pour la variable d’entrée Nom, saisissez la charge utile.
      2. Pour la variable d’entrée Valeur, sélectionnez la pastille de données pour la sortie Corps de la réponse de l’étape REST.
      3. Dans Script, entrez un script pour créer une sortie JSON à partir de la variable d’entrée.
        Votre script doit effectuer ces tâches.
        Analyser la variable d’entrée au format JSON
        Vous pouvez utiliser l’API JSON - Global pour transformer la variable d’entrée d’une chaîne en objet JSON.
        Créer un objet JSON formaté pour un choix dynamique
        Vous devez connaître la structure de données de la réponse REST pour mapper les valeurs de réponse aux options de la liste de choix. Votre script doit créer un objet JSON de choix dynamique avec une propriété nommée data. La valeur de la propriété de données doit être un tableau d’options de liste de choix. Chaque option de liste de choix doit avoir une étiquette et une propriété de nom définies sur des valeurs de chaîne. La propriété label détermine le mode d’affichage de l’option dans la liste de choix. La propriété name détermine la façon dont l’option est stockée et référencée dans le système.

        Par exemple, cet objet JSON définit un tableau avec trois options de liste de choix.

        {
    data: [
        {
            label: "Choice Option 1",
            name: "choice_option_1"
            
        }, 
        {
            label: "Choice Option 2",
            name: "choice_option_2"
        }, 
        {	
            label: "Choice Option 3",
            name: "choice_option_3"
        }
    ]
}
        Remarque :
        Une entrée de choix dynamique ne peut afficher que jusqu’à 5 000 options de liste de choix. Un objet JSON qui renvoie plus de 5 000 options de liste de choix est tronqué lors du retour.
        Définir l’objet des sorties
        Définissez l’objet outputs pour renvoyer votre objet JSON de choix dynamique.
      4. Dans Variables de sortie, sélectionnez Créer une variable.
        Cette variable de sortie stocke les options de liste de choix créées par votre script.
      5. Pour le type de variable de sortie, sélectionnez JSON.
        Le type de variable de sortie du script doit être JSON.
    6. Dans Plan d’action, sélectionnez Sorties
      1. Sélectionnez Créer une sortie.
      2. Définissez l’étiquette de sortie et nommez la sortie.
      3. Définissez le type de sortie sur JSON.
        Remarque :
        L’action peut avoir plusieurs sorties, mais il ne peut y en avoir qu’une de type JSON.
      4. Sélectionnez Quitter le mode de modification.
      5. En regard du champ Valeur , sélectionnez le sélecteur de pastilles de données ( sélecteur de pastilles de données), puis sélectionnez la variable de sortie de l’étape Script que vous avez créée pour stocker les options de liste de choix.
    7. Sélectionnez Enregistrer et testez l’action.
      La valeur d’exécution de la sortie doit être un objet JSON qui possède une propriété de données et un tableau d’options de liste de choix.
      Exemple de résultat de l’action de test
    8. Sélectionnez Publier pour rendre l’action disponible pour d’autres flux et actions dans le même périmètre de l’application.

    Résultats

    Vous pouvez maintenant utiliser votre action de collecte de données pour renseigner les options qui s’affichent pour une entrée de choix dynamique dans une action parente.Utilisez votre action de collecte de données pour renseigner les options d’un choix dynamique.