Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

(Obrigatório)

Informações Gerais

 

Especificação

Produto

TSS

Módulo 

TSS TOTVS Service SOA 

Segmento Executor

 SERVIÇOS

Projeto1 

M_SER_TSS002

IRM1 

PCREQ-8272

Requisito1 

PCREQ-8273

Subtarefa1

 

Chamado2

 

Release de Entrega Planejada 

12.1.13

Réplica

 

País

(  X) Brasil  (   X ) Argentina  (  ) Mexico  (  ) 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). 

(Obrigatório)

Objetivo

 Definir Definir a estrutura padrão para a segregação dos métodos Web Services services dos TSS. A segregação dos métodos será necessária para que as funcionalidades do TSS estejam disponíveis tanto por chaadas chamadas via Web Service service quanto para as chamadas que seãp serão realizadas pela DLL do pelo TSS OFFLINE, que será realizada através de comunicação via HTTPS HTTP, com mensagens no formato JSON, (formato texto e completamente independente de linguagem). Dessa os serviços oferecidos pelo TSS estarão disponíveis para acesso através de qualquer interface de comunicação    

(Obrigatório)

Definição da Regra de Negócio

Para que os métodos do TSS funcionem apenas como uma interface de comunicação entre os ERPs e o TSS, os métodos deverão ser restruturadosreestruturados, ficando livre livres de qualquer acoplamento de implementação de processamento das requisições. e persistência de dados na camada do Web service.

Os métodos deverão conter apenas a chamada para função de validação e processamento a verificação do serviço do TSS que esta configurado, de acordo com o serviço, realizar o processamento correto da requisição e a verificação do retorno para o Web Serviceretornar como resposta a estrutura hoje existente.

Tanto a função de processamento quanto a função de validação, serão originadas a partir da segregação do método método.

As entradas de requisições para processamento via DLL TSS OFFLINE ou sem DLLTSS OFFLINE, serão realizadas através dos mesmos métodos já existentes no TSS. De acordo com a configuração do appserver do Web Server, as requisições seguirão o seguinte fluxo descrito abaixo.     

Caso a requisição seja recebida para processamento via DLLTSS OFFLINE, o processo será direcionado para a função DLLProcRequest TSSAnalyseReq() que fará a verificação do serviço configurado e assim a função TSSBrokerReq() que fará o processamento requerido pela DLL  , caso contrário, a requisição será enviada para a função responsável pelo processamento da requisição WSvia Web service. Todos os métodos deverá ser definidos com a segguinte seguinte estrutura:

 

WSMETHOD  XXXXXXXXX     WSRECEIVE  XXXXXX, XXXXXX, XXXXXXX       WSSEND XXXX            WSSERVICE XXXXXX

    local cError := ""
    local lRetorno := .T.   

if TSSAnalyseReq(

lRetorno

)

self:X :=

TSval0002admempresas

TSSBrokerReq( self, @cError )

)
        if( isDll())
            self:ID_ENT := DLLProcRequest(

else

if( lRetorno := TSValXXXXXXXXXX self, @cError)

        else
            self:ID_ENT

)

self:X := TSProcXXXXXXXXXX( self, @cError )

        endif

   

else

       

self:

ID_ENT

:= nil

   

endif

endif

   

if !( lRetorno := valType(self:ID_ENT) <> "U" ))

       

setSoapFault(WS_PROC, cError )

   

endif

   

delClassIntf()

return finishSped(lRetorno)

 

Onde TSSProcXXXXXXXXXX será o nome da função de processamento segregada do método WS.

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>via Web service. TSValXXXXXXXXXX  será o nome da função de validação da requisição segregada do método via Web service.

 

Opcional

Fluxo do Processo

1. Fluxo Principal:

1.1. Realiza

validação da Requisição através. 

a verificação do serviço configurado TSSAnalyseReq().

1.2.

Requisição  inválida[2.1]

Se o serviço é específico, a requisição será enviada para a função TSSBrokerReq(). 

1.3.

Verifica se o processamento passara pela DLL. 1.4. Se o processamento for para DLL, envia requisição para função DLLpRocRequest. caso

 Caso contrário executa função de validação e processamento do método

.

;  

1.

5. Retorno Inválido[2.2]1.6.

4. Se retorno for nulo (nil), retorna Soap Fault com erro do processo.

1.5. Caso contrário retorna resultado de acordo com estrutura esperada pelo Web

service 

service; 

1.

7. Realiza limpeza do objetos instanciados 

 

2. Fluxo Secundário

    2.1. Falha na validação

        2.1.1.  Retorna String Soap Fault com erro da validação.

    2.1. Falha no processamento

        2.1.1.  Retorna String Soap Fault com erro do processamento.

6 Realiza limpeza do objetos instanciados; 

 

Image Removed

 

Opcional

 

Dicionário de Dados

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

(Opcional)

Estrutura de Menu

<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.