Utgående meddelandeformat för händelseprenumerationer
I och med Adobe Workfront 2017.3 kommer formatet för utgående meddelanden för händelseprenumerationer att ändras för att ge bättre prestanda och bättre användning av händelseprenumerationer för dina integreringar.
Uppdateringar av det utgående meddelandeformatet
Följande ändringar kommer att göras i det utgående meddelandeformatet:
-
Utgående meddelanden kommer att innehålla oldState och newState för en Workfront-resurs.
Dessa värden visar de ändringar som har gjorts i ett objekt som ett resultat av en händelse i Workfront.
-
Metadatafältet eventTime läggs till i alla utgående meddelanden.
I det här fältet anges, i nanosekunder och EpochSeconds, den tidpunkt då en händelse inträffade. Använd eventTime när du beställer händelser som bearbetas av integreringen.
-
Fältet owner:companyID som refereras på NOTE-resursen tas bort.
-
Refererat objectOn-objektet för aktuell version på DOCU-resursen (dokumentet) tas bort.
Om du för närvarande prenumererar på Workfront-event måste du uppdatera dina Workfront-integreringar före version 2017.3 för att kunna ta hänsyn till dessa ändringar.
Mer information om händelseprenumerationer finns i API för händelseprenumeration.
Exempel på gamla och nya meddelandeformat
Följande gamla CREATE-meddelande kommer inte längre att användas efter 2017.3:
{
"eventType": "CREATE",
"subscriptionId": "8a0d839d5ef32c9a015ef33064b00001",
"fields": {
"ID": "59d7db3c0000014b05536251b669a3e4",
"name": "EventSub Test 53350c27-ce58-40e9-af75-a2d45ff13046",
"objCode": "PROJ",
"entryDate": "2017-10-06T13:36:28.722-0600",
"accessorIDs": ["544820df0000142362741fc0c368de19"],
"lastUpdateDate": "2017-10-06T13:36:28.785-0600",
"groupID": "544820df0000140f6a9c1faa7cacadd3",
"sponsorID": null,
"description": null,
"plannedCompletionDate": "2017-10-06T09:00:00.000-0600",
"enteredByID": "544820df0000142362741fc0c368de19",
"ownerID": "544820df0000142362741fc0c368de19",
"templateID": null,
"priority": 0,
"companyID": null,
"portfolioID": null,
"referenceNumber": 1891,
"lastUpdatedByID": "544820df0000142362741fc0c368de19",
"customerID": "544820df0000135b7719dcca654391f6",
"currency": null,
"categoryID": null,
"status": "CUR",
"parameterValues": {}
}
}
Följande nya CREATE-meddelande kommer att användas efter 2017.3:
{
"eventType": "CREATE",
"subscriptionId": "8a0d839d5ef32c9a015ef32e2cde0000",
"eventTime": {
"nano": 414000000,
"epochSecond": 1507318444
},
"newState": {
"ID": "59d7daab0000011b8faebf0f60d25d08",
"name": "EventSub Test 3700e224-0ef7-4571-b200-09109712152c",
"objCode": "PROJ",
"entryDate": "2017-10-06T13:34:03.562-0600",
"accessorIDs": ["544820df0000142362741fc0c368de19"],
"lastUpdateDate": "2017-10-06T13:34:04.000-0600",
"groupID": "544820df0000140f6a9c1faa7cacadd3",
"sponsorID": null,
"description": null,
"plannedCompletionDate": "2017-10-06T09:00:00.000-0600",
"enteredByID": "544820df0000142362741fc0c368de19",
"ownerID": "544820df0000142362741fc0c368de19",
"templateID": null,
"priority": 0,
"companyID": null,
"portfolioID": null,
"referenceNumber": 1890,
"lastUpdatedByID": "544820df0000142362741fc0c368de19",
"customerID": "544820df0000135b7719dcca654391f6",
"currency": null,
"categoryID": null,
"status": "CUR",
"parameterValues": {}
},
"oldState": {}
Följande UPDATE-meddelande i gammalt format kommer inte längre att användas efter 2017.3:
{
"eventType": "UPDATE",
"subscriptionId": "8a0d839d5ef32c9a015ef336a5ed0002",
"fields": {
"ID": "59d7dcde000001b2330bda8ac63fee16",
"name": "EventSub Test updated",
"objCode": "PROJ",
"entryDate": "2017-10-06T13:43:26.305-0600",<
"accessorIDs": [
"544820df0000142362741fc0c368de19"
],
"lastUpdateDate": "2017-10-06T13:43:49.265-0600",
"groupID": "544820df0000140f6a9c1faa7cacadd3",
"sponsorID": null,
"description": null,
"plannedCompletionDate": "2017-10-06T09:00:00.000-0600",
"enteredByID": "544820df0000142362741fc0c368de19",
"ownerID": "544820df0000142362741fc0c368de19",
"templateID": null,
"priority": 0,
"companyID": null,
"portfolioID": null,
"referenceNumber": 1892,
"lastUpdatedByID": "544820df0000142362741fc0c368de19",
"customerID": "544820df0000135b7719dcca654391f6",
"currency": null,
"categoryID": null,
"status": "CUR",
"parameterValues": {}
}
}
Följande UPDATE-meddelande med nytt format kommer att användas efter 2017.3:
{
"eventType": "UPDATE",
"subscriptionId": "8a0d839d5ef32c9a015ef336a5ed0002",
"eventTime": {
"nano": 998000000,
"epochSecond": 1507319336
},
"newState": {
"ID": "59d7ddf7000002322d791eb08bafddfb",
"name": "EventSub Test updated",
"objCode": "PROJ",
"entryDate": "2017-10-06T13:48:07.776-0600",
"accessorIDs": [
"544820df0000142362741fc0c368de19"
],
"lastUpdateDate": "2017-10-06T13:48:56.980-0600",
"groupID": "544820df0000140f6a9c1faa7cacadd3",
"sponsorID": null,
"description": null,
"plannedCompletionDate": "2017-10-06T09:00:00.000-0600",
"enteredByID": "544820df0000142362741fc0c368de19",
"ownerID": "544820df0000142362741fc0c368de19",
"templateID": null,
"priority": 0,
"companyID": null,
"portfolioID": null,
"referenceNumber": 1894,
"lastUpdatedByID": "544820df0000142362741fc0c368de19",
"customerID": "544820df0000135b7719dcca654391f6",
"currency": null,
"categoryID": null,
"status": "CUR",
"parameterValues": {}
},
"oldState": {
"ID": "59d7ddf7000002322d791eb08bafddfb",
"name": "EventSub Test 180fd595-63fb-4fa9-bd47-58bf6e53d964",
"objCode": "PROJ",
"entryDate": "2017-10-06T13:48:07.776-0600",
"accessorIDs": [
"544820df0000142362741fc0c368de19"
],
"lastUpdateDate": "2017-10-06T13:48:07.792-0600",
"groupID": "544820df0000140f6a9c1faa7cacadd3",
"sponsorID": null,
"description": null,
"plannedCompletionDate": "2017-10-06T09:00:00.000-0600",
"enteredByID": "544820df0000142362741fc0c368de19",
"ownerID": "544820df0000142362741fc0c368de19"
"templateID": null,
"priority": 0,
"companyID": null,
"portfolioID": null,
"referenceNumber": 1894,
"lastUpdatedByID": "544820df0000142362741fc0c368de19",
"customerID": "544820df0000135b7719dcca654391f6",
"currency": null,
"categoryID": null,
"status": "CUR",
"parameterValues": {}
}
}