ER_PCREQ-8281_Segregação_de_Processos_Web_service

Informações Gerais

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

Objetivo

Definir o padrão das funções de processamento das requisições de Web service. 

Os serviços oferecidos pelo TSS são disponibilizados apenas através de Web services baseados no protocolo SOAP, onde cada serviço é consumido através requisições feitas para métodos específicos dentro do TSS.No modelo proposto pelo TSS 3.0, os serviços do TSS estarão acessíveis tanto por Web service quanto por qualquer outra interface de integração, assim como requisições HTTP que serão utilizadas pela DLL de integração do TSS.  

Definição da Regra de Negócio  

Definir a função que irá executar o processamento segregado dos Web services. Será estruturada da seguinte forma:

• Validação:

            A validação dos parâmetros das requisições serão definidas em uma função que será chamada pelo método ou poderá ser utilizada por qualquer outra interface que venha ser implementada para integração com o TSS. Abaixo a descrição da nomenclatura das funções:

• Função:

           TSSVal + Código do Processo + Nome do Método

• Parâmetro:

            oJSON 

            Exemplo:

            TSSVal0002AdmEmpresas(oJSON)

• Processamento:

            A função de processamento envolverá todo o código compreendido após a validação da requisição. O processamento deverá retornar o resultado estruturado de acordo com o esperado pelo Web service. Da mesma forma as validações e o processamento receberão como parâmetro, um objeto desserializado com os parâmetros da requisição, possibilitando receber tanto os parâmetros passados pelos métodos via Web service como as mensagens no formato JSON (formato texto e completamente independente de linguagem) enviadas pela DLL. A nomenclatura será definida da seguinte forma:

• Função:

            TSSProc + Código do Processo + Nome do Método

• Parâmetro:

            oJSON

            Exemplo:

            TSSProc0002AdmEmpresas(oJSON)

Seguindo esse padrão, tanto a funções de validação quanto as de processamento, terão exatamente o mesmo código contido hoje no processamento dos Web service, sendo necessário apenas trocar a referência dos parâmetros da requisição, da referência "self:" ou "::" para a referência "oJSON".

Para Implementação, verificar a lista com a especificação das funções a serem implementadas, disponibilizada através da função TSSGetProcQueue().