Déclencheurs instantanés (webhooks) dans Adobe Workfront Fusion
De nombreux services fournissent des webhooks pour envoyer des notifications instantanées lorsqu’une modification spécifique se produit dans le service. Pour traiter ces notifications, nous vous recommandons d’utiliser des déclencheurs instantanés. Vous pouvez facilement les reconnaître dans Adobe Workfront Fusion à cause de leur balise :
Si le service ne fournit pas de webhooks, vous devez utiliser des triggers d’interrogation pour interroger régulièrement le service.
Pour une vidéo d’introduction aux webhooks dans Workfront Fusion, voir :
Exigences d’accès
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
Pour connaître le plan, le type de licence ou l’accès dont vous disposez, contactez votre Workfront administrateur.
Pour plus d’informations sur Adobe Workfront Fusion licences, voir Adobe Workfront Fusion licences.
Affichage de la file d’attente d’un webhook
Tous les messages des webhooks entrants sont stockés dans la file d’attente du webhook.
-
Cliquez sur Webhooks dans le menu de gauche.
-
Recherchez le webhook pour lequel vous souhaitez afficher la file d’attente.
-
Cliquez sur le bouton avec une icône de camion et le nombre de webhooks reçus.
note note NOTE Les données de webhook entrantes sont toujours stockées dans la file d’attente, quelle que soit la manière dont vous avez défini l’option. Données est confidentiel (décrit dans Le panneau des paramètres de scénario dans Adobe Workfront Fusion). Dès que les données sont traitées dans un scénario, elles sont définitivement supprimées du système.
Planification de déclencheurs instantanés
Si votre scénario contient un déclencheur instantané, vous pouvez planifier son exécution immédiate :
Dans ce cas, votre scénario s’exécute immédiatement lorsque Workfront Fusion reçoit de nouvelles données du service. Une fois le scénario exécuté, le nombre total de webhooks en attente dans la file d’attente est comptabilisé et le scénario exécute autant de cycles que les webhooks en attente, en traitant un webhook par cycle. Pour plus d’informations, voir Exécution, cycles et phases d’un scénario Adobe Workfront Fusion.
-
Un cycle n’est pas la même chose qu’une exécution de scénario. Il peut y avoir plusieurs cycles dans un scénario exécuté.
-
Lorsque vous exécutez un scénario avec un déclencheur instantané programmé pour être immédiat, les exceptions suivantes s’appliquent :
-
L’intervalle entre deux exécutions n’est pas soumis à l’intervalle minimum conformément au plan de tarification.
Par exemple, une fois l’exécution du scénario terminée, la file d’attente du webhook est de nouveau vérifiée. S’il existe des webhooks en attente, le scénario s’exécute à nouveau immédiatement, en traitant à nouveau tous les webhooks en attente.
-
Le paramètre de scénario Nombre maximum de cycles est ignoré et défini sur 100, ce qui signifie qu’aucun plus de 100 webhooks en attente ne sera traité lors d’une seule exécution de scénario (à la vitesse d’1 événement par cycle).
-
Si vous utilisez un autre paramètre de planification que Immédiatement, le scénario s’exécute aux intervalles que vous spécifiez. Comme plusieurs webhooks peuvent être rassemblés dans la file d’attente pendant l’intervalle, il est recommandé de définir la variable Nombre maximum de cycles à une valeur supérieure à la valeur par défaut 1 pour traiter plus de webhooks dans un scénario exécuté :
- Cliquez sur le bouton Paramètres du scénario icon
- Dans le Paramètres du scénario qui s’affiche, saisissez un nombre dans la zone Nombre max. de cycles pour indiquer le nombre de webhooks de la file d’attente que vous souhaitez exécuter chaque fois que vous exécutez le scénario.
Limites de taux
La limite de taux actuelle est de 5 webhooks par seconde. Si la limite est dépassée, un code d’état 429 est renvoyé.
Expiration des webhooks inactifs
Un webhook qui n’a été affecté à aucun scénario pendant plus de 120 heures est supprimé.
Payloads Webhook
Workfront Fusion stocke les charges utiles webhook pendant 30 jours. L’accès à une payload webhook plus de 30 jours après sa création entraîne l’erreur "Échec de la lecture du fichier à partir du stockage."
Gestion des erreurs
En cas d’erreur dans votre scénario avec un déclencheur instantané, le scénario :
- S’arrête immédiatement lorsque le scénario est défini pour s’exécuter. Immédiatement.
- S’arrête après 3 tentatives infructueuses (3 erreurs) : lorsque le scénario est défini pour s’exécuter comme prévu.
Si une erreur se produit lors de l’exécution du scénario, le webhook est placé à nouveau dans la file d’attente lors de la phase de restauration du déclencheur instantané. Dans une telle situation, vous avez la possibilité de corriger le scénario et de le réexécuter. Pour plus d’informations, voir Retour arrière dans l’article Exécution, cycles et phases d’un scénario Adobe Workfront Fusion.
Si votre scénario comporte un module de réponse Webhook, l’erreur est envoyée à la réponse Webhook. Le module de réponse Webhook est toujours exécuté en dernier (dans le cas où la variable Validation automatique dans les paramètres du scénario n’est pas activée). Pour plus d’informations, voir Réponse aux webhooks dans l’article Webhooks.
Webhooks personnalisés
Vous pouvez créer vos propres webhooks. Pour plus d’informations, voir Webhooks.
Désactivation de Webhook
Les webhooks sont désactivés automatiquement si l’une des conditions suivantes s’applique :
- Le webhook n’est connecté à aucun scénario depuis plus de 5 jours.
- Le webhook est utilisé uniquement dans les scénarios inactifs, qui sont inactifs depuis plus de 30 jours.
Les webhooks désactivés sont supprimés et désenregistrés automatiquement s’ils ne sont connectés à aucun scénario et sont à l’état désactivé depuis plus de 30 jours.