Formato de mensagem de saída para assinaturas de evento
Com o lançamento do Adobe Workfront 2017.3, o formato das mensagens de saída para assinaturas de evento será alterado para permitir melhor desempenho e melhor uso das assinaturas de evento para suas integrações.
Atualizações no formato de mensagem de saída
As seguintes alterações serão feitas no formato de mensagem de saída:
-
As mensagens de saída incluirão oldState e newState para um recurso do Workfront.
Esses valores mostrarão as alterações feitas em um objeto como resultado de um evento no Workfront.
-
O campo de metadados eventTime será adicionado a todas as mensagens de saída.
Este campo indicará, em Nanossegundos e ÉpocaSegundos, a hora em que um evento ocorreu. Use eventTime ao solicitar eventos processados pela integração.
-
O campo proprietário:ID de empresa referenciado no recurso NOTA será removido.
-
O objeto referenciado currentVersion no recurso DOCU (Documento) será removido.
Se você usa atualmente assinaturas de eventos do Workfront, precisará atualizar suas integrações do Workfront antes da versão 2017.3 para levar em conta essas alterações.
Para saber mais sobre assinaturas de evento, consulte API de Assinatura de Evento.
Exemplos de formatos de mensagem antigos e novos
A seguinte mensagem CREATE de formato antigo não será mais usada após o lançamento do 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": {}
}
}
O novo formato a seguir, CRIAR mensagem, será usado após o lançamento do 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": {}
A seguinte mensagem de ATUALIZAÇÃO de formato antigo não será mais usada após o lançamento de 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": {}
}
}
A seguinte mensagem de ATUALIZAÇÃO de formato novo será usada após o lançamento de 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": {}
}
}