Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 34

changes.mady.by.user Karen De Freitas Machado

Gravado em

comparado com

Nova versão 35

changes.mady.by.user Simon Flock Schiesl Ferreira

Gravado em

Chave

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

...

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

...

  • acessada por meio da

...

  • URL 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:

OperaçãoDescrição
loginRecebe como cabeçalhos HTTP o nome do usuário ("username") e a senha ("password") e retorna um josso_session (JBoss) ou TOKEN JWT (Tomcat) que deve ser utilizado para as chamadas às outras operações.
userLoginRecebe como argumento ("arg0") o nome do usuário ou e-mail e retorna um josso_session (JBoss) ou TOKEN JWT (Tomcat).
userAndPasswordLoginRecebe como argumentos o nome do usuário ("arg0"), senha senha ("arg1") e retorna um josso_session (JBoss) ou TOKEN JWT (Tomcat).
logoutSession

Enviar o josso_session (JBoss). Para o Tomcat, foi mantido apenas para compatibilidade pois não é utilizado nesta versão, uma vez que o Depreciado. TOKEN JWT expira automaticamente.

callProcedureRecebe como cabeçalho HTTP o josso_session (JBoss) ou o TOKEN JWT (Tomcat)("usertoken") e como argumentos o nome do programa ("arg0"), o nome do procedimento ("arg1") e os parâmetros desta ("arg2").
callProcedureWithCompanyRecebe como cabeçalho HTTP o josso_session (JBoss) ou o TOKEN JWT (Tomcat)("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").
callProcedureWithTokenRecebe como argumentos o josso_session (JBoss) ou o TOKEN JWT (Tomcat)("arg0"), o nome do programa ("arg1"), o nome do procedimento ("arg2") e os parâmetros desta ("arg3").
callProcedureWithTokenAndCompany

Recebe como argumentos o josso_session (JBoss) ou TOKEN JWT (Tomcat)("arg0"), o código da companhia ("arg1"), o nome do programa ("arg2"), o nome do procedimento ("arg3") e os parâmetros desta ("arg4").

Aviso
titleAviso

A partir da release 12.1.31, foi implementada uma propriedade para restringir a utilização das operações login, userLogin e userAndPasswordLogin.

JBoss

  • No arquivo datasul_framework.properties, incluir a propriedade login.webexecbo.allowed=false. Caso esta propriedade não esteja configurada no arquivo, o padrão é permitir o acesso as operações de login.
    • Uma alternativa ao login do WebService é a utilização de um serviço de autenticação próprio do produto TOTVS Linha Datasul (http://[SERVIDOR]:[PORTA]/josso/signon/auth

    .

    do)
  • Para mais informações de como utlizar este serviço, consultar DFWKTOOLS-2307 DT Autenticação usuário para acesso via endpoints Datasul
    • Tomcat (DTS4THF)

    Efetuar a configuração em Propriedades → Propriedades Gerais → WebService (item Permite login WebService).

    • Caso esta propriedade não exista no banco de dados, o sistema permitirá o acesso as operações de login. Se houver algum valor incorreto no atributo, ocorrerá o bloqueio as operações de WebService login.
    • Uma alternativa ao login do WebService, é a utilização de um serviço responsável pela geração de um Token JWT de acordo com as credencias do usuário  (http://[SERVIDOR]:[PORTA]/api/auth/accesstoken)
    • Para mais informações quanto a utilização do serviço, consultar [DTS4THF] Configurando autenticação com JWT

    ...