Étape Rechercher une étape d'enregistrement
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 Concepteur d'action . 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 fois que l’action s’exécute, définissez les conditions avec le créateur de condition. Pour permettre aux concepteurs de flux d’appliquer dynamiquement les 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 est au format [champ de référence][est][pastille de données de type de référence->ID système]. Par exemple, les tables Changement et Incident contiennent un champ de référence à la table Utilisateur. Pour rechercher des enregistrements de changement dans lesquels 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 | Indiquez si vous souhaitez effectuer un tri 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.
|
| Ne pas échouer sur l'erreur | Détermine s’il faut faire é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 en cas d’erreur.
- Message d'erreur
- Type de données : String
Message contenant des détails sur la raison pour laquelle l’enregistrement est introuvable.
Remarque :La valeur de cette sortie n’est remplie que si la valeur de la Status sortie est 0.
Champs d’évaluation des erreurs d’action
| Champ | Description |
|---|---|
| En cas d'échec de cette étape | 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 à Évaluation de l’erreur d’action. |