Conexão SOAP

Introdução

Uma conexão SOAP é configurada usando o conector SOAP, estabelecendo acesso a um serviço web SOAP. Depois que uma conexão é estabelecida, você pode configurar uma ou mais atividades SOAP associadas a essa conexão para serem usadas como uma fonte para fornecer dados a uma operação ou como um destino para consumir dados em uma operação.

Criar ou editar uma conexão SOAP

Uma nova conexão SOAP é criada usando o conector SOAP de um destes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).

Uma conexão SOAP existente pode ser editada nestes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

Configurar uma conexão SOAP

A configuração de uma conexão SOAP inclui estes campos:

• Nome do Endpoint: Insira um nome usado para identificar a conexão SOAP. O nome deve ser exclusivo para cada conexão SOAP e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint SOAP, que se refere a uma conexão específica e suas atividades.

• Upload URL, Upload File ou Select Existing: Use o botão de opção para selecionar a fonte do arquivo WSDL (Web Services Description Language) para upload ou reutilização. Arquivos de até 5 MB podem ser carregados.

  • URL de upload: Insira a URL do arquivo WSDL na caixa de texto e clique no botão Upload. A URL deve ser acessível sem autenticação ou você receberá um erro. Se estiver carregando um WSDL com o mesmo nome de um WSDL existente, consulte Substituindo um WSDL carregado mais adiante nesta página.

  • Carregar arquivo: Use o botão Navegar à direita para navegar até um arquivo WSDL ou ZIP. Se fornecer um arquivo ZIP, ele deve conter um único arquivo WSDL, embora também possa conter quaisquer arquivos XSD dos quais o WSDL seja dependente. Em seguida, clique no botão Carregar. Se estiver carregando um WSDL com o mesmo nome de um WSDL existente, consulte Substituindo um WSDL carregado mais adiante nesta página.

    Nota

    Qualquer schemaLocation deve ser resolvido para um arquivo local usando uma referência relativa. Isso geralmente significa que, em vez de fornecer uma tupla como esta:

    xsi:schemaLocation='http://schemas.xmlsoap.org/wsdl/mime/ http://ws-i.org/profiles/basic/1.1/wsdlmime-2004-08-24.xsd'
    

    Em vez disso, você forneceria isto:

    xsi:schemaLocation='http://schemas.xmlsoap.org/wsdl/mime/ wsdlmime-2004-08-24.xsd'

    No exemplo acima, o arquivo XSD wsdlmime-2004-08-24.xsd está localizado no mesmo diretório ou em um caminho relativo ao WSDL que está sendo carregado.

  • Selecionar existente: Use o menu suspenso para selecionar um arquivo WSDL existente que tenha sido usado anteriormente no projeto atual.

• Porta: Use o menu suspenso para selecionar a porta apropriada.

• Web Service URL: Insira uma URL válida para o serviço web. Por padrão, este campo é preenchido com a URL do WSDL.

• Serviço e Vinculação: Por padrão, esses campos são preenchidos automaticamente com base no WSDL e na porta fornecidos e não podem ser editados.

• Configurações opcionais: Clique para expandir configurações opcionais adicionais:

  

  • Habilitar codificação de conteúdo: Se selecionado, o cabeçalho Accept-Encoding é enviado com a codificação suportada pelo Harmony. Atualmente, o Gzip é suportado.

  • Habilitar codificação de transferência em blocos: Se selecionado, o cabeçalho Transfer-Encoding: chunked é enviado. Use esta opção se estiver transferindo grandes conjuntos de dados.

  • Send Expect: 100-continue: Se selecionado, o cabeçalho Expect: 100-continue é enviado. Com esta opção, nenhum dado é enviado até que o servidor HTTP tenha validado 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 blocos.

  • Permitir cifras fracas: Marque esta caixa de seleção para se comunicar com servidores HTTP que usam cifras fracas (DES/3DES e RC4).

  • Definir Accept-Encoding para Gzip: Selecionado por padrão, isso informa ao servidor HTTP que o Harmony pode aceitar uma resposta compactada em Gzip. Em troca, o Harmony segue o padrão RFC 1952 e descompacta automaticamente as respostas HTTP Gzip. Se o servidor não usar Gzip, o Harmony verá que a resposta não está compactada e a manipulará normalmente.

    Nota

    Esta configuração não está relacionada ao conector Gzip.

  • Versão SSL: Use o menu suspenso para selecionar uma versão SSL específica se o servidor HTTP exigir.

  • Cabeçalhos de solicitação: Qualquer texto inserido nesta caixa é enviado como um cabeçalho HTTP. Especifique cada cabeçalho em uma linha, a menos que o cabeçalho seja encapsulado de acordo com o padrão HTTP. Este campo também suporta o uso de variáveis globais, variáveis do projeto e variáveis Jitterbit substituindo as variáveis entre colchetes [ ] com seus valores.

