Entrées dynamiques
Générez une liste d’entrées d’actions ou de valeurs d’entrée chaque fois que quelqu’un configure l’action dans un flux. Les entrées dynamiques peuvent afficher une liste d’entrées d’actions connexes, une liste des champs d’un enregistrement ou une liste d’options disponibles dans une liste de choix.
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.
Pendant la conception du flux, les entrées dynamiques récupèrent des valeurs et les affichent dynamiquement en tant qu’entrées au sein d’une action. Ces types d’entrées dynamiques sont disponibles pour les auteurs d’actions.
- Choix dynamique
- L’entrée Type de choix dynamique rassemble une liste de valeurs de choix à afficher. Pour plus d’informations sur la création d’un choix dynamique, consultez Créer une action de collecte de données pour un choix dynamique.
- Entrées dynamiques
- L’entrée Type d’entrées dynamiques rassemble une liste d’entrées d’action supplémentaires à afficher. Utilisez les entrées dynamiques pour ajouter des entrées arbitraires à une action. Pour plus d’informations sur la création d’entrées dynamiques, reportez-vous à la section Créer une action de collecte de données pour une entrée de type d’entrées dynamiques.
- Modèle dynamique
- L’entrée Type de modèle dynamique rassemble une liste de champs à partir d’un type d’enregistrement sélectionné dynamiquement. Les auteurs de flux peuvent ensuite sélectionner les champs à inclure dans leur flux. Étant donné que la liste des champs est générée dynamiquement, vous n’avez pas besoin de modifier l’action lorsque des champs sont ajoutés ou supprimés de la table source. Pour plus d’informations sur la création d’un modèle dynamique, consultez Créer une action de collecte de données pour un modèle dynamique.
L’utilisation des entrées dynamiques se fait en trois étapes générales.
- Un auteur d’action crée une action de collecte de données pour générer des données dynamiques.
- Un auteur d’action crée une action avec une entrée dynamique et configure l’entrée dynamique pour appeler l’action de collecte de données.
- Un auteur de flux ajoute l’action à un flux et configure l’action avec des données collectées dynamiquement.
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.
Directives générales
- Prendre en compte les entrées dynamiques pour les intégrations tierces
- Les entrées dynamiques vous permettent de créer des flux qui extraient dynamiquement des données à partir de sources externes. Dans les intégrations tierces, les entrées dynamiques peuvent fournir des valeurs de données relatives à un point de terminaison particulier. Pour plus d’informations sur la configuration d’intégrations tierces avec Studio de workflow, consultez Centre d’intégration.
- Être conscient du temps nécessaire pour récupérer de grandes quantités de données
- Par défaut, les entrées dynamiques disposent de 300 secondes pour collecter des données avant d’expirer. 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 plus élevée. Toutefois, n’utilisez pas de valeurs de délai d’expiration long pour les flux interactifs dans lesquels un utilisateur final doit saisir ou 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. Lorsque vous utilisez des scripts pour générer des variables JSON pour vos entrées dynamiques, vous pouvez rencontrer des erreurs qui empêchent les entrées de recevoir les valeurs JSON dont elles ont besoin. Lorsqu’une erreur de scripting d’entrée dynamique se produit, le message d’avertissement suivant peut s’afficher.
Figure 1. Message affiché pour l’erreur de scripting 
- Limiter les entrées de type entrées dynamiques à 40 valeurs d’entrée
- Une entrée de type entrées dynamiques ne peut restituer qu’un certain nombre d’entrées avant que l’objet JSON ne devienne trop volumineux pour être stocké en mémoire. En limitant vos entrées dynamiques à 40 valeurs d’entrée, vous minimisez les risques de manquer de mémoire et de rencontrer des comportements inattendus tels que des erreurs de rendu ou la troncature des données.
- Limitez la sortie JSON à 5 000 éléments de tableau pour les modèles dynamiques et les choix dynamiques
- Les entrées de choix dynamique et de modèle dynamique ne peuvent afficher que jusqu’à 5 000 éléments de tableau. Un choix dynamique ne peut afficher que 5 000 options de liste de choix maximum, tandis qu’un modèle dynamique ne peut afficher que 5 000 valeurs de modèle de champ maximum. Si votre action de collecte de données collecte des données pour un modèle dynamique ou un choix dynamique, limitez le nombre maximal d’éléments de tableau renvoyé à 5 000. La limite de 5 000 éléments de tableau empêche l’instance d’avoir des problèmes de performances lors du rendu des choix ou des valeurs de champ.