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 principale. Les utilisateurs disposant du rôle flow_designer ou admin 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 de données ou les sélectionner à partir du sélecteur de pastilles.

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 pour 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 permettant de trier 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’action peut renvoyer.

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’enregistrement trouvés en fonction des critères de recherche que vous avez fournis. Pour plus d’informations, consultez Enregistrements. Table] type de données.

Table

Type de données : Table Name

Table contenant la liste des enregistrements.

Nombre

Type de données : Integer

Nombre d’enregistrements que l’action a retournés.

Directives générales

Suivez ces instructions générales lorsque vous utilisez l’action Rechercher des enregistrements.

Traiter les enregistrements avec la logique de flux Pour chaque

Utilisez la logique de flux For Each pour parcourir 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.

Définir les 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 Table. L’entrée Conditions recherche les éléments de configuration affectés au demandeur de la demande de changement. L’entrée Ordre 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 affectés au demandeur de la demande de changement. La sortie Enregistrements affiche les éléments de configuration par nom dans la page de détails de l’exécution, mais la pastille de données contient une série de valeurs d’ID système. La sortie de table est la table d’éléments de configuration [cmdb_ci].