Si erreur

Cette fonction vous permet de spécifier des actions alternatives pour gérer une erreur sans arrêter votre flux.

La fonction Si erreur apparaît comme un conteneur dans un flux où vous pouvez spécifier les options suivantes :

Essai : exécutez une ou plusieurs actions ou fonctions.
Si erreur : spécifier des actions ou fonctions alternatives à exécuter si une erreur survient dans l'une des étapes de la section Essayer.
Sorties : le flux peut utiliser les champs de sortie facultatifs dans les étapes suivantes. La valeur attribuée à chaque sortie dépend de la survenue ou non d'une erreur.

Utilisez le menu déroulant pour basculer entre les étapes Essayer et les étapes Si erreur.

Essai

Lorsque vous ajoutez un nouveau conteneur Si erreur à un flux, vous devez d'abord définir les étapes dans la section Essayer. Ces étapes se composent d'une ou de plusieurs actions ou fonctions à exécuter. Vous pouvez ajouter des cartes à ce conteneur comme vous le feriez ailleurs dans un flux.

Conseil :

Pour ajouter la gestion des erreurs à un ensemble d'étapes existant dans votre flux, insérez la carte Si erreur dans le flux après les cartes que vous souhaitez dans votre bloc Essayer. Puis faites glisser les cartes existantes une par une, en commençant par la carte la plus à droite.

Pour réessayer automatiquement une étape de votre flux avant de corriger manuellement une erreur, voir Définir la gestion des erreurs pour les cartes dans les flux.

Si erreur

Si bloc Si erreur contient les étapes que vous souhaitez effectuer pour gérer une erreur. Vous pouvez ajouter des actions ou des fonctions comme vous le feriez ailleurs dans un flux.

ATTENTION :

Pour éviter les erreurs d'analyse causées par une gestion d'erreurs complexe, Okta recommande de ne pas dépasser trois blocs Si erreur imbriqués.

Un objet d'erreur est ajouté à chaque bloc Si erreur. Cet objet contient les détails suivants de l'erreur dans le bloc Essai qui entraîne un passage au bloc Si erreur :

message : texte du message d'erreur, le cas échéant.
code : code d'erreur, par exemple, 500.
method : ID de l'étape où l'erreur s'est produite.
flo : ID du flux.
execution : ID d'une exécution spécifique du flux. Vous pouvez utiliser ces valeurs dans vos étapes de gestion des erreurs. Par exemple, vous pouvez envoyer un e-mail avec les détails de l'erreur. Ou, s'il s'agit d'une erreur attendue, vérifiez conditionnellement si le flux doit continuer.

ATTENTION :

Les cartes Retour et Continuer si mettent généralement fin à un flux mais se comportent différemment lorsqu'elles sont à l'intérieur d'un bloc Essayer ou Si erreur. Considérez les blocs Essayer ou Si erreur comme des flux d'aide anonymes. Tout comme lorsque vous appelez un flux d'aide, une carte Retour vous ramène au parent. Ainsi, l'ajout d'une carte Retour ou Continuer si (lorsque false) à l'intérieur d'un bloc Essayer ou Si erreur passe à l'étape immédiatement après le conteneur Si erreur.

Si vous souhaitez arrêter le flux plutôt que de continuer, utilisez une carte Return Error, Return Error If ou Continue if en dehors du bloc Si erreur.

Sorties

Vous pouvez faire glisser les sorties des cartes qui s'exécutent avant la fonction Si erreur dans un bloc Essayer ou Si erreur. Cependant, vous ne pouvez pas faire glisser les sorties de l'intérieur du bloc Essayer ou Si erreur vers des cartes exécutées après la fonction Si erreur. Cela est dû au fait qu'une étape à l'intérieur d'un bloc Essayer ou Si erreur ne s'exécute pas toujours. Pour éviter cela, utilisez la fonctionnalité facultative Sorties.

Pour accéder aux sorties, cliquez sur Afficher les sorties en haut à droite du conteneur Si erreur. Cela ouvre un volet à droite des blocs Essayer et Si erreur.
Cliquez pour ajouter une sortie. Vous pouvez saisir le nom et choisir le type. Deux nouveaux champs apparaissent sous chaque sortie.
Faites glisser une sortie du bloc Essayer vers l'un de ces champs. Cette sortie est utilisée lorsqu'aucune erreur ne survient.
Faites glisser une sortie du bloc Si erreur vers l'autre champ. Cette sortie est utilisée lorsqu'une erreur survient.

Vous pouvez ensuite mapper les sorties de ce volet vers les étapes suivantes du flux.