Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
Especificação | |||
Produto |
| TSS TOTVS Service SOA |
|
Segmento Executor |
| ||
Projeto1 |
| IRM1 |
|
Requisito1 |
| Subtarefa1 |
|
Chamado2 |
| ||
Release de Entrega Planejada |
| Réplica |
|
País | ( X) Brasil ( X) Argentina (X ) Mexico (X ) Chile ( X) Paraguai ( X ) Equador ( X) USA ( X ) Colombia ( ) Outro _____________. | ||
Outros | <Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>. |
Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).
Definir a função EntidadeClear para a exclusão da entidade.um padrão para construção das funções que farão o processamento das requisições recebidas pelo TSS.
Os serviços oferecidos pelo TSS são disponibilizados apenas através de Web Services baseado no protocolo SOAP onde cada serviço é consumido através requisições feitas para métodos específicos dentro do TSS. Com o modelo proposto pelo TSS 3.0, os serviços do TSS deverão estar acessíveis tanto por web services quanto qualquer outra interface de integração com o TSS como requisições HTTP que será utilizada pela DLL de integração do TSS.
Atualmente grande Grande parte dos métodos de integração do TSS realizam o processamento das requisições no próprio corpo do método. Dessa forma esses serviços ficam acoplados na interface de Web service e impedindo que o serviço possa ser consumido através de outros métodos de consumo. Para que os serviços oferecidos pelo TSS possam ser atendidos através de qualquer interface como as requisições HTTP que serão implementada na DLL, os serviços deverão ser disponibilizados através de funções. A nomeclatura das funções sera formada por: Todos os métodos deverão estar desacoplados do processamento da requisição para que os métodos funcionem apenas como interface de integração. Como interface os métodos serão responsáveis apenas pela validações dos parâmetros da requisição e pela montagem do retorno do método enquanto o processamento das requisições será realizado através de chamadas para as funções de processamento.
Afim de facilitar a implementação será definido o seguinte padrão para as funções:
Nome das funções:
"TSPROC" + "Sequencia Id Sequencial do processo" + "nome do Método"
Os nomes das funções estarão definidos em uma lista de processos que será obtida através da função TSSGetficar , dessa forma as funções deverão ser criadas com o mesmo nome definido na lista de processos.
Ex: TSPROC0001Remessa - Função para processamento de remessas do Web service NESBRA
Parâmetros
As funções receberão como parâmetro a mensagem JSON padrão definida para o TSS.(ver especificação da função: getJsonRequest() ). Para facilitar a implementação das funções, os parâmetros seguirão a mesma nomenclatura e estrutura recebida pelos métodos devendo apenas acrescentar os atributos de referencia para o objeto JSON. Dessa forma para criar as funções será necessário apenas copiar a estrutura dos métodos e realizar a dos parâmetros e do retorno:
oJSON:receive: + "parâmetro"
A mensagem JSON recebida pela função já estará Deserializada e terá os mesmo parâmetros na mesma estrutura do recebida pelos Web Services, sendo necessario apenas subistituir as inicias " :: ou sef: " por: "oJSON:receive" .
Exemplo:
Acesso ao atributo "TOKEN" através do Web Service: "sef:TOKEN"
Acesso ao atributo TOKEN através do objeto JSON: "oJSON:receive:token" .
oJSONRet:send + "retorno do método"
Ex: Metodo Remessa:
Parâmetros :
oJSON:receive:UserToken,
oJSON:receive:Id_Ent,
oJSON:receive:Nfe:NOTAS[nX]:XML
Retorno:
oJSON:send:NfeOk:ID
Após o processamento as funções deverão criar a mensagem JSON de resposta através da função getJSONResponse() e disponibiliza-lá na lista de resposta de requisições.
Para Implementação, verificar lista com a especificação das funções a serem implementadas. A lista será disponibilizada através da função TSSGetProcQueue()
<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.
<Informações utilizadas na linha Protheus>.
<Informações utilizadas na linha Protheus>
<Informações utilizadas na linha Datasul>.
Procedimentos
Programas
Cadastro de Papéis
<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.
<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.
[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.
[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante
[3] Categorias são obrigatórias para os programas FLEX.
[4] Obrigatório quando o projeto for FLEX
[5] Obrigatório quando o projeto for FLEX
[6] Obrigatório quando o projeto for FLEX
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|