De API gebruiken om gegevens voor programma's en services te synchroniseren

Dit zijn enkele algemene manieren waarop u de API kunt gebruiken om gegevens voor programma's en services te synchroniseren.

Bijna real-time updates

Adobe Workfront gebruikt "Event Subscriptions" (ook wel webhooks genoemd) om updates in real time over ondersteunde objecten en acties via de API naar het gewenste eindpunt of de gewenste eindpunten te verzenden. U kunt een update voor nieuwe objecten en acties verwachten binnen 5 seconden, maar de updates zijn gemiddeld over ongeveer 1 seconde beschikbaar. Voor meer informatie over welk type objecten wordt ondersteund, welke typen acties worden ondersteund, technische details en voorbeelden van hoe u gebeurtenisabonnementen kunt instellen, raadpleegt u API voor abonnementen voor gebeurtenissen en Vereisten voor levering van abonnementen.

Batchupdates

Updates in batch zijn een manier om uw systeem te configureren voor updates door periodieke aanvragen naar Workfront-servers uit te voeren. Er zijn veel manieren om dit te doen, maar over het algemeen bestaat het proces uit het hebben van uw dienst een verzoek aan de servers van Workfront API en het zoeken naar voorwerpen die sinds de laatste verzoekvraag zijn gecreeerd of gewijzigd. Voor informatie over potentiële verzoeken en nuttige parameters gelieve te zien gelieve Gedrag van GET van de Basisbeginselen van API artikel.

Aangezien u opstelling uw dienst voor batch-updates bent zijn een paar belangrijke dingen om in mening te houden:

Invoerdatums

Invoerdatums worden opgeslagen met ISO 8601-opmaak. Deze standaard bevat gegevens over datum, tijd en tijdzone.

Voorbeeld: Datumnotatie ISO 8601

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

Zowel de datum waarop een object is gemaakt als de laatste datum waarop het object is gewijzigd, worden opgeslagen als respectievelijk "entryDate" en "lastUpdateDate". Voor uitgebreide informatie over Workfront-objecten, de bijbehorende velden en veldnamen raadpleegt u de API Explorer. De entryDate voor een bepaald Workfront-object verandert niet, waarbij de lastUpdatedDate telkens wanneer het object wordt gewijzigd, verandert.

Voorbeeld: GET-aanvraag voor een uitgaveobject, met gebruik van de lastUpdateDate veld. Dit verzoek retourneert alle problemen die sinds die opgegeven datum zijn bijgewerkt.

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

Object Dagboekinvoer

Als u wijzigingen met betrekking tot een specifiek veld op een object wilt verkrijgen, kunt u het object Journal Entry opvragen. Het Workfront Journal Entry-object kan zo worden ingesteld dat informatie over specifieke objectvelden wordt geregistreerd wanneer deze velden worden gewijzigd, zie Systeemupdates configureren voor meer informatie.

Wanneer een gebied opstelling is om als deel van het voorwerp van de Ingang van het Dagboek worden geregistreerd zal een overeenkomstige Ingang van het Dagboek worden gecreeerd telkens als dat gebied wordt gewijzigd. Dan, kunt u het voorwerp van de Ingang van het Dagboek vragen gebruikend een API vraag gelijkend op het volgende:

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