De API gebruiken om gegevens voor programma's en services te synchroniseren
Gemaakt voor:
- Ontwikkelaar
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 extra informatie over welk type van voorwerpen worden gesteund, welke types van acties, technische details, en voorbeelden voor hoe te de abonnementen van de opstellingsgebeurtenis zien {de Abonnement API van 0} Gebeurtenis 🔗 en de leveringsvereisten van het Abonnement van de Gebeurtenis.
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 verzoekvraag en nuttige parameters gelieve te zien de 🔗 sectie van het Gedrag van de GET {van de API basisbeginselenartikel.
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: ISO 8601 datumformaat
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 diepgaande informatie over de voorwerpen van Workfront, hun bijbehorende gebieden, en gebiedsnamen, gelieve te zien API Ontdekkingsreiziger. De entryDate voor een bepaald Workfront-object verandert niet, waarbij de lastUpdatedDate telkens wanneer het object wordt gewijzigd, verandert.
Voorbeeld: GET verzoek voor een uitgiftobject, die het lastUpdateDate gebied gebruikt. 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 voorwerp van de Ingang van het Dagboek van Workfront kan opstelling zijn om informatie over specifieke objecten gebieden te registreren wanneer die gebieden worden gewijzigd, zie systeemupdatesvoor extra details vormen.
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
NOTE