Étape Rechercher une étape d'enregistrement
Rechercher 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 avec le générateur de conditions. Pour permettre aux concepteurs de flux d’appliquer des conditions dynamiquement, 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 [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 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 [Requested by][is][Trigger->incident record->Caller->Sys ID]. [Demandé par][est][action->incident->Appelant->ID système] 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 | Sélectionnez s’il faut 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.
|
| 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 s’il y a eu une erreur.
- Message d'erreur
- Type de données : String
Message contenant des détails sur les raisons pour lesquelles l’enregistrement est introuvable.
Remarque :La valeur de cette sortie n’est renseignée que si la valeur de sortie Status est de 0.
Évaluation des erreurs 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 d’étape ou le message pour une condition d’erreur d’action personnalisée, reportez-vous à la section Évaluation de l’erreur d’action.