Déclencheur instantáneos (webhooks) en Adobe Workfront Fusion
Muchos servicios proporcionan webhooks para entregar notificaciones instantáneas cada vez que se produce un determinado cambio en el servicio. Para procesar estas notificaciones, le recomendamos que utilice déclencheur instantáneos. Puede reconocerlos fácilmente en Adobe Workfront Fusion debido a su etiqueta:
Si el servicio no proporciona webhooks, usted necesita utilizar déclencheur de sondeo para sondear periódicamente el servicio.
Para ver un vídeo introductorio a los webhooks en Workfront Fusion, consulte:
Requisitos de acceso
Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:
Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.
Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.
Ver la cola de un gancho web
Todos los mensajes de los webhooks entrantes se almacenan en la cola del webhook.
-
Haz clic en Webhooks en el menú de la izquierda.
-
Busque el webhook para el que desea ver la cola.
-
Haga clic en el botón con un icono de camión y el número de webhooks recibidos.
note note NOTE Los datos del gancho web entrante siempre se almacenan en la cola, independientemente de cómo haya establecido la opción Datos, que es confidencial (se describe en El panel de configuración de escenario en Adobe Workfront Fusion). Tan pronto como los datos se procesan en un escenario, se eliminan del sistema de forma permanente.
Programar déclencheur instantáneos
Si el escenario contiene un déclencheur instantáneo, puede programar su ejecución inmediata:
En este caso, su escenario se ejecutará inmediatamente cuando Workfront Fusion reciba nuevos datos del servicio. Una vez que se ejecuta el escenario, se cuenta la cantidad total de webhooks pendientes que esperan en la cola y el escenario realiza tantos ciclos como webhooks pendientes, procesando un webhook por ciclo. Para obtener más información, vea Ejecución de escenarios, ciclos y fases en Adobe Workfront Fusion.
-
Un ciclo no es lo mismo que una ejecución de escenario. Puede haber varios ciclos en 1 escenario ejecutado.
-
Cuando se ejecuta un escenario con un déclencheur instantáneo programado para ser inmediato, se aplican las siguientes excepciones:
-
El intervalo entre dos ejecuciones no está sujeto al intervalo mínimo según el plan de precios.
Por ejemplo, una vez que el escenario termina de ejecutarse, la cola del gancho web se vuelve a comprobar. Si hay algún webhooks pendiente, el escenario se ejecuta inmediatamente de nuevo, procesando todos los webhooks pendientes una vez más.
-
La configuración del escenario Número máximo de ciclos se ignora y se establece en 100, lo que significa que no se procesarán más de 100 webhooks pendientes durante una sola ejecución de escenario (a razón de 1 evento por cada ciclo).
-
Si usa cualquier otra configuración de programación distinta de Inmediatamente, el escenario se ejecutará a los intervalos especificados. Como se pueden reunir varios enlaces web en la cola durante el intervalo, se recomienda establecer el Número máximo de ciclos en un valor mayor que el predeterminado 1 para procesar más enlaces web en una ejecución de escenario:
- Haga clic en el icono Configuración de escenario
- En el cuadro Configuración de escenario que aparece, escriba un número en el cuadro Número máximo de ciclos para indicar el número de enlaces web de la cola que desea ejecutar cada vez que ejecute el escenario.
Límites de velocidad
El límite de velocidad actual es de 5 webhooks por segundo. Si se supera el límite, se devuelve un código de estado 429.
Caducidad de webhooks inactivos
Se elimina un webhook que no haya sido asignado a ningún escenario por más de 120 horas.
Cargas útiles de Webhook
Workfront Fusion almacena cargas útiles de ganchos web durante 30 días. Acceder a una carga útil de gancho web más de 30 días después de crearla provoca el error "No se pudo leer el archivo desde el almacenamiento."
Control de errores
Cuando hay un error en su escenario con un déclencheur instantáneo, el escenario:
- Se detiene inmediatamente cuando el escenario está configurado para ejecutarse Inmediatamente.
- Se detiene después de tres intentos fallidos (tres errores): cuando el escenario está configurado para ejecutarse según lo programado.
Si se produce un error durante la ejecución del escenario, el gancho web se vuelve a colocar en la cola durante la fase de reversión del déclencheur instantáneo. En tal situación, tiene la posibilidad de corregir el escenario y volver a ejecutarlo. Para obtener más información, vea Reversión en el artículo Ejecución de escenarios, ciclos y fases en Adobe Workfront Fusion.
Si hay un módulo de respuesta de webhook en su escenario, el error se envía a la respuesta de webhook. El módulo de respuesta Webhook siempre se ejecuta en último lugar (en caso de que la opción Confirmación automática en la configuración de Escenario no esté habilitada). Para obtener más información, consulte Respuesta a los webhooks en el artículo Webhooks.
Webhooks personalizados
Puede crear sus propios webhooks. Para obtener más información, consulte Webhooks.
Desactivación de webhook
Los webhooks se desactivan automáticamente si se aplica cualquiera de las siguientes opciones:
- El webhook no ha estado conectado a ningún escenario durante más de 5 días
- El webhook solo se utiliza en escenarios inactivos, que han estado inactivos durante más de 30 días.
Los webhooks desactivados se borran y no se registran automáticamente si no están conectados a ningún escenario y han estado en estado desactivado durante más de 30 días.