Action 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’action Studio de workflow ServiceNow de base. Les utilisateurs disposant du rôle flow_designer ou administrateur peuvent ajouter une action à un flux et définir les détails de la configuration.

Entrées

Fournissez une valeur pour chaque entrée dont votre flux 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’action peut renvoyer.

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 l’action.

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.

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 flux. 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’action. Plus vous pouvez fournir de conditions spécifiques, meilleures sont les performances de votre flux.

Rechercher les éléments de configuration affectés à un utilisateur de demande de changement

Dans cet exemple, le flux démarre lorsqu’une demande de changement urgent est ouverte dans la catégorie Réseau. L’action Rechercher des enregistrements utilise la table Élément de configuration [cmdb_ci] comme entrée de table. L’entrée Conditions recherche les éléments de configuration affectés au demandeur de la demande de changement. L’entrée Trier par utilise le champ Nom pour effectuer un tri de type alphabétique croissant.

Dans les détails de l’exécution, la sortie Nombre affiche trois éléments de configuration qui sont affectés au demandeur de la demande de changement. La sortie Enregistrements affiche les éléments de configuration par nom dans la page des détails d’exécution, mais la pastille de données contient une série de valeurs d’ID système. La sortie de la table correspond à la table Configuration Item (Élément de configuration) [cmdb_ci].