É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
Renseignez chaque entrée nécessaire pour votre action. 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 et valeurs de champ que vous souhaitez utiliser pour rechercher des enregistrements. Pour utiliser un script en ligne afin de spécifier des conditions, envisagez d’utiliser les classes GlideRecord et GlideQueryCondition pour créer votre requête. Consultez GlideRecord - Global et GlideQueryCondition - Global.
- 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 de tri par ordre alphabétique 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 de l’erreur d’action.
Sorties
Ces résultats apparaissent dans le panneau de 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
Utilisez 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 d’enregistrements. Pour plus d’informations sur l’utilisation de la logique de flux For Each, reportez-vous à la section Pour chaque logique de flux. Vous pouvez également utiliser une étape de 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.
- Utiliser 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.