Étape Rechercher des enregistrements
Recherchez des enregistrements multiples sur n’importe quelle table à l’aide de conditions définies.
Rôles et disponibilité
Disponible en tant qu’étape d’action Studio de workflow . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d’action.
Entrées
Fournissez une valeur pour chaque entrée dont votre action a besoin. Pour ajouter des valeurs dynamiques, vous pouvez également faire glisser des pastilles à partir du panneau Données ou les sélectionner dans le sélecteur de pilules.
- Table
- Type de données : Table Name
Nom de la table contenant les enregistrements que vous souhaitez rechercher.
- Conditions
- Type de données : Conditions
Noms de champs et valeurs de champ que vous souhaitez utiliser pour rechercher des enregistrements. Pour utiliser un script en ligne afin de spécifier les conditions, envisagez d’utiliser les classes GlideRecord et GlideQueryCondition pour créer votre requête. Consultez et .
- Trier par
- Type de données : Field Name
Champ que vous souhaitez utiliser pour trier les résultats.
- Type de tri
- Type de données : Choice
Option permettant de trier par ordre alphabétique par ordre croissant ou décroissant.
- Nombre maximal de résultats
- Type de données : Integer
Nombre maximal de résultats d’enregistrement que l’étape peut renvoyer.
Évaluation des erreurs d’action
- En cas d'échec de cette étape
- Type de données : Choice
Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Pour utiliser le code d’état d’étape ou le message pour une condition d’erreur d’action personnalisée, reportez-vous à la section Évaluation des erreurs d’action.
Sorties
Ces sorties apparaissent dans le panneau Données. Vous pouvez les utiliser comme entrées ailleurs dans votre flux.
- Enregistrements
- Type de données : Records
Liste des ID système d’enregistrements trouvés en fonction des critères de recherche que vous avez fournis. Pour plus d’informations, voir Enregistrements.[ table].
- Table
- Type de données : Table Name
Table contenant la liste des enregistrements.
- Nombre
- Type de données : Integer
Nombre d’enregistrements renvoyés par cette étape.
Directives générales
Suivez ces instructions générales lorsque vous utilisez l’action Rechercher des enregistrements.
- Traiter les enregistrements avec une logique de flux Pour chaque
- Utilisez la logique de flux Pour chaque afin d’itérer dans une liste des enregistrements. Pour plus d’informations sur l’utilisation de la logique de flux Pour chaque, consultez Logique de flux Pour chaque. Vous pouvez également utiliser une étape Script pour traiter une liste d’enregistrements dans une action personnalisée.
- Définir des résultats maximaux pour améliorer les performances
- Définissez l’entrée Nombre maximal de résultats sur 1 000 enregistrements ou moins pour améliorer les performances de votre action. Plus le système doit rechercher d’enregistrements, plus il faut de ressources système pour les identifier et les traiter.
- Utilisez des conditions pour filtrer les enregistrements
- Utilisez des conditions pour limiter le nombre d’enregistrements renvoyés par l’étape. Plus vous pouvez fournir de conditions spécifiques, meilleures sont les performances de votre action.