Sorties dynamiques
Accédez aux sorties d’action et de flux secondaire en tant que 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’objets Now Platform complexes.
Remarque :
Les sorties dynamiques ne sont pas disponibles dans le système de base. Pour utiliser des sorties dynamiques dans Concepteur de flux, 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 Concepteur de flux:
- Un designer 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 parente à 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 que d’ê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 a 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 de script formate la sortie JSON pour qu’elle ait 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 designers d’actions construisent la structure de l’objet dynamiquement 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.
Lignes directrices 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 Concepteur de flux, 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 les données avant que le système ne les arrête. Si votre action de collecte de données a besoin de 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 dans lesquels 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 scripting. 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 script de sortie dynamique se produit, le message d’avertissement suivant peut apparaître.
Figure 1. Message affiché pour l’erreur de scripting 