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 funcionamento do 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
...
- acessada por meio das URLs:
- http(s)://<host>:<port>/totvs-rest
...
- /public/ws/WebServiceExecBO.wsdl
...
- 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 |
Recomendamos a utilização do serviço api/auth/accesstoken, para geração de token para usuários internos e externos 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 ("arg1") e retorna um TOKEN JWT.
Recomendamos a utilização do serviço api/auth/accesstoken, para geração de token para usuários internos e externos. | ||
| logoutSession | Mantido apenas para compatibilidade, não é mais utilizado uma vez que o | |
| 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"). |
| Aviso | ||
|---|---|---|
| ||
Verificar a configuração em Propriedades → Propriedades Gerais → WebService (Permite login WebService).
|
...
Recomendamos a utilização do serviço responsável pela geração de Token JWT de acordo com as credencias do usuário (http://[SERVIDOR]:[PORTA]/api/auth/accesstoken)
|
...
| 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 se for executado através de um navegador;em execuções direta da URL pelo navegador):
2- Criar um projeto:
3- Adicionar a URL WSDL (Project → Add WSDL) → informar a URL novo (empty project)→ adicionar um WSDL (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, sendo disponíveis para utilização. 4- Efetuar uma requisição de "login". Neste caso ja pode-se utilizar diretamente o endpoint/operação para acessar o serviço.
Nesta imagem foi feito uma request para endpoint/operador UserLogin passando como parâmetro no arg1 o nome do usuário desejado, e na response é retornado o token.  | ||||||||
| Informações | ||||||||
Neste exemplo foi realizada 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.
|
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas