Histórico da Página
...
- UUID: mesma definição da tag UUID;
- Type: mesma definição da tag Type, exceto que não haverá mensagens do tipo Receipt no formato JSON;
- SubType: tem objetivo similar às tags BusinessEvent e BusinessRequest. Os valores esperados para o atributo subType são event e request;
- Event: quando SubType é event, este atributo conterá os valores upsert ou delete, para indicar que a mensagem corresponde a uma inclusão/alteração ou a uma eliminação, respectivamente.
- Transaction: mesma definição da tag Transaction;
- Version: corresponde ao atributo version da tag MessageInformation, ou seja, indica a versão da transação;
- SourceApplication: mesma definição da tag SourceApplication;
- ProductName: corresponde ao atributo name da tag Product: indica o nome do produto origem da mensagem (PROTHEUS, DATASUL, RM, LOGIX, etc.);
- ProductVersion: corresponde ao atributo version da tag Product: indica a versão do produto origem;
- GeneratedOn: mesma definição da tag GeneratedOn;
- DeliveryType: mesma definição da tag DeliveryType.
...
- ReceivedMessage: equivalente à tag ReceivedMessage, da mensagem de resposta no padrão SOAP, exceto pela tag filha MessageContent, que não será mais utilizada;
- ProcessingInformation: equivalente à tag ProcessingInformation, do padrão SOAP, exceto pela tag filha ListOfMessages, que foi substituída pelo atributo Details, que por sua vez, conterá as mensagens referentes ao processamento da mensagem original. Elas estarão estruturadas conforme definido no Guia de Implementação de APIs TOTVS, item Mensagens de erro, com a ressalva de que os atributos utilizaram a forma capitalizada, em vez do formato "camelCase", ou seja, em vez de "code", será usado "Code", por exemplo.
- ReturnContent: conterá o resultado do processamento da mensagem original, conforme definido para a transação. Além disso, pode conter também o atributo ListOfInternalId, onde constará todos os internalIDs relacionados a mensagem. A estrutura correspondente ao internal ID terá os seguintes atributos:
- Name: nome da entidade correspondente ao valor sendo trafegado. Exemplo: "CustomerVendor", "Item", "SalesOrder";
- Origin: mesma definição da tag Origin;
- Destination: mesma definição da tag Destination.
| Informaçõeswarning | ||
|---|---|---|
| ||
No padrão REST/JSON, a indicação do tipo de operação - upsert ou delete - originalmente indicada na tag Event do padrão SOAP/XML, estará vinculada ao método HTTP utilizado na requisição. Mais informações serão prestadas na seção Interface deste documento. | ||
| ||
A tag Identification, subordinada à tag BusinessEvent, não será contemplada no formato REST/JSON. Essa tag foi sendo substituída ao longo do tempo pelos InternalID | ||
| Aviso | ||
| ||
A tag Identification, subordinada à tag BusinessEvent, não será contemplada no formato REST/JSON. Essa tag foi sendo substituída ao longo do tempo pelos InternalIDs do corpo das mensagens. Ao migrar um adapter para utilizar o novo formato, qualquer processamento baseado na tag Identification deve ser revisto. |
...
| Bloco de código | ||
|---|---|---|
| ||
{
"Header" : {
"UUID" : "d6bbfa63-ca27-e2ac-0b14-101970f59a5b",
"Type" : "BusinessMessage",
"SubType" : "event",
"TransactionEvent" : "CostCenterupsert",
"VersionTransaction" : "2.000CostCenter",
"SourceApplicationVersion" : "2.000",
"SourceApplication": "P1299",
"ProductName" : "PROTHEUS",
"ProductVersion" : "12.1.17",
"CompanyId" : "99",
"BranchId" : "01",
"GeneratedOn" : "2017-11-14T11:47:00-03:00",
"DeliveryType" : "async",
},
"Content" : {
"CompanyId" : "99",
"BranchId" : "01",
"CompanyInternalId" : "99",
"Code" : "ABC001",
"InternalId" : "99|ABC001",
"RegisterSituation" : "Active",
"Name" : "Centro de Custo ABC001",
"ShortCode" : "ABC001",
"SPED" : true,
"Class" : 2
}
} |
...
| Bloco de código | ||
|---|---|---|
| ||
{
"Items" : [
{
"Header" : {
"UUID" : "",
"Type" : "",
"SubType" : "",
"Event" : "",
"Transaction" : "customerVendor",
"Version" : "2.001",
"SourceApplication": "",
"ProductName" : "",
"ProductVersion" : "",
"GeneratedOn" : "",
"DeliveryType" : "async",
},
"Content" : {
"Atributo1" : "",
"Atributo2" : "",
...
"AtributoN" : ""
}
},{
"Header" : {
"UUID" : "",
...
"Transaction" : "item",
"Version" : "3.001",
...
"DeliveryType" : "async"
},
"Content" : {
"Atributo1" : "",
"Atributo2" : "",
...
"AtributoN" : ""
}
}
]
} |
...
| Informações | ||
|---|---|---|
| ||
Por definição, não serão aceitas mensagens com subtipo request no método DELETE. Apenas mensagens com subtipo event serão permitidas. Quando tal situação ocorre, será retornado, no mínimo, o código HTTP 405 (Method not allowed). |
| Informações | ||
|---|---|---|
| ||
Diante do descrito até o momento, há duas formas de se indicar a operação de uma mensagem do tipo BusinessMessage: via métodos HTTP (POST e DELETE) e via atributo Event. Sempre que for possível determinar a operação pelos atributos do canal, esta será a informação prevalente, como é o caso do canal REST, onde os métodos HTTP provêm essa indicação. Neste caso, pode ocorrer sobre posição da informação no atributo Event da mensagem, se ele não for compatível com a indicação do canal. O atributo Event, dentro da mensagem, será considerado apenas nos casos onde o canal não fornecer a indicação da operação, como é o caso do canal AMQP. |
Exemplos de utilização
Exemplos de utilização deste predicado podem ser encontrados nos links a seguir:
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas