Histórico da Página
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).
| Informações |
|---|
Apesar do nome, este serviço deve ser utilizado apenas para chamadas à API´s, uma vez que as operações das DBO´s não são Stateless. |
| Aviso |
|---|
Para o "Novo Framework" (DTS4THF), não são necessárias configuração adicionais para o funcionamento do TOTVS Datasul WS-EXEC-BO! |
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 acessadas por meio da URL http(s)://<host>:<port>/totvs-rest/ws/public/ws/WebServiceExecBO.wsdl ou http(s)://<host>:<port>/wsexecbo/WebServiceExecBO?wsdl
As operações disponíveis neste serviço são:
| Operação | Descrição |
|---|---|
| login | Recebe como cabeçalhos HTTP o nome do usuário ("username") e a senha ("password") e retorna um TOKEN JWT que deve ser utilizado para as chamadas às outras operações. |
| userLogin | Recebe como argumento ("arg0") o nome do usuário ou e-mail e retorna um TOKEN JWT. |
| userAndPasswordLogin | Recebe como argumentos o nome do usuário ("arg0"), senha ("arg1") e retorna um TOKEN JWT. |
| logoutSession | Foi mantido apenas para compatibilidade pois não é utilizado nesta versão, uma vez que o TOKEN JWT expira automaticamente. |
| callProcedure | Recebe como cabeçalho HTTP o TOKEN JWT ("usertoken") e como argumentos o nome do programa ("arg0"), o nome do procedimento ("arg1") e os parâmetros desta ("arg2"). |
| callProcedureWithCompany | Recebe como cabeçalho HTTP o TOKEN JWT ("usertoken") e como argumentos o código da companhia ("arg0"), nome do programa ("arg1"), o nome do procedimento ("arg2") e os parâmetros desta ("arg3"). |
| callProcedureWithToken | Recebe como argumentos o TOKEN JWT ("arg0"), o nome do programa ("arg1"), o nome do procedimento ("arg2") e os parâmetros desta ("arg3"). |
| callProcedureWithTokenAndCompany | Recebe como argumentos o TOKEN JWT ("arg0"), o código da companhia ("arg1"), o nome do programa ("arg2"), o nome do procedimento ("arg3") e os parâmetros desta ("arg4"). |
Exemplo
| Expandir | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| |||||||||
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).
2- Criar um projeto (Project → empty project)
3- Adicionar a URL WSDL (Project → AddWSDL → 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 ao endpoint/operador userLogin como parâmetro no arg0 o nome do usuário cadastrado no produto Datasul. Após a execução é retornado o 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.
|
| Informações |
|---|
Para maiores informações do JWT quanto a uso e configuração, verificar o link a seguir [DTS4THF] Configurando autenticação com JWT |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas