Formato dei messaggi in uscita per le sottoscrizioni di eventi
Con il rilascio di Adobe Workfront 2017.3, il formato dei messaggi in uscita per gli abbonamenti agli eventi verrà modificato per consentire prestazioni migliori e un utilizzo migliore degli abbonamenti agli eventi per le integrazioni.
Aggiornamenti al formato dei messaggi in uscita
Le seguenti modifiche verranno apportate al formato dei messaggi in uscita:
-
I messaggi in uscita includono oldState e newState per una risorsa Workfront.
Questi valori mostrano le modifiche apportate a un oggetto a seguito di un evento in Workfront.
-
Il campo di metadati eventTime verrà aggiunto a tutti i messaggi in uscita.
Questo campo indica, in Nanosecondi ed EpochSeconds, il momento in cui si è verificato un evento. Utilizza eventTime per ordinare gli eventi elaborati dall’integrazione.
-
Il campo proprietario:companyID a cui si fa riferimento nella risorsa NOTE verrà rimosso.
-
L'oggetto a cui si fa riferimento currentVersionNella risorsa DOCU (Document) verrà rimosso.
Se al momento utilizzi gli abbonamenti agli eventi di Workfront, dovrai aggiornare le integrazioni Workfront prima della versione 2017.3 per tenere conto di queste modifiche.
Per ulteriori informazioni sugli abbonamenti agli eventi, consulta API di abbonamento agli eventi.
Esempi di formati vecchi e nuovi
Il seguente messaggio di vecchio formato CREATE non verrà più utilizzato dopo il rilascio di 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": {}
}
}
Dopo il rilascio della versione 2017.3 verrà utilizzato il nuovo messaggio CREATE nel formato seguente:
{
"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": {}
Il seguente messaggio UPDATE (AGGIORNAMENTO precedente formato) non verrà più utilizzato dopo il rilascio della versione 2017.3 di:
{
"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": {}
}
}
Dopo la versione 2017.3 verrà utilizzato il seguente messaggio UPDATE:
{
"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": {}
}
}