Base de conhecimento
Encontre respostas para suas dúvidas em quatro fontes de conhecimento diferentes ao mesmo tempo, simplificando o processo de pesquisa.

Cross Segmentos - Backoffice RM - Integração - Fórmula Visual - Utilizando a atividade "Executar Requisição SOAP"

time.pngTempo aproximado para leitura: 00:03:30 min

Dúvida

Como utilizar a atividade "Executar Requisição SOAP".  

Ambiente
Cross Segmentos - Backoffice RM - Integração - Todas as Versões.
 

Solução

Neste artigo será especificada a atividade “Executar Requisição SOAP” disponível na Fórmula Visual.



A atividade “Executar Requisição SOAP” permite que a fórmula visual execute uma requisição utilizando o protocolo SOAP. Esta requisição é feita utilizando o método HTTP (POST) e permite que os dados retornados pela requisição sejam consumidos pela fórmula visual.
É possível ainda definir o tipo de autenticação da requisição que pode ser básica (informando um usuário e senha) ou baseada em Tokens (informando o schema e token).

Vamos Configurar o Serviço.

1) Clique com o botão direito na atividade e selecione a opção Configurar Web Service.



2) Defina o descritor do Web Service (WSDL) que será utilizado e clique em OK.

Será apresentado o XML do descritor à sua esquerda, e será apresentado os métodos disponíveis à sua direita.

 

3) Escolha o método que será utilizado.



4) Após escolher o método à ser utilizado na Fórmula Visual, as propriedades Método, Wsdl e Endereço da Requisição já estarão preenchidas, você deverá preencher então o usuário e senha (caso houver necessidade) e o Pré Autenticar (também se houver necessidade)




Parâmetros da Requisição

Nome

Descrição

Cabeçalhos HTTP

Se a sua requisição exigir o envio de header, preencha esta propriedade da atividade - Disponível a partir da versão 12.1.24.
Os parâmetros devem ser informados um por linha, como no exemplo abaixo. Após clicar em Ok, novas propriedades serão exibidas nos detalhes da atividade, no agrupamento "Cabeçalhos HTTP", para preenchimento dos valores dos campos do header. Exemplo:

Endereço da Requisição

Endereço do serviço que deseja executar a requisição.

Exemplo:

http://10.31.0.155:8051/wsDataServer/MEX?wsdl

http://10.31.0.155:8051/IwsDataServer/ReadView

 

Importante: Para alguns serviços, o WSDL não atende os requisitos da requisição SOAP.

Caso o WSDL não atenda os requisitos, a URL será inserida na propriedade WSDL no grupo "Definição da Requisição", automaticamente .

Caso a URL atenda os requisitos a mesma será inserida na propriedade Endereço da Requisição.

Método de Requisição

Método do serviço que será executado.

Tempo Limite

Informe um tempo limite para execução da requisição em segundos. Caso este tempo seja ultrapassado será gerado um erro de timeout.

Utilizar Proxy do Sistema

Selecione se a requisição deverá utilizar a configuração padrão de proxy do Windows.



Definição da Requisição

Nome

Descrição

Método

Método do serviço que será executado.

Requisição (XML)

XML que será enviado na Requisição.

Este texto poderá conter parâmetros para montagem do XML que deverão ser informados entre chaves { }.

Exemplo:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <tot:ReadView>
         <!--Optional:-->
         <tot:DataServerName>GlbUsuarioData</tot:DataServerName>
         <!--Optional:-->
         <tot:Filtro>CODUSUARIO='{CodUsuario}'</tot:Filtro>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODSISTEMA=G</tot:Contexto>
      </tot:ReadView>
   </soapenv:Body>
</soapenv:Envelope>
O Parâmetro será criado como uma propriedade na atividade.

WSDL

Neste campo será inserido automaticamente a URL do WSDL caso a mesma não atenda os requisitos da requisição SOAP.



Segurança/Autenticação
Nome Descrição
Tipo de Autenticação

Selecione o tipo de autenticação da requisição, que pode ser:

  • None: Não utiliza nenhum tipo de autenticação.
  • Basic: Faz a requisição utilizando autenticação básica através do Header Authorization (autenticação padrão utilizada pelo Host), um usuário e senha devem ser informados através das respectivas propriedades.
  • UserName: Faz a requisição utilizando autenticação padrão por usuário e senha, que devem ser informados nas propriedades Usuário e Senha. Para mais informações consulte:
    https://pt.stackoverflow.com/questions/254503/o-que-%C3%A9-basic-auth
  • Token: Faz a requisição utilizando autenticação via Token (através do Header Authorization), que devem ser informados nas propriedades Token e Token Schema. Para mais informações consulte: https://pt.wikipedia.org/wiki/OAuth
Usuário Informe o nome do usuário que será utilizado pela autenticação básica.
Senha Informe a senha do usuário que será utilizado pela autenticação básica.
Token Informe os dados do Token que será utilizado pela autenticação via Token.
Token Schema Informe o Schema do Token que será utilizado pela autenticação via Token. São exemplos de schema BEARER, OASIS e outros.



Tipo de Conteúdo

Nome Descrição do Parâmetro
Codificação do Texto da Requisição

Informe o tipo de codificação utilizado para codificar/decodificar os textos da requisição. Por padrão será utilizado a formato UTF-8.

Para mais informações consulte:

https://msdn.microsoft.com/pt-br/library/system.text.encoding(v=vs.110).aspx
Tipo de Conteúdo Aceito

Informe o tipo de conteúdo MIME aceito como retorno da requisição. Por padrão será aceito qualquer tipo de conteúdo, porém alguns servidores Web exigem que o tipo de conteúdo aceito seja informado (Header HTTP Accept).

Para mais informações consulte:

https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Accept
Tipo de Conteúdo da Requisição

Informe o tipo de conteúdo MIME que será enviado nos dados da requisição (Header HTTP Content-Type). Por padrão o sistema irá utilizar o tipo “text/XML”.

Para mais informações consulte:

https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Type



Resposta

As propriedades de resposta contêm os dados retornados pela execução da requisição.

Nome

Descrição do Parâmetro

Resposta (Código)

Contém o código HTTP da resposta do servidor.

Resposta (Texto)

Contém o conteúdo da resposta da requisição no formato de texto, caso o tipo da resposta (Content-Type: “text”), em formato texto.

Tabelas

Provê acesso aos dados retornados pela requisição no formato de tabela/coluna.

Campos

Provê acesso aos dados da tabela principal retornada pela requisição.



Importante: Ao utilizar essa atividade com HTTPS é necessário que o certificado ofereça uma conexão segura. 

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _