Sorties dynamiques
Accédez aux sorties d’action et de flux secondaire sous forme de pastilles de données générées dynamiquement pendant la conception du flux. Vous pouvez également créer des actions de collecte de données pour générer des objets complexes à partir de sorties et Hub d'intégration d’objetsNow Platform.
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.
Pendant la conception du flux, une sortie dynamique récupère les valeurs de schéma de l’objet complexe et les affiche sous forme de pastilles de données dans le panneau de données.
Une sortie dynamique doit pointer vers une action de collecte de données qui collecte les données affichées. Par exemple, une action de collecte de données peut récupérer des valeurs d’un système tiers dans le cadre d’un Hub d'intégration spoke. Pour utiliser une sortie dynamique dans Studio de workflow:
- Un concepteur d’action crée une action de collecte de données.
- Un concepteur d’action crée une action parente avec une sortie dynamique qui pointe vers l’action de collecte de données enfant.
- Un concepteur de flux ajoute l’action parent à un flux.
Actions de collecte de données
Une action de collecte de données collecte des données qui seront utilisées par d’autres actions. Les actions de collecte de données sont destinées à être appelées à partir d’entrées dynamiques plutôt qu’à être ajoutées directement à un flux. Les actions de collecte de données collectent généralement des données à partir de systèmes tiers à l’aide d’un appel REST. Toutes les actions de collecte de données doivent répondre à ces exigences et contraintes.
- L’action comporte une étape de script qui contient une variable de sortie de type JSON.
- L’action possède une sortie nommée output de type JSON dont la valeur est dérivée de la variable de sortie JSON de l’étape de script.Remarque :L’action peut avoir plusieurs sorties, mais ne peut en avoir qu’une de type JSON.
- L’étape Script formate la sortie JSON pour avoir une propriété nommée
data. - La sortie JSON ne doit pas renvoyer plus de 5 000 options de choix, valeurs de modèle de champ ou éléments de tableau lorsque les données sont destinées à un choix dynamique ou à une entrée de modèle dynamique.Remarque :Les entrées de choix dynamique et de modèle dynamique ne peuvent afficher que jusqu’à 5 000 options de choix ou 5 000 valeurs de modèle à partir de la sortie JSON.
- L’action attend jusqu’à 300 secondes (5 minutes) pour recueillir des données avant d’expirer. Remarque :Pour modifier le délai d’expiration de toutes les actions, modifiez la valeur de la sn_flow_designer.sync_action_execution_timeout_in_seconds propriété système.
Objet dynamique
Un objet dynamique est soit un objet complexe, soit un tableau d’objets complexes. Les concepteurs d’actions construisent la structure de l’objet de manière dynamique avec une action de collecte de données plutôt que de la coder en dur. Pour plus d’informations sur la création d’un objet dynamique, consultez Créer une action de collecte de données pour un objet dynamique.
Directives générales
- Utiliser des sorties dynamiques pour les intégrations tierces
- Utilisez des sorties dynamiques pour faire une introspection et extraire des données de systèmes externes pendant la conception du flux. Par exemple, vous pouvez spécifier des points de terminaison de service ou des actions d’appel qui interagissent avec des API de point de terminaison spécifiques. Pour plus d’informations sur la configuration d’intégrations tierces avec Studio de workflow, consultez Centre d’intégration.
- Notez le temps nécessaire pour récupérer de grandes quantités de données
- Par défaut, les sorties dynamiques disposent de 300 secondes pour collecter des données avant que le système ne les arrête. Si votre action de collecte de données nécessite plus de temps pour collecter des données, définissez la sn_flow_designer.sync_action_execution_timeout_in_seconds propriété système sur une valeur supérieure. Évitez les longues valeurs de délai d’expiration pour les flux interactifs où un utilisateur final attend de saisir ou de sélectionner une valeur.
- Méfiez-vous des erreurs de scripting
- Étant donné que toutes les actions de collecte de données utilisent une étape de script, des erreurs potentielles peuvent se produire à partir du script. Examinez tous les scripts utilisés pour générer des variables JSON, car des erreurs de script peuvent empêcher les sorties de recevoir les valeurs JSON dont elles ont besoin. Lorsqu’une erreur de scripting de sortie dynamique se produit, le message d’avertissement suivant peut s’afficher.
Figure 1. Message affiché pour l’erreur de scripting 