Utiliser l’API pour synchroniser les données des programmes et services

Il s’agit de méthodes courantes permettant d’utiliser l’API pour synchroniser les données des programmes et services.

Mises à jour en temps quasi réel

Adobe Workfront utilise des « abonnements aux événements » (également appelés « webhooks ») pour envoyer des mises à jour en temps quasi réel sur les objets et les actions pris en charge, via l’API, au(x) point(s) d’entrée souhaité(s). Le délai de mise à jour des nouveaux objets et actions est de 5 secondes, mais en moyenne, les mises à jour sont effectuées en 1 seconde environ. Pour plus d’informations sur les types d’objets et d’actions pris en charge, les détails techniques et les exemples de mise en place d’abonnements aux événements, consultez les sections API d’abonnement aux événements et Exigences de diffusion de l’abonnement aux événements.

Mises à jour par lots

Les mises à jour par lots vous permettent de configurer votre système pour effectuer des mises à jour en envoyant périodiquement des requêtes aux serveurs Workfront. Il existe diverses méthodes pour y parvenir, mais en général, le processus implique de demander à votre service d’envoyer une requête aux serveurs API de Workfront et de rechercher les objets créés ou modifiés depuis le dernier appel de requête. Pour plus d’informations sur les appels de requêtes potentiels et les paramètres utiles, consultez la section Comportement des GET dans l’article Principes de base des API.

À mesure que vous configurez votre service pour les mises à jour par lots, voici quelques points importants à garder à l’esprit :

Dates d’entrée

Les dates d’entrée sont stockées en utilisant le formatage ISO 8601. Cette norme inclut des informations sur la date, l’heure et le fuseau horaire.

Exemple : format de date ISO 8601

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

La date de création d’un objet est enregistrée sous la forme « entryDate », tandis que la date de dernière modification de l’objet est enregistrée sous la forme « lastUpdateDate ». Pour obtenir des informations détaillées sur les objets Workfront, les champs qui leur sont affectés et les noms des champs, veuillez consulter la section Explorateur d’API. Remarquez que la entryDate d’un objet Workfront donné ne change pas, alors que la lastUpdatedDate change chaque fois que l’objet est modifié.

Exemple : requête GET pour un objet problème, utilisant le champ lastUpdateDate. Cette requête renvoie tous les problèmes mis à jour depuis cette date spécifiée.

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

Objet « Entrée du journal »

Pour obtenir des modifications concernant un champ spécifique d’un objet, vous pouvez consulter l’objet « Entrée du journal ». L’objet « Entrée du journal Workfront » peut être configuré pour consigner des informations sur des champs d’objet spécifiques chaque fois que ces champs sont modifiés. Pour plus d’informations, consultez la section Configurer les mises à jour du système.

Lorsqu’un champ est configuré pour être enregistré en tant qu’objet « Entrée du journal », une entrée du journal correspondante est créée chaque fois que ce champ est modifié. Vous pouvez ensuite interroger l’objet « Entrée du journal » à l’aide d’un appel API comme suit :

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