Histórico da Página

(Obrigatório)

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

(Obrigatório)

Objetivo

 Definir uma Definir a estrutura padrão para implementação a segregação dos métodos do TSS, para que possa ser utilizado tanto  pela DLL quanto pelo Web service do TSS.

Web services dos TSS. A segregação dos métodos será necessária para que as funcionalidades do TSS estejam disponíveis tanto por chamadas via Web service quanto para as chamadas que serão realizadas pelo TSS OFFLINE, que será realizada através de comunicação via 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.  

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 reestruturados, ficando livres de qualquer acoplamento de implementação de processamento e persistência de dados na camada do Web service.

Os métodos deverão conter 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 retornar 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.

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

Caso a requisição seja recebida para processamento via TSS OFFLINE, o processo será direcionado para a função TSSAnalyseReq() que fará a verificação do serviço configurado e assim a função TSSBrokerReq() que fará o processamento, caso contrário, a requisição será enviada para a função responsável pelo processamento da requisição via Web service. Todos os métodos deverá ser definidos com a seguinte estrutura:Deverá ser retirado todo o processamento dos métodos. Os métodos deverão conter apenas as validações específicas dos métodos, a chamada para a função de processamento e a validação do retorno do processamento. O método deverá estar estruturado para funcionar tanto para requisições da DLL quanto para as requisições enviadas diretamente pelos Web Services do TSS. Caso a requisição seja recebida pela DLL, o processo será direcionado para a função DLLProcRequest(), caso contrário será enviada para a função TSSProcRequest(). A Decisão de qual função chamar, deverá ser definida na compilação através de uma diretiva de compilação.

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

    local lRetorno cError := .T.
private oJSON := nil
private oJSONRet := nil

//VALIDAÇÕES ESPECÍFICAS DO MÉTODO. MANTER TODAS AS VALIDAÇÕES EXISTENTES.

""
    local lRetorno := .T.

if TSSAnalyseReq()

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

else

if( lRetorno := TSValXXXXXXXXXX self, @cError) )

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

else

self:

X :=

nil

endif

endif

if !( lRetorno :=

valType(self:ID_ENT) <> "U" ))

setSoapFault(WS_PROC, cError )

endif

delClassIntf()

return finishSped(lRetorno)

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

Onde TSSProcXXXXXXXXXX será o nome da função de processamento segregada do método via Web service. TSValXXXXXXXXXX  será o nome da função de validação da requisição segregada do método via Web service.

Fluxo do Processo

1. Fluxo Principal:

1.1.

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

1.2.

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

1.3.

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

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

1.6

1.7. retorna resposta da requisição.

2. Fluxo Secundário

    2.1. Falha na validação

        2.1.1.  Retorna String Soap Fault.

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>

 Realiza limpeza do objetos instanciados; 

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