Árvore de páginas

Versões comparadas

Chave

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

...


      O  O serviço TOTVS Datasul WS-EXEC-BO prove um canal de comunicação (via WebServices) entre a interface do usuário (front-end) e o servidor de aplicação / banco de dados (back-end).

...

  • Este serviço é hospedado para o contexto do TOTVS-REST, com seu acesso pela URL http(s)://<host>:<port>/totvs-rest/public/ws/WebServiceExecBO.
    • Com a finalidade de manter a compatibilidade com as integrações já existentes, foi implementado um serviço para a URL http(s)://<host>:<port>/wsexecbo/WebServiceExecBO?wsdl, que redireciona para o contexto anterior.
  • A descrição WSDL do serviço podem ser acessada por meio da URL das URLs:
    • http(s)://<host>:<port>/totvs-rest/public/ws/WebServiceExecBO.wsdl
     ou 
    •  
    • http(s)://<host>:<port>/wsexecbo/WebServiceExecBO?wsdl

As operações disponíveis neste serviço são:

...

Expandir
titleClique para visualizar o conteúdo

A nível de teste pode-se utilizar a ferramenta SOAPUI ou Postman. Neste caso foi utilizado o SOAPUI 5.5.0.

Supondo que a ferramenta esteja instalada, pode-se seguir as etapas abaixo para validação e testes:


1- Clicar no botão "Explorer EndPoint" e informar a URL onde se encontra o serviço. Caso a URL esteja funcional, será retornado o arquivo com as informações do WSDL (É a mesma situação que ocorre em execuções direta da URL pelo navegador):

Image Modified

Image Modified


2- Criar um projeto:


3- Adicionar a URL WSDL (Project → Add WSDL) → informar a URL onde se encontra a descrição WSDL do serviço):



Com isto, são carregados uma coleção com os endpoints/operações deste serviço, as quais já estão informadas no quadro acima, sendo disponíveis para utilização.


4- Efetuar uma requisição de "login".

Neste exemplo foi realizado a requisição REST ao endpoint api/auth/accesstoken para geração do TOKEN JWT.


5- Com base no token JWT gerado, efetuar a chamada aos programas Progress com o endpoint/operador desejado. Neste exemplo foi utilizado o callProcedureWithToken.


O exemplo acima utiliza o programa Progress "CalculadoraSimples.p", abaixo está o trecho de código para testes.

Bloco de código
languagexml
titlejava/CalculadoraSimples.p
        <!--Optional:-->
		<arg1>java/CalculadoraSimples.p</arg1>
	    <!--Optional:-->
	    <arg2>pi-calc</arg2>
         <!--Optional:-->
         <arg3>[ { "name":"pOperador", "type":"input", "dataType":"character", "value":"+"},
				{ "name":"pNum1", "type":"input", "dataType":"decimal", "value":1},
				{ "name":"pNum2", "type":"input", "dataType":"decimal", "value":1},
				{ "name":"pResult", "type":"output", "dataType":"decimal", "value":0 } ]
	    </arg3>

...