---
sourceDocument: Workflows de version Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/build-workflows

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Workflows de version Xanadu

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# Étape Rechercher une étape d'enregistrement

# Étape Rechercher une étape d'enregistrement {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

Recherchez un enregistrement à partir de n'importe quelle table en fonction de conditions définies.

## Rôles et disponibilité {#lookup-record-action-designer__section_pwq_rb5_kcb}

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.

## Champs {#lookup-record-action-designer__look-up-record-fields}

{#lookup-record-action-designer__table_fdl_yhf_kcb__entry__2}

| Champ | Description |
|-|-|
| Table | Sélectionnez une table dans la liste. |
| Conditions | Définissez des conditions statiques ou dynamiques pour filtrer les enregistrements. Pour définir une condition statique appliquée à chaque exécution de l'action, définissez les conditions à l'aide du Créateur de conditions. Pour permettre aux concepteurs de flux d'appliquer dynamiquement des conditions, définissez une entrée de type Conditions et glissez-déplacez la pastille de données d'entrée dans le champ Conditions . Lors de la création d'une condition qui recherche la valeur d'un champ de référence, utilisez une pastille de données qui fournit explicitement la valeur de l'ID système. Assurez-vous que la condition a le format suivant : \[champ de référence\]\[est\]\[pastille de données de type référence-\>ID système\]. Par exemple, les tables Changement et Incident contiennent toutes deux un champ de référence à la table Utilisateur. Pour rechercher des enregistrements de changement où le demandeur est l'appelant à partir d'un enregistrement d'incident, créez la condition \[Demandé par\]\[est\]\[Déclencheur-\>enregistrement d'incident-\>Appelant-\>ID système\]. \[Demandé par\]\[est\]\[action-\>incident-\>Caller-\>Sys ID\] où incident est une variable d'entrée pour un enregistrement d'incident. |
| Trier par | Détermine comment trier les résultats lorsque plusieurs enregistrements correspondent aux conditions définies. Sélectionnez le champ que vous souhaitez utiliser pour trier les résultats. |
| Type de tri | Choisissez si vous souhaitez trier par ordre alphabétique par ordre croissant ou décroissant. |
| Si plusieurs enregistrements sont trouvés | Détermine ce qui est renvoyé si plusieurs enregistrements correspondent aux conditions définies. * Renvoyer uniquement le premier enregistrement * Échec de l'étape {#lookup-record-action-designer__ul_x5p_kkf_kcb} |
| Ne pas échouer sur l'erreur | Détermine s'il y a lieu d'échouer le flux si un enregistrement est introuvable. |
[ ]

{#lookup-record-action-designer__table_fdl_yhf_kcb}

## Sorties {#lookup-record-action-designer__section_ldx_pyb_pmb}

Ces résultats apparaissent dans le panneau de données. Vous pouvez les utiliser comme entrées ailleurs dans votre flux.{#lookup-record-action-designer__outputs-description}

Enregistrement
:   Type de données : Record

    Enregistrement trouvé en fonction des conditions que vous avez spécifiées dans l'entrée Conditions .

Table
:   Type de données : Table

    Nom de la table associée à l'enregistrement renvoyé.

Statut
:   Type de données : Choice

    1 si un enregistrement a été trouvé avec succès et 0 s'il y a eu une erreur.

Message d'erreur
:   Type de données : String

    Message contenant des détails sur la raison pour laquelle l'enregistrement n'a pas pu être trouvé.

    Remarque :  
    La valeur de cette sortie n'est renseignée que si la valeur de la Status sortie est 0.

## Évaluation de l'erreur d'action {#lookup-record-action-designer__id_lg2_4s3_15b}

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 ou le message de l'étape pour une condition d'erreur d'action personnalisée, reportez-vous à la section [Évaluation de l'erreur d'action](https://servicenow-prod.fluidtopics.net/SNatNVS0fhu8Ex212Wqh4w "Activez les actions pour intercepter les échecs d’étape et continuer à s’exécuter. Identifiez quand des conditions d’erreur spécifiques se produisent et renvoyez votre propre code de statut d’action, message d’état et état d’erreur.").

## Exemple {#lookup-record-action-designer__section_qyb_w35_kcb}