Verwenden der API zum Synchronisieren von Daten für Programme und Dienste

Dies sind einige gängige Methoden, mit denen Sie die API zum Synchronisieren von Daten für Programme und Dienste verwenden können.

Nahezu alle Echtzeitaktualisierungen

Adobe Workfront verwendet "Ereignisabos"(auch häufig als Webhooks bezeichnet), um über die API nahezu Echtzeitaktualisierungen zu unterstützten Objekten und Aktionen an Ihren gewünschten Endpunkt bzw. Ihre gewünschten Endpunkte zu senden. Sie können innerhalb von 5 Sekunden mit einer Aktualisierung neuer Objekte und Aktionen rechnen, aber im Durchschnitt werden Aktualisierungen in etwa 1 Sekunde angezeigt. Weitere Informationen dazu, welche Objekttypen unterstützt werden, welche Aktionstypen unterstützt werden, technische Details und Beispiele zum Einrichten von Ereignisanmeldungen finden Sie unter Ereignisabonnement-API und Versandanforderungen für Ereignisabschlüsse.

Batch-Aktualisierungen

Mit Batch-Aktualisierungen können Sie Ihr System für Aktualisierungen konfigurieren, indem Sie regelmäßige Anfragen an Workfront-Server richten. Es gibt viele Möglichkeiten, dies zu tun. Im Allgemeinen besteht der Prozess jedoch darin, dass Ihr Dienst eine Anfrage an die Workfront-API-Server sendet und nach Objekten sucht, die seit dem letzten Anfrageaufruf erstellt oder geändert wurden. Informationen zu potenziellen Anforderungsaufrufen und hilfreichen Parametern finden Sie unter Verhalten der GET aus dem API-Grundlagen Artikel.

Beachten Sie beim Einrichten Ihres Dienstes für Batch-Aktualisierungen Folgendes:

Eintrittstage

Einstiegsdaten werden im ISO 8601-Format gespeichert. Dieser Standard umfasst Informationen zu Datum, Uhrzeit und Zeitzone.

Beispiel: Datumsformat nach ISO 8601

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

Sowohl das Datum, an dem ein Objekt erstellt wird, als auch das Datum, an dem das Objekt zuletzt geändert wurde, werden als "entryDate"bzw. "lastUpdateDate"gespeichert. Detaillierte Informationen zu Workfront-Objekten, den zugehörigen Feldern und Feldnamen finden Sie in der API-Explorer. Beachten Sie, dass sich das entryDate für ein bestimmtes Workfront-Objekt nicht ändert, wobei sich lastUpdatedDate jedes Mal ändert, wenn das Objekt geändert wird.

Beispiel: GET-Anfrage für ein Problemobjekt unter Verwendung der lastUpdateDate -Feld. Diese Anfrage gibt alle Probleme zurück, die seit dem angegebenen Datum aktualisiert wurden.

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

Journaleintragsobjekt

Wenn Sie Änderungen an einem bestimmten Feld eines Objekts erhalten möchten, können Sie das Objekt "Journaleintrag"abfragen. Das Workfront Journal Entry-Objekt kann so eingerichtet werden, dass bei jeder Änderung dieser Felder Informationen zu bestimmten Objektfeldern protokolliert werden, siehe Systemaktualisierungen konfigurieren für weitere Details.

Wenn ein Feld so eingerichtet ist, dass es als Teil des Journaleintragsobjekts protokolliert wird, wird bei jeder Änderung dieses Felds ein entsprechender Journaleintrag erstellt. Anschließend können Sie das Journaleintragsobjekt mithilfe eines API-Aufrufs abfragen, der dem folgenden ähnelt:

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