La tâche Approbation vous permet de configurer des intégrations basées sur l'approbation. Elle vous permet également de contrôler le flux d'une intégration.
Vous pouvez utiliser la tâche Approbation pour envoyer des e-mails de demande d'approbation à un ou plusieurs utilisateurs d'intégration. L'e-mail inclut un lien vers l'intégration où les utilisateurs peuvent approuver ou rejeter manuellement la demande.
Lors de l'exécution d'une intégration, lorsque le contrôle atteint la tâche Approbation, l'exécution est interrompue et toutes les tâches après la tâche Approbation sont suspendues. L'intégration reprend uniquement lorsqu'un utilisateur approuve ou refuse manuellement la demande d'approbation.
Une tâche Approbation peut être utilisée aux fins suivantes :
- Suspendre et intégrer une intégration en fonction de l'approbation ou du refus de l'utilisateur
- Pour suspendre une intégration jusqu'à une durée spécifiée.
- À utiliser comme point d'arrêt pour déboguer l'intégration.
Comparer les opérations Approbation, Suspendre et Minuteur
Les trois tâches (Approbation, Suspendre et Minuteur) exécutent une fonction similaire de mise en pause et de reprise d'une intégration. Toutefois, il existe des différences subtiles entre elles. Le tableau suivant décrit les différences entre les trois tâches.
| Tâche Approbation | Tâche Suspendre | Tâche Minuteur |
|---|---|---|
| N'est pas compatible avec la reprise automatique d'une intégration et nécessite une intervention manuelle pour reprendre l'intégration. | Compatible avec la reprise manuelle et automatique d'une intégration. En l'absence d'une intervention manuelle pour révoquer la suspension, l'intégration reprend automatiquement l'exécution après l'expiration du délai de suspension. | Compatible uniquement avec la reprise automatique d'une intégration. L'exécution de l'intégration reprend automatiquement après l'expiration du délai de suspension. |
| Impossible de reprendre une intégration via un appel d'API. Vous devez résoudre manuellement la suspension à l'aide de l'interface utilisateur Apigee Integration. | Peut reprendre une intégration à l'aide de l'API Suspensions pour les intégrations. |
Compatible uniquement avec la reprise automatique d'une intégration. |
| Les utilisateurs reçoivent une notification lorsqu'une intégration est mise en pause (suspendue). | Les utilisateurs ne reçoivent aucune notification lorsqu'une intégration est mise en pause (suspendue). | Les utilisateurs ne reçoivent aucune notification lorsqu'une intégration est mise en pause (suspendue). |
Compatible avec une variable de sortie (booléenne), qui vous permet d'effectuer des vérifications conditionnelles avant de reprendre l'intégration. Cependant, la variable de sortie ne peut avoir que la valeur true ou false. |
Compatible avec une variable de sortie (chaîne), qui vous permet d'effectuer des vérifications conditionnelles avant de reprendre l'intégration. Vous pouvez définir n'importe quelle valeur pour la variable de sortie. | Non compatible avec les variables de sortie. |
Configurer la tâche Approbation
Pour configurer la tâche Approbation, procédez comme suit :
- Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
- Cliquez sur Développer > Intégrations.
- Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.
Si vous créez une intégration :
- Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
- Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
- Cliquez sur Créer.
La page de conception d'intégration s'affiche.
- Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Tâches pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément de tâche Approbation et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément de tâche Approbation dans le concepteur pour afficher le volet de configuration de la tâche Approbation.
- Configurez les champs affichés à l'aide des propriétés de configuration de la tâche, comme indiqué dans le tableau ci-dessous.
Les modifications que vous avez apportées aux propriétés sont enregistrées automatiquement.
Propriétés de configuration
Le tableau suivant décrit les propriétés de configuration de la tâche Approbation.
| Propriété | Type de données | Description |
Recipients
|
Tableau de chaînes | Adresses e-mail auxquelles la notification est envoyée lorsque la tâche est suspendue. Saisissez plusieurs adresses e-mail séparées par une virgule. |
Custom notification message
|
Chaîne | Message personnalisé à inclure dans la notification par e-mail lorsque la tâche est suspendue. La valeur peut être un littéral ou une variable. Si le message personnalisé est disponible dans une variable, cliquez sur VAR et sélectionnez la variable.
|
Reminder frequency (in hours)
|
Entier | Fréquence des notifications de rappel.
Si la suspension est à l'état "non traitée" (unresolved), vous pouvez envoyer des notifications par e-mail afin de demander à des utilisateurs autorisés de la traiter. |
Time until expiration (in hours)
|
Entier | Période de la suspension.
Si la suspension n'est pas traitée dans les temps, elle est rejetée par défaut. |
On expiration
|
Booléen | Action à entreprendre une fois la suspension expirée.
Vous pouvez choisir de rejeter la suspension ou de la lever. Par défaut, la suspension est rejetée. |
isApproved (Approval)
|
Booléen | Variable de sortie dont l'état est la suspension après traitement.
La variable |
Stratégie de traitement des erreurs
Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.