• Nome de usuário e Senha: Se aplicável, insira um nome de usuário e uma senha que permitam acesso ao WSDL. Deixe esses campos em branco se nenhum nome de usuário ou senha for necessário.

  Por padrão, o Harmony negocia com o endpoint para determinar quais métodos de autenticação são suportados e usa as credenciais fornecidas em um dos protocolos. O Harmony suporta estas opções de autenticação HTTP:

  • HTTP Básico
  • Resumo HTTP
  • HTTP Digest com autenticação com um sabor IE

• Certificado: Use o menu suspenso para selecionar um certificado disponível para autenticar com o servidor HTTP. Você pode gerenciar certificados SSL do lado do cliente a partir do Management Console em Personalizações > Certificados de cliente.

• Repetir: Funcional somente ao usar um ambiente associado a um grupo de agentes privados, esta configuração é usada para repetir uma solicitação quando um endpoint SOAP retorna um destes códigos de status: 500, 501, 502, 503, ou 504.

  Para que essa configuração entre em vigor, os agentes privados devem ser da versão 10.29 ou posterior. Com versões anteriores do agente, essa configuração é ignorada.

  Selecione a caixa de seleção Repetir para expandir opções de configuração adicionais:

  

  • Intervalo de repetição (segundos): Insira o número de segundos (máximo de 5 segundos) para aguardar entre o reenvio de uma solicitação ao endpoint SOAP.

  • Máx. de Tentativas: Insira o número de vezes (máximo de 5 tentativas) que uma solicitação será reenviada ao endpoint SOAP. Se a solicitação ainda falhar após o número máximo de tentativas, uma exceção com uma mensagem de erro será retornada no log de operação. Além disso, o agente privado registrará cada tentativa no jitterbit.log arquivo de log.

    Cada nova tentativa é tratada como parte da mesma execução de operação, onde apenas um único registro aparece no log de operação. Quaisquer ações de operação configuradas para executar operações abaixo são acionadas com base no status final da operação após novas tentativas até o número máximo de tentativas.

  Nota

  Essas configurações substituem as variáveis Jitterbit jitterbit.web_service_call.retry_wait_seconds e jitterbit.web_service_call.number_of_retries se essas variáveis forem definidas.

• Selecionar métodos: Selecione quaisquer métodos que você deseja que estejam disponíveis para uso como origem ou destino na operação.

  Nota

  Métodos selecionados anteriormente que estão em uso pelas atividades SOAP configuradas não podem ser removidos.

• Atividade Selecionada e Nome de Exibição: Conforme você seleciona os métodos acima, eles são adicionados à tabela abaixo, mostrando cada método selecionado que será renderizado como um bloco de atividade sob a conexão SOAP na paleta de componentes. Para editar um Nome de Exibição, clique no ícone de edição e insira o nome da atividade desejada.

  Nota

  Atividades selecionadas anteriormente que estão atualmente configuradas como um componente do projeto não podem ser removidas.

• Teste: Clique para verificar a conexão usando a configuração fornecida.

• Salvar alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme se deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Substituindo um WSDL carregado

Se substituir um WSDL por recarregar um com o mesmo nome usando Upload URL ou Upload File, suas operações WSDL devem ter o mesmo nome de qualquer uma que esteja atualmente em uso por atividades existentes. Se elas não tiverem o mesmo nome ou se as operações WSDL em uso estiverem faltando no WSDL de substituição, uma mensagem de erro instruirá você a excluir essas atividades primeiro:

Se os critérios de substituição do WSDL descritos acima forem atendidos, uma mensagem de confirmação listará as atividades que podem ser impactadas pela substituição do WSDL para revisar transformações adjacentes para possíveis erros de mapeamento. No reconhecimento da mensagem, o WSDL será substituído em todos os locais onde for usado ao longo do projeto:

Próximos passos

Após uma conexão SOAP ter sido criada, as ações de menu para essa conexão ficam acessíveis na aba Componentes do painel do projeto. Veja menu de ações de conexão para mais detalhes.

Depois de configurar uma conexão SOAP, você pode configurar uma ou mais atividades SOAP associadas a essa conexão para serem usadas como uma origem (para fornecer dados dentro de uma operação) ou como um destino (para consumir dados dentro de uma operação).

Use o menu suspenso Mostrar para filtrar por Endpoints e, em seguida, clique no bloco de conexão SOAP para exibir atividades que estão disponíveis para serem usadas com uma conexão SOAP:

As atividades exibidas correspondem aos métodos selecionados durante a configuração da conexão SOAP.

Para mais informações, consulte Atividades SOAP.