Étape Rechercher une étape d'enregistrement

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • Recherchez un enregistrement à partir de n’importe quelle table en fonction 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.

    Champs

    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]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
    Ne pas échouer sur l'erreur Détermine s’il y a lieu d’échouer le flux si un enregistrement est introuvable.

    Sorties

    Ces résultats apparaissent dans le panneau de données. Vous pouvez les utiliser comme entrées ailleurs dans votre flux.

    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

    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.

    Exemple

    Exemple d’étape Rechercher une étape d’enregistrement dans une action.