ER_PCREQ-8273_WS_Padrão_para_Segregação_dos_métodos_WS

Informações Gerais

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

Objetivo

Definir a estrutura padrão para a segregação dos métodos 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:

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

    local cError := ""
    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)

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 Realiza limpeza do objetos instanciados;