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 |
---|
Com o D4THF não é necessária nenhuma configuração 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 esta é hospedado no mesmo para o contexto do TOTVS-REST, através da com seu acesso pela URL http(s)://<host>:<port>/totvs-rest/public/ws/WebServiceExecBO. Para Com a finalidade de manter a compatibilidade com as integrações já existentes, foi implementado um outro serviço na para a URL http(s)://<host>:<port>/wsexecbo/WebServiceExecBO?wsdl wsdl, que apenas redireciona para o contexto anterior.
A descrição WSDL do serviço podem ser acessadas através da URL's por meio da URL http(s)://<host>:<port>/totvs-rest/ws/public/ws/WebServiceExecBO.wsdl ou http(s)://<host>:<port>/wsexecbo/WebServiceExecBO?wsdl .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")e a senha , senha ("arg1") e retorna um TOKEN JWT. |
logoutSession | Mantido Foi mantido apenas para compatibilidade , pois não é mais 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 já esta esteja instalada, pode-rá se seguir as dicas etapas abaixo para um testevalidação e testes: 1- Atraves do Clicar no botão "Explorer EndPoint" → e informar a url URL onde se encontra o serviço e se estiver tudo correto irá retornar . Caso a URL esteja funcional, será retornado o arquivo com as informações do WSDL *.*E (É a mesma situação que ocorre em execuções direta da URL pelo navegador). se for executado através de um navegador; 2- Criar um projeto novo (Project → empty project) 3- Adicionar a URL → adicionar um WSDL (Project → AddWSDL → informar a url onde se encontra a descrição WSDL do serviço); Com isto serão , são carregados uma coleção contendo com os endpoints/operações deste serviço, as quais já estão informadas no quadro acima. Neste caso ja pode-se utilizar diretamente o endpoint/operação para acessar o serviço. , sendo disponíveis para utilização. 4- Efetuar o Nesta imagem foi feito efetuado uma request para requisição ao endpoint/operador UserLogin passando userLogin como parâmetro no arg1 arg0, o nome do usuário desejado, e na response . Após a execução é retornado o token JWT. |
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 |
...