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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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
    Remarque :
    Les entrées dynamiques ne sont pas disponibles dans le système de base. Pour utiliser les entrées dynamiques dans Studio de workflow, vous devez Demander un Hub d'intégration module d'extension.

    Procédure

    1. Accédez à la Tout > Automatisation des processus > Concepteur de flux.
    2. Sélectionner Créer > Action.
    3. Dans le champ Nom , donnez un nom à 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 de 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 , consultez Hub d'intégrationÉtape RESTet REST dans Centre d’intégration.
    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), puis 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 le nom de la variable d’entrée, saisissez la charge utile.
      2. Pour la valeur de la variable d’entrée, sélectionnez la pastille de données pour la sortie Corps de 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 mis en forme 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 liste de choix. Votre script doit créer un objet JSON de choix dynamique qui a une propriété nommée data. La valeur de la propriété data 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 comment 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 sera tronqué lors du rendu.
        Définir l’objet de sorties
        Définissez l’objet outputs pour renvoyer l’objet JSON de votre 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 variable de sortie du script doit être JSON.
    6. Dans le Plan d’action, sélectionnez Sorties
      1. Sélectionnez Créer une sortie.
      2. Définissez l’étiquette de sortie et le nom de 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 d’édition.
      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 É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 pour la sortie doit être un objet JSON doté d’une propriété data et d’un tableau d’options de liste de choix.
      Exemple de sortie à partir de l’action de test
    8. Sélectionnez Publier pour mettre l’action à la disposition 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 apparaissent 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.