Uso de la API para sincronizar datos de programas y servicios

Estas son algunas formas comunes de utilizar la API para sincronizar datos para programas y servicios.

Actualizaciones casi en tiempo real

Adobe Workfront utiliza "Suscripciones de eventos" (también denominadas comúnmente "webhooks") para enviar actualizaciones casi en tiempo real sobre los objetos y las acciones compatibles, a través de la API, a los puntos de conexión deseados. Puede esperar recibir una actualización con respecto a los nuevos objetos y acciones en un plazo de 5 segundos, pero las actualizaciones promedio llegan en aproximadamente 1 segundo. Para obtener información adicional sobre qué tipo de objetos se admiten, qué tipos de acciones se admiten, detalles técnicos y ejemplos sobre cómo configurar suscripciones a eventos, consulte API de suscripción a eventos y Requisitos de entrega de suscripción a eventos.

Actualizaciones por lotes

Las actualizaciones por lotes son una forma de configurar el sistema para recibir actualizaciones mediante solicitudes periódicas a los servidores de Workfront. Hay muchas formas de hacerlo, pero generalmente el proceso consiste en hacer que el servicio realice una solicitud a los servidores de la API de Workfront y en buscar objetos que se hayan creado o modificado desde la última llamada de solicitud. Para obtener información sobre posibles solicitudes, llamadas y parámetros útiles, consulte la sección Comportamiento de GET del artículo Conceptos básicos de la API.

A medida que configura el servicio para actualizaciones por lotes, hay que tener en cuenta algunos aspectos importantes:

Fechas de entrada

Las fechas de entrada se almacenan utilizando el formato ISO 8601. Este estándar incluye información de fecha, hora y zona horaria.

Ejemplo: formato de fecha ISO 8601

2020-05-18T17:00:00:000-0600

Tanto la fecha en que se crea un objeto como la última fecha en que se modificó se almacenan como "entryDate" y "lastUpdateDate", respectivamente. Para obtener información detallada acerca de objetos de Workfront, sus campos asociados y nombres de campo, consulte Explorador de API. Observe que entryDate de cualquier objeto Workfront dado no cambia, mientras que lastUpdatedDate cambia cada vez que se modifica el objeto.

Ejemplo: solicitud de GET para un objeto de problema, con el campo lastUpdateDate. Esta solicitud devolverá todos los problemas actualizados desde la fecha especificada.

GET
https://<domain>.my.workfront.com/attask/api/v15.0/OPTASK/search?fields=ID,name,lastUpdateDate&$$LIMIT=200&lastUpdateDate=2020-05-13T18:18:37.255Z&lastUpdateDate_Mod=gte

Objeto de entrada de diario

Si está interesado en obtener cambios con respecto a un campo específico en un objeto, puede consultar el objeto "Entrada de cuaderno". El objeto de entrada de diario de Workfront se puede configurar para que registre información sobre campos de objeto específicos cada vez que se modifiquen dichos campos. Para obtener más información, vea Configurar actualizaciones del sistema.

Cuando se configura un campo para que se registre como parte del objeto de entrada de cuaderno, se creará una entrada de cuaderno correspondiente cada vez que se modifique ese campo. A continuación, puede consultar el objeto Entrada de cuaderno mediante una llamada de API similar a la siguiente:

GET https://{{domain}}.my.workfront.com/attask/api/v15.0/JRNLE/search?fields=newTextVal,oldTextVal,newDateVal,oldDateVal,newNumberVal,oldNumberVal,entryDate,objObjCode,objID,fieldName&fieldName=name&objObjCode=OPTASK&entryDate=2020-05-13T18:18:37.255Z&entryDate_Mod=gte