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 :
Conditions d’accès
Pour utiliser les fonctionnalités décrites dans cet article, vous devez disposer des éléments suivants :
Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez vote administrateur ou administratrice Workfront.
Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez les 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 du webhook entrant sont toujours stockées dans la file d’attente, quelle que soit la manière dont vous avez défini l’option Data est confidentielle (décrite dans Le panneau des paramètres du 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 de scénario, cycles et phases dans 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 regroupés dans la file d’attente pendant l’intervalle, il est recommandé de définir le nombre maximum de cycles sur une valeur supérieure à la valeur par défaut 1 pour traiter plus de webhooks dans un scénario exécuté :
- Cliquez sur l’icône Paramètres du scénario
- Dans la zone 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 payloads de webhook pendant 30 jours. L’accès à une payload de 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 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 Restauration dans l’article Exécution de scénario, cycles et phases dans 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ù l’option Validation automatique dans les paramètres du scénario n’est pas activée). Pour plus d’informations, voir Réponse à 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 (inactifs depuis plus de 30 jours).
Les webhooks désactivés sont supprimés et désinscrits automatiquement s’ils ne sont connectés à aucun scénario et s’ils sont restés désactivés pendant plus de 30 jours.