Création de flux

Déclencheurs

Chaque type de déclencheur définit quand un flux démarre et les données de démarrage disponibles pour celui-ci. Il existe des déclencheurs pour les opérations d’enregistrement, les dates et les opérations d’application.

Concepteur de flux prend en charge les types de déclencheurs basés sur les enregistrements, les calendriers et les applications. Pour plus d'informations, consultez Concepteur de flux Types de déclencheurs.

Actions

Dans Actions, les concepteurs de flux peuvent ajouter des actions, une logique de flux et des flux secondaires à un flux.

Les actions sont des éléments réutilisables qui exécutent des opérations reproductibles. Ajoutez une action à un flux en ouvrant le sélecteur d’actions. Configurez une action en spécifiant ses valeurs d’entrée, qui peuvent être des données provenant du déclencheur de flux ou la sortie d’autres actions. Saisissez des valeurs pour les entrées directement ou utilisez les données du panneau de données pour configurer les entrées d’une action. Au début d’un flux, les données peuvent être limitées au déclencheur de flux ou aux entrées de flux secondaire. Lorsque vous ajoutez des actions à un flux, les valeurs de sortie de chaque action s’affichent sous forme de pastilles de données dans le panneau de données.

Sélecteur d’actions: Dans la section ACTION d’un flux, sélectionnez Ajouter une action, une logique de flux ou un flux secondaire > Action pour ouvrir le sélecteur d’actions. Vous pouvez saisir du texte dans la fenêtre de recherche pour rechercher une action, ou parcourir les catégories d’actions pour trouver une action que vous souhaitez ajouter à votre flux.
Numérotation des actions: Des nombres séquentiels apparaissent en regard de chaque élément de l’interface Concepteur de flux . Les numéros d’actions commencent par 1, puis augmentent de 1 à mesure que vous ajoutez des éléments au flux.
Remarque :
Si vous avez effectué une mise à niveau à partir d’une version antérieure, vos scripts en ligne peuvent toujours contenir des références à la numérotation des actions de flux héritées. Consultez Numérotation des actions de flux pour mettre à jour automatiquement ces références pour votre flux.
Actions principales: Votre instance est fournie avec une collection d’actions de base, ou d’opérations fréquemment utilisées Now Platform , qui peuvent être ajoutées à n’importe quel flux.
Actions du spoke: Certaines applications incluent des spokes qui ajoutent des actions spécifiques à l’application. Les actions de spoke sont généralement en lecture seule, mais peuvent être copiées et personnalisées.
Actions personnalisées: Les développeurs peuvent également créer leurs actions personnalisées à partir de l’interface Concepteur d'action .

Limite d’action

Par défaut, les flux ne peuvent pas comporter plus de 50 actions. Pour modifier le comportement par défaut, augmentez la valeur de la sn_flow_designer.max_actions propriété système. Toutefois, tenez compte de l’impact qu’un flux volumineux peut avoir sur les performances de votre instance.

Actions manquantes

Si un administrateur a ajouté votre flux à partir d’un ensemble de mises à jour, il se peut que certaines actions soient manquantes dans votre flux. Cela se produit normalement lorsque les spokes appropriés Hub d'intégration ne sont pas installés sur votre instance. Pour plus d’informations sur l’installation des spokes dont vous avez besoin pour faire apparaître ces actions, consultez Spokes.

Panneau de données

Les flux stockent toutes les données collectées ou générées sous forme de variables dans le panneau de données. Chaque variable a sa propre pastille que les concepteurs de flux peuvent utiliser pour faire glisser la valeur de la variable vers une entrée ou une sortie d’action. Concepteur de flux Génère le nom de la pastille en fonction du contenu et de son type de données. Le système spécifie le type de données de variable en regard de la pilule.

Plus de menu Actions

Sélectionnez l’icône Actions supplémentaires ( ) pour accéder à des options supplémentaires pour votre flux.

Étapes: Accéder aux étapes d’un flux.
Gérer les variables de catalogue de flux: Gérez les variables de catalogue disponibles pour les flux déclenchés par Service Catalog.
Variables de flux: Créez des variables de flux pour définir et récupérer des données tout au long d’un flux.
Copier des flux: Créez une copie du flux ouvert dans une application de votre choix.
Préférences de flux: Activez ou désactivez les options de basculement Afficher les actions de brouillon, Afficher les flux déclenchés, Afficher les spokes de la boutique et Afficher le script en ligne .
Créer un extrait de code: Générez un extrait de code pour appeler un flux, un flux secondaire ou une action spécifique.
Gestion de la sécurité: Activez ou désactivez l’option Pouvant être appelé par l’API client .
Modifier le titre du flux par défaut: Modifiez le titre par défaut de votre flux en ajoutant du texte stylisé ou dynamique. Pour plus d’informations, consultez Créer un titre en langage naturel.

Flux de test

Vous pouvez tester un flux directement depuis l’interface Concepteur de flux . Chaque test exécute votre flux comme si les conditions de déclenchement étaient remplies. Si le flux a un déclencheur d’enregistrement, vous pouvez spécifier l’enregistrement à utiliser pour votre test. Une fois le flux exécuté, utilisez les détails d’exécution du flux pour vérifier que votre flux s’exécute correctement.

Important :

Exécutez toujours des tests sur une instance de non-production où les modifications apportées à l’enregistrement de flux ne peuvent pas interférer avec vos données de production.

Détails d'exécution du flux

Chaque fois que vous testez un flux, le système génère des enregistrements d’exécution de flux, des messages de journal et des rapports. Le contexte de flux est un enregistrement connexe contenant les valeurs d’état actuel et d’exécution du flux. Le système génère un enregistrement de contexte chaque fois qu’un flux est exécuté.

Vous pouvez éventuellement configurer le système pour générer des détails d’exécution chaque fois qu’un flux est exécuté, et pas seulement pendant les tests. Pour plus d'informations, consultez Activer la génération de rapports de flux.

Propriétés du flux

Les propriétés de flux contiennent des informations sur votre flux. Dans l’en-tête principal, sélectionnez Propriétés pour afficher ou modifier les propriétés de votre flux.


Propriété	Description
Nom	Entrez un nom unique pour le flux
Protection	Choisir si le flux est en lecture seule en choisissant entre Aucun ou Lecture seule
Application	Sélectionnez une application pour le flux. Cette propriété est définie lors de la création du flux et ne peut pas être modifiée par la suite.
Description	Entrez une description du flux.
Exécuter en tant que	Option que vous pouvez sélectionner pour spécifier que le flux s'exécute en tant qu'utilisateur système ou en tant qu'utilisateur qui initie la session. Sélectionnez l’utilisateur qui lance l’option de session lorsque les mises à jour doivent provenir de l’utilisateur qui a déclenché le flux. Par exemple, utilisez cette option si vous souhaitez que les commentaires d’enregistrement d’incident proviennent de l’utilisateur actuel ou si vous souhaitez que les e-mails d’approbation proviennent de l’approbateur. Les paramètres de l’option Exécuter en tant que dans un flux ne s’appliquent pas aux flux secondaires enfants. Pour créer un flux qui peut s’exécuter avec un jeton OAuth personnel, sélectionnez l’utilisateur qui lance l’option de session. Si l’utilisateur qui exécute le flux dispose d’un jeton OAuth personnel, le flux s’exécute avec ce jeton. Pour plus d’informations sur la création d’un jeton OAuth personnel, consultez Informations d’identification OAuth 2.0.
Exécuter avec le(s) rôle(s)	Rôles avec lesquels le flux s'exécute. Cette option n’est disponible que lorsque l’option Exécuter en tant que est définie sur l’utilisateur qui lance la session.

Flux d’impression

Concepteur de flux prend en charge l’impression multipage pour les flux, les flux secondaires, les actions et les détails d’exécution du flux. Pour obtenir la liste des navigateurs pris en charge, reportez-vous à la section Prise en charge des navigateurs.

Rôles

Pour accéder à Flux, un utilisateur doit avoir les rôles flow_designer ou admin.

Lignes directrices générales

Les flux doivent être des collections d’œuvres courtes, modulaires et réutilisables. S’ils prennent plus d’une heure à exécuter, ils sont probablement trop longs et peuvent être plus efficaces.

Toutes les directives générales qui s’appliquent aux flux s’appliquent également aux flux secondaires.

Empêcher les logiques métier conflictuelles ou dupliquées

Les automatisations peuvent être créées avec Flow Designer, les règles métier, les workflows et le concentrateur d’intégration. Avant de commencer à utiliser Concepteur de flux, assurez-vous de bien comprendre le fonctionnement des automatisations existantes Now Platform . Désactivez les automatisations avant de les remplacer par Concepteur de flux des flux et des actions. Reportez-vous à la Vue d’ensemble de l’architecture section pour en savoir plus Concepteur de flux sur le fonctionnement dans le Now Platformfichier .

Passez en revue la documentation sur les flux, les flux secondaires et les actions , si nécessaire.

Déterminez si votre flux a besoin d’un déclencheur ou d’une entrée variable

Les flux s’exécutent toujours lorsque leurs conditions de déclenchement sont remplies. Les déclencheurs fournissent toujours les mêmes données que l’entrée pour les flux. Si vous avez besoin d’une entrée variable pour lancer un flux, créez un flux secondaire.

Réutiliser la logique métier

Créez un ensemble d’opérations réutilisables en tant que flux secondaire pouvant ensuite être utilisé dans plusieurs flux.

Accorder des rôles de flux pour accéder aux données protégées par les rôles et préserver les informations utilisateur

Les rôles de flux simplifient les autorisations pour vos flux. Utilisez des rôles de flux pour préserver les informations des utilisateurs et accorder l’accès aux données, au lieu d’exécuter un flux en tant qu’utilisateur système. L’ajout de rôles de flux donne également accès à des données supplémentaires qu’un flux initié par l’utilisateur n’a généralement pas. Les rôles accordés s’appliquent uniquement au flux. Elles ne s’appliquent pas à l’utilisateur qui a initié le flux.

Utiliser une logique de flux ou un déclencheur basé sur une planification pour contrôler la synchronisation du flux

La logique de flux ou les déclencheurs basés sur la planification permettent d’optimiser les performances de vos flux. N’utilisez pas la méthode gs.sleep() pour patienter dans un flux. La méthode gs.sleep() empêche le thread d’effectuer d’autres tâches. Pour exécuter un flux à une heure spécifique, utilisez un déclencheur basé sur une planification. Pour mettre en pause un flux pendant une durée spécifique, utilisez la logique de flux Attendre pendant une durée ou attendre une condition .

Éviter les dépendances

Les branches parallèles qui dépendent les unes des autres bloquent un flux lorsqu’une branche doit attendre la sortie d’une autre branche.

Compteurs de boucles de champ d’application

Les boucles de script n’ayant pas un nombre maximum d’itérations, les boucles s’exécutent donc en continu lorsqu’il n’y a pas de condition de sortie valide.

Pour vous assurer qu’il existe une condition de sortie valide, utilisez des compteurs de boucles de champ d’application dans les scripts en ligne ou dans les étapes de script au sein d’une action. Ajouter var àpour (i=0 ; i< longueur ; i++) et obtenir pour (var i=0 ; i< longueur ; i++)

Limite pour chaque et Faire jusqu’à boucle jusqu’à 1 000 itérations

Les itérations avec 1000 boucles ou plus peuvent entraîner des problèmes de mémoire.

Définissez le nombre maximal d’enregistrements lors de l’action Rechercher des enregistrements sur 1 000.
Évitez de modifier la propriété sn_flow_designer.max_iterations, qui est définie par défaut sur 1000.
Pour les grandes quantités de données traitées, envisagez le traitement par lots en lots plus petits.
Pour les importations en vrac, envisagez des importations simultanées.

Utiliser QuickAPI pour des exécutions plus rapides (alternative de règle métier)

Les exécutions de QuickAPI sont beaucoup plus rapides, mais il y a moins de capacité de débogage.
Les exécutions QuickAPI de premier plan s’exécutent dans la session utilisateur en tant qu’utilisateur qui a appelé le flux.
Les exécutions QuickAPI en arrière-plan s’exécutent dans un thread en arrière-plan et sont exécutées dans la session utilisateur « système ».

Utiliser les boucles Exécuter jusqu’à au lieu d’appeler des flux à partir d’eux-mêmes

Un flux s’appelant lui-même n’est pas autorisé et les erreurs sont présentes. Mais si le flux A appelle le flux B, alors le flux B peut appeler le flux A jusqu’à trois fois.

Exécuter des flux en arrière-plan

L’exécution des flux en arrière-plan permet de libérer des threads d’interface utilisateur plutôt que de laisser les utilisateurs attendre les exécutions de flux.

Éviter la logique de flux qui attend après la collecte d’une sortie volumineuse

L’utilisation d’une charge utile volumineuse immédiatement après sa récupération peut aider à éviter les problèmes de mémoire.

Minimisez l’envoûtement entre lesenvironnements

Le basculement constant entre les étapes d’instance et de MID Server dans un flux peut entraîner des retards de traitement. Pour minimiser les risques de retards, limitez le basculement entre l’instance et le MID Server à une seule fois.

Inclure les enregistrements sys_complex_object générés par le flux dans les ensembles de mises à jour

Des schémas de données complexes manquants peuvent entraîner des problèmes d’exécution. Assurez-vous d’inclure les enregistrements sys_complex_object générés par le flux dans les ensembles de mises à jour.

Appeler des flux à partir d’un script

Démarrez des flux avec un déclencheur personnalisé en appelant à partir d’un script.

Éviter de déployer des flux de mise en production plus récents sur des instances de versions antérieures

Concepteur de flux ne prend pas en charge le déploiement de flux sur des instances exécutées sur des versions antérieures. Parfois, le modèle de données du flux change entre les mises en production, ce qui peut empêcher l’exécution du flux ou produire des résultats inattendus.

Désactiver la génération de rapports de flux en production

Réduisez la quantité de mémoire requise pour exécuter les flux en désactivant la génération de rapports de flux. Les rapports de flux stockent les informations de configuration et d’exécution de la page Détails de l’exécution. Ces rapports sont utiles au dépannage, mais nécessitent la conservation d’une grande quantité de données à la fois en mémoire et dans la base de données. Par défaut, la génération de rapports de flux est désactivée et le système génère uniquement les détails d’exécution lorsque vous testez manuellement un flux ou une action. Au lieu de cela, vous pouvez utiliser des fichiers journaux, qui sont toujours disponibles lorsque la génération de rapports est désactivée.

Réduire la quantité de mémoire consommée dans les flux grâce aux boucles imbriquées

Lorsque la génération de rapports est activée, définissez com.snc.process_flow.reporting.iteration.lastn sur la valeur « 1 » pour réduire les quantités de mémoire consommées par les itérations de boucle précédentes. Plus vous signalez d’itérations, plus vous avez besoin de mémoire.