Tracking von Stundenkatalogen mit der Adobe Workfront-API
Wenn Ihr Unternehmen Adobe Workfront verwendet, um Arbeitsstunden einzugeben, aber ein anderes Tool als Datensatzsystem für diese Daten verwendet, können Sie die Workfront-API verwenden, um Daten zwischen den beiden Systemen zu synchronisieren.
Das einfache Tracking des Stundendatensatzes ist nicht möglich, da bei Entfernung des Stundeneintrags der gesamte Datensatz gelöscht wird. Dazu müssen Sie den gesamten Datensatz abrufen und ihn mit dem alten Datensatz vergleichen. Glücklicherweise werden alle Stundentransaktionen in Workfront Journal Entries aufgezeichnet.
Nachdem Sie einen ersten Satz aller aktuellen Stunden im System abgerufen haben, können Sie alle Änderungen über die Journaleinträge verfolgen.
GET /attask/api/v5.0/JRNLE/search?subObjCode=HOUR&fields=changeType,aux2,newNumberVal,oldNumberVal,subObjCode,subObjID
{
"data": [
{
"ID": "5785406d008d93dd35665f14d90d4929",
"objCode": "JRNLE",
"changeType": "A",
"aux2": "Brad Littler",
"newNumberVal": 1,
"oldNumberVal": null,
"subObjCode": "STUNDE",
"subObjID": "5785406d008d93dce3f7f2e0e8eda4ea"
},
{
"ID": "57854124008da2b9f372c01f8b9054bf",
"objCode": "JRNLE",
"changeType": "D",
"aux2": "Brad Littler",
"newNumberVal": null,
"oldNumberVal": 1,
"subObjCode": "STUNDE",
"subObjID": "5785406d008d93dce3f7f2e0e8eda4ea"
},
{
"ID": "5785416f008db05ecee934663a968366",
"objCode": "JRNLE",
"changeType": "A",
"aux2": "Brad Littler",
"newNumberVal": 1,
"oldNumberVal": null,
"subObjCode": "STUNDE",
"subObjID": "5785416f008db05d9d2925c12b10f521"
},
{
"ID": "57854176008db22fe974b7c67feea6b2",
"objCode": "JRNLE",
"changeType": "E",
"aux2": "Brad Littler",
"newNumberVal": 2,
"oldNumberVal": 1,
"subObjCode": "STUNDE",
"subObjID": "5785416f008db05d9d2925c12b10f521"
}
]
}
Im Folgenden finden Sie eine Beschreibung der enthaltenen Felder:
-
changeType: Die Art der Objektänderung:
-
A: Hinzufügen
-
E: Bearbeiten
-
D: Löschen
-
-
aux2: Der Name des Benutzers, für den der Stundendatensatz gilt.
-
newNumberVal: Neuer Wert des Stundendatensatzes (dieser Wert ist null, wenn changeType D ist).
-
oldNumberVal: Vorheriger Wert des Stundendatensatzes.
-
subObjCode: Typ des zu ändernden Datensatzes (Sollte immer HOUR sein).
-
subObjID: Kennung des Stundendatensatzes.
Anhand dieser Informationen können Sie ermitteln, welche Stundendatensätze geändert, bearbeitet oder gelöscht wurden. Sie können dann die subObjID verwenden, um bei Bedarf weitere Informationen aus den Stundendatensätzen abzurufen.