Crie um Método de Serviço da Web¶

O Jitterbit permite acessar serviços web SOAP como parte do seu processo de transformação. Para chamar um serviço web SOAP usando Jitterbit, você precisa definir: um método de serviço web; transformações para lidar com a entrada e saída do web service; e uma operação para manter tudo unido.

• Certifique-se de ter aberto o projeto apropriado onde deseja armazenar o novo método de serviço web.

• Crie um novo método de serviço web usando um destes métodos:

  • Selecione Novo no menu Arquivo e escolha Novo Web Serviço Método no submenu; ou
  • Clique na seta para baixo ao lado do ícone do arquivo na barra de ferramentas e escolha **Novo Web Serviço Método na submenu; ou
  • Clique com o botão direito em Web Serviço Métodos na aba hierárquica na guia Intercâmbio no painel esquerdo da tela e escolha Novo Web Serviço Método no menu pop-up.

• Seu novo método de serviço web aparece em sua própria aba Novo método de serviço web no painel direito da janela.

• Insira um Nome apropriado para seu novo método de serviço da Web no campo Nome.

Especifique um WSDL¶

• Na área WSDL (Web Services Description Language), selecione um arquivo WSDL existente, insira um URL ou insira um diretório caminho que aponte para o WSDL do serviço web que você deseja chamar.

• Clique no botão Avançar na barra de ferramentas para continuar.

Selecione uma Operação¶

• Na próxima tela do Web Services Wizard, escolha a operação WSDL desejada na lista suspensa Selecione Operação.

• As estruturas de solicitação e resposta do serviço web são então carregadas em suas respectivas árvores hierárquicas para você revisar. Opcionalmente, você pode adicionar notas ao campo Documentação.

• Clique no botão Avançar na barra de ferramentas para continuar.

Especifique Detalhes Adicionais¶

A última tela do Web Services Wizard é opcional. Ele mostra a URL do serviço da web padrão e o cabeçalho HTTP SoapAction que foram extraídos do WSDL.

Se o serviço web exigir autenticação, ele exibirá campos onde você poderá inserir um Nome de usuário, Senha e selecionar um Certificado a ser usado durante a autenticação.

Essa tela também permite fornecer detalhes de limite de acesso (ou seja, atraso de chamada e/ou dados máximos) se o serviço web definir tais limites.

• Insira os valores apropriados quando necessário para acessar corretamente o serviço web especificado.

• Quando terminar, clique em Concluir na barra de ferramentas para criar e salvar seu serviço web.

Serviço Web Concluído¶

O novo Web Service será criado, salvo e a configuração exibida:

Propriedades Avançadas¶

Se necessário, o botão Propriedades Avançadas permite acesso às configurações de Propriedades HTTP Avançadas:

Estas opções avançadas modificam os cabeçalhos HTTP que estão sendo enviados com a solicitação:

• Ativar codificação de conteúdo: Se marcada, o cabeçalho Accept-Encoding será enviado com as codificações suportadas pelo Jitterbit. Atualmente o Gzip é compatível. Esta opção está desativada por padrão.

• Ativar codificação de transferência em partes: Se marcada, o cabeçalho "Transfer-Encoding: chunked" será enviado. Use esta opção se estiver transferindo grandes conjuntos de dados. Esta opção está desativada por padrão.

• Send Expect: 100-continue: Se marcado, o cabeçalho "Expect: 100-continue" será enviado. Com esta opção, nenhum dado será enviado até que o servidor HTTP valide os cabeçalhos. Use esta opção se estiver enviando grandes quantidades de dados, mas não quiser usar codificação de transferência em partes. Esta opção está desativada por padrão.

• Permitir cifras fracas: Se marcada, permitirá a comunicação com endpoints HTTP que usam cifras fracas (DES/3DES e RC4). Esta opção está desativada por padrão.

• Definir Accept-Encoding para GZip: Marcada por padrão, esta opção informa ao servidor HTTP que o Jitterbit pode aceitar uma resposta compactada em Gzip. Em troca, o Jitterbit seguirá o padrão RFC 1952 e descompactará automaticamente as respostas HTTP Gzip. Se o servidor não usar Gzip, o Jitterbit verá que a resposta não está compactada e tratará isso normalmente. Este recurso foi adicionado a partir da versão 8.20 do Jitterbit e agora é verificado por padrão para todas as fontes HTTP novas e existentes.

• Cabeçalhos de solicitação (uma linha por cabeçalho): Qualquer texto inserido nesta caixa será enviado como cabeçalhos HTTP. Especifique um cabeçalho por linha, a menos que o cabeçalho seja agrupado de acordo com o padrão HTTP. Variáveis globais entre colchetes serão substituídas por seus valores.

• Versão SSL: Aplicável apenas ao utilizar HTTPS, permite a especificação de uma versão SSL específica caso o servidor HTTP assim o exija. O padrão é “Negociar”. As opções disponíveis são:

  

Configurar uma Chamada de Serviço Web em uma Operação¶

Uma operação que chama um serviço web consiste em duas transformações: a primeira transforma dados em uma solicitação de serviço web e a segunda transforma dados de uma resposta de serviço web para um sistema de destino.

• Siga os passos para Definir uma Nova Operação.

• Escolha Web Serviço Chamada na lista suspensa Atividade.

• Selecione uma fonte existente na lista suspensa Fonte ou clique no botão controle à direita do campo para criar uma nova fonte.

• Selecione uma solicitação transformação predefinida (que transforma dados de sua origem em serviço da Web) no menu suspenso Transformação de Solicitação ou clique no botão controle **** para o à direita do campo para criar uma nova transformação de solicitação.

• Selecione um serviço web predefinido na lista suspensa Serviço Web ou clique no botão controle à direita do campo para criar um novo serviço Web.

• Selecione uma transformação de resposta predefinida (que é usada para transformar dados da resposta do serviço web para seu destino) na lista suspensa Transformação de resposta ou clique no botão controle à direita do campo para criar uma nova transformação de resposta.

• Selecione um destino existente no menu suspenso Destino ou clique no botão controle à direita do campo para criar um novo destino.

Testar uma Chamada de Serviço Web¶

• Edite a resposta transformação e selecione Teste e Operação no botão Transformação Toolkit na barra de ferramentas do construtor de transformação.

• Será solicitado que você selecione a operação que deseja testar, que faz a solicitação de acordo com aquela operação e retorna a resposta na árvore gráfica.