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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 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éez 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 des 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 , 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 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.
    5. Dans le plan d’action de 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 Input Variables (Variables d’entrée), sélectionnez Create Variable (Créer une variable).
        Cette variable d’entrée stocke le corps de la réponse REST.
        Par exemple, pour l’entrée Nom de la variable, saisissez la charge utile.
      2. Pour la variable Valeur d’entrée, 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 des 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 qui possède 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 propriété d’étiquette et de nom définie sur des valeurs de chaîne. La propriété d’étiquette détermine comment l’option apparaît 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 5 000 options de liste de choix maximum. Un objet JSON qui renvoie plus de 5 000 options de liste de choix est tronqué lors du rendu.
        Définir l’objet des sorties
        Définissez l’objet des sorties pour qu’il retourne votre objet JSON de choix dynamique.
      4. Dans Variables en 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 d’é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 sortie de l’action de test
    8. Sélectionnez Publier pour rendre l’action disponible à 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.