Entrées dynamiques
Générez une liste d’entrées d’action ou de valeurs d’entrée chaque fois qu’une personne configure l’action dans un flux. Les entrées dynamiques peuvent afficher une liste d’entrées d’action 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 Concepteur de flux, vous devez Demander un Hub d'intégration module d'extension.
Lors de 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 de type Entrées dynamiques rassemble une liste d’entrées d’action supplémentaires à afficher. Utilisez des 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 des champs 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 à 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 comporte 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 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.
Lignes directrices 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 récupèrent dynamiquement les 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 Concepteur de flux, 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 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 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 scripting. 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 script 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.
- Limiter 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 jusqu’à 5 000 options de liste de choix, et un modèle dynamique ne peut afficher que jusqu’à 5 000 valeurs de modèle de champ. 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 qu’elle renvoie à 5 000. La limite de 5 000 éléments de tableau empêche l’instance de rencontrer des problèmes de performances lors du rendu des choix ou des valeurs de champ.