Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
portuguese
Composition Setup
import.css=/download/attachments/327912/newLayout.css

 

Pagetitle
WS Sender
WS Sender

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.