Synkronisera data för program och tjänster med API:t

Detta är några vanliga sätt för dig att använda API:t för att synkronisera data för program och tjänster.

Nära realtidsuppdateringar

Adobe Workfront använder"Event Subscriptions" (även kallat webhooks) för att skicka nästan realtidsuppdateringar om objekt och åtgärder som stöds via API:n till önskad slutpunkt. Du kan förvänta dig en uppdatering om nya objekt och åtgärder inom 5 sekunder, men i genomsnitt kommer uppdateringar om cirka 1 sekund. Mer information om vilka typer av objekt som stöds finns i Event Subscription API och Event Subscription delivery requirements.

Batchuppdateringar

Batchuppdateringar är ett sätt att konfigurera systemet för uppdateringar genom att göra regelbundna förfrågningar till Workfront-servrar. Det finns många sätt att göra detta, men i allmänhet består processen av att låta tjänsten göra en begäran till Workfront API-servrar och söka efter objekt som har skapats eller ändrats sedan den senaste anropet. Mer information om möjliga anrop och användbara parametrar finns i avsnittet GET Behavior i artikeln API basics .

När du konfigurerar tjänsten för batchuppdateringar här är några viktiga saker att tänka på:

Anmälningsdatum

Anmälningsdatum lagras med ISO 8601-formatering. Den här standarden innehåller datum-, tids- och tidszonsinformation.

Exempel: ISO 8601-datumformat

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

Både datumet då ett objekt skapas och det senaste datumet som objektet ändrades lagras som "entryDate" respektive "lastUpdateDate". Mer information om Workfront-objekt, deras associerade fält och fältnamn finns i API-utforskaren. Observera att entryDate för ett givet Workfront-objekt inte ändras där lastUpdatedDate ändras varje gång objektet ändras.

Exempel: GET-förfrågan för ett problemobjekt, med hjälp av fältet lastUpdateDate. Denna begäran returnerar alla utgåvor som har uppdaterats sedan det angivna datumet.

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

Journalpostobjekt

Om du är intresserad av att få ändringar som rör ett specifikt fält i ett objekt kan du skicka en fråga till objektet Journalpost. Workfront Journal Entry-objektet kan konfigureras för att logga information om specifika objektfält när dessa fält ändras. Mer information finns i Konfigurera systemuppdateringar .

När ett fält har konfigurerats för att loggas som en del av journaltransaktionsobjektet skapas en motsvarande journalpost varje gång fältet ändras. Sedan kan du fråga efter objektet Journal Entry med hjälp av ett API-anrop som ser ut ungefär så här:

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