import.css=/download/attachments/327912/newLayout.css

 

WS Sender

A finalidade desse componente é enviar informações do TOTVS | ESB através de uma conexão Web Service. Este componente faz com que o TOTVS | ESB invoque um Web Service (tanto interno quanto externo) para enviar as informações que foram geradas, ao contrário do WS Channel Sender que cria um serviço passivo e aguarda conexões externas para buscar estas informações. As configurações gerais para o componente estão descritas abaixo.

 

CampoDescrição
NameInserir uma identificação para a configuração do sender HTTP.
Error IntervalInserir o intervalo (em segundos) para que o sistema aguarde, caso ocorra algum erro, para efetuar novamente a verificação de novas mensagens.
TriesInserir o número de vezes que o sistema deve tentar enviar a mensagem antes de notificar o erro ao usuário.
PersistQuando selecionado, um registro da execução do sender será gravado no banco do TOTVS | ESB.

 

Ainda o componente possui configurações específicas que estão dividas em duas abas: SOAP Request Settings e Security Settings. A primeira tabela demonstra os campos disponíveis na aba SOAP Request Settings.

CampoDescrição
WSDL PathInserir o endereço utilizado na conexão com o web service. Informando o WSDL URL e estando conectado à internet o TOTVS | ESB é capaz de ler o WSDL e listar as operações disponíveis no campo Operation através do botão List Operation.
OperationSelecionar o nome da operação a ser executada.
List OperationLista as operações definidas no WSDL e preenche o campo Operation se o campo WSDL Path não estiver configurado.
Tabela

A tabela define os parâmetros que a operação escolhida acima deve receber. A ordem dos parâmetros definidos na tabela deve respeitar a ordem definida na operação do web service. Os botões localizados ao lado direito da tabela servem para alternar a ordem dos parâmetros. Os campos disponíveis são:

  • Name: Inserir uma identificação para o parâmetro.
  • Data Type: Inserir o tipo do parâmetro. (O TOTVS | ESB utiliza esse campo para fazer parse do valor informado.). Poderá ser:
    Text: quando o parâmetro a ser passado é String (texto);
    Number: quando o parâmetro a ser passado é um número inteiro. Ex.: 150;
    Big Number: quando o parâmetro a ser passado é um número inteiro, porém muito grande. Ex.: 152165894553;
    Decimal: quando o parâmetro a ser passado é um número racional. Ex.: 150,33;
    Boolean: quando o parâmetro a ser passado é um valor do tipo Verdadeiro ou Falso. Ex.: true;
    File: quando o parâmetro a ser passado é um arquivo. No campo value deverá ser informado o caminho completo para o arquivo que se deseja enviar como parâmetro. Ex.: c:\temp\dados.xml.
    ESBMessage: quando selecionado ele assume o valor do parâmetro com base no que é passado:
    #: quando é passado o parâmetro “#” no “Value”, será utilizado o XML corrente da transação, que será convertido para String e enviado como parâmetro;
    $XPATH: quando é passado o parâmetro “$XPATH” no campo “Value” o TOTVS | ESB irá pegar os valores com base no XPATH;
    Valor: qualquer outro valor informado diferente de “#” e “$XPATH” no campo “Value” será tratado como String;
    XMLMessage: quando selecionado, o TOTVS | ESB irá enviar como parâmetro o XML corrente da transação (em formato XML).
  • Value: Valor do parâmetro.
Use WS-AddressingQuando selecionado, chama o serviço usando endereçamento conforme especificação WS-Addressing.
Use SOAP ActionInclui o header SOAP Action na chamada HTTP do serviço.
Return Type

O componente WS Sender pode ter outros componentes ligados a ele que recebe uma mensagem de acordo com a configuração desse campos:

  1. Service Result: envia o resultado da chamada do serviço para o próximo componente.
  2. Original Message: envia a mensagem original recebida pelo WS Sender para o próximo componente.
  3. Both: cria uma mensagem nova agregando a mensagem recebida no WS Sender mais a mensagem retornada pelo serviço. A mensagem criada segue o formato:

<HTTPServiceDoc>
<OriginalMessage>...</OriginalMessage>
<ServiceResult>...</ServiceResult>
</HTTPServiceDoc>

 


A Security Settings configura opções relacionadas a segurança da mensagem. Tem-se quatro abas distintas: WS-Authentication, WS-Signature, WS-Encryption e HTTP Authentication. Cada tabela a seguir apresenta opções contidos em cada aba respectivamente iniciando pela aba WS-Authentication.

CampoDescrição
Use Username TokenQuando selecionado, indica que será utilizado autenticação nas mensagens de Web Service.
UsernameInserir o nome do usuário para a autenticação do serviço.
PasswordInserir a senha do usuário para a autenticação do serviço.
Password Type

Selecionar o tipo de senha.

  • Password Text: senha como String.
  • Password Digest: senha codificada usando a função SHA-1 (Secure Hash Algorithm).

 

Aba WS-Signature

CampoDescrição
Use Digital SignatureQuando selecionado, indica que será utilizado assinatura digital nas mensagens de Web Service.
KeyStoreInserir o nome do diretório onde está gravado o repositório de certificados para assinatura digital das mensagens de Web Service.
KeyStore Password
Inserir a senha do repositório de certificados.
AliasInserir o apelido do certificado dentro do keystore.
Alias PasswordInserir a senha do certificado.

 

Aba WS-Encryption

CampoDescrição
Use CipherQuando selecionado, indica que será utilizada criptografia nas mensagens de Web Service.
KeyStoreInserir o nome do diretório onde está gravado o repositório de certificados para criptografia das mensagens de Web Service.
KeyStore PasswordInserir a senha do repositório de certificados.
AliasInserir o apelido do certificado dentro do keystore.
Alias PasswordInserir a senha do certificado.

 

Aba HTTP Authentication

CampoDescrição
Use HTTP AuthenticationQuando selecionado, indica que será utilizado autenticação HTTP básica.
UsernameInserir o nome do usuário para a autenticação do serviço.
PasswordInserir a senha do usuário para a autenticação do serviço.