Conexão SOAP

Introdução

Uma conexão SOAP, criada usando o conector SOAP, estabelece conexões usando o Protocolo Simples de Acesso a Objetos (SOAP). Após a configuração de uma conexão, você pode criar instâncias de atividades SOAP associadas a ela para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (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).
• A página Global Endpoints (consulte Criar um endpoint global em Endpoints globais).

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).
• A página Endpoints globais (consulte Editar um endpoint global em Endpoints globais).

Configurar uma conexão SOAP

Cada elemento da interface do usuário da tela de configuração da conexão SOAP é descrito abaixo.

• Nome da conexão: Insira um nome 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.

• Carregar URL, Carregar arquivo ou Selecionar existente: Use o botão de opção para selecionar a origem do arquivo WSDL a ser carregado ou reutilizado. 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, caso contrário, você receberá uma mensagem de erro. Se estiver enviando um WSDL com o mesmo nome de um WSDL existente, consulte Substituir um WSDL enviado mais adiante nesta página.

  • Carregar arquivo: Clique em Procurar para selecionar um arquivo WSDL ou ZIP. Um arquivo ZIP deve conter um arquivo WSDL e pode incluir arquivos XSD dos quais o WSDL depende. Em seguida, clique em Carregar. Para carregar um WSDL com o mesmo nome de um existente, consulte Substituir um WSDL carregado abaixo.

    Nota

    Qualquer schemaLocation deve apontar 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'
    

    Este deve ser fornecido em seu lugar:

    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: Escolha entre arquivos WSDL usados anteriormente no projeto atual.

• Porta: Selecione a porta apropriada no menu suspenso.

  Nota

  Ao editar uma conexão, este campo será desabilitado se você já tiver atividades para o endpoint em uso.

• URL do serviço web: Insira a URL do serviço web. Por padrão, este campo é preenchido com a URL do WSDL.

• Serviço e Vinculação: Esses campos são preenchidos automaticamente com base no WSDL e na porta e não podem ser editados.

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

  

  • Habilitar codificação de conteúdo: Quando selecionado, envia o cabeçalho Accept-Encoding com codificação compatível com Harmony (atualmente Gzip).

  • Habilitar codificação de transferência em blocos: Quando selecionado, envia o cabeçalho_Transfer-Encoding: chunked_. Isso é útil ao transferir grandes conjuntos de dados.

  • Enviar Expect: 100-continue: Quando selecionado, envia o cabeçalho_Expect: 100-continue_. Isso garante que o servidor HTTP valide os cabeçalhos antes do envio de qualquer dado. Isso é útil para enviar grandes quantidades de dados sem codificação de transferência em blocos.

  • Permitir cifras fracas: Selecione para se comunicar com servidores HTTP usando cifras fracas (DES/3DES e RC4).

  • Definir Accept-Encoding como Gzip: Selecionado por padrão, isso informa ao servidor HTTP que o Harmony pode aceitar respostas compactadas em Gzip. O Harmony segue o padrão RFC 1952 e descompacta automaticamente as respostas HTTP em 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: Selecione uma versão SSL específica se o servidor HTTP exigir.

  • Cabeçalhos de Solicitação: Insira cabeçalhos HTTP, com cada cabeçalho em sua própria linha, a menos que sejam encapsulados de acordo com os padrões HTTP. Este campo suporta variáveis globais, variáveis do projeto e variáveis Jitterbit usando colchetes [ ].

• Nome de usuário e Senha: Insira as credenciais para acessar o WSDL, se necessário. Deixe em branco se não for necessária autenticação.

  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 oferece suporte às seguintes opções de autenticação HTTP:

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

• Certificado: Selecione um certificado para autenticação com o servidor HTTP. Você pode gerenciar certificados SSL do lado do cliente no Management Console em Personalizações > Certificados de cliente.

• Repetir: Esta configuração só funciona com ambientes que usam um grupo de agentes privados. Ele repete solicitações quando um endpoint SOAP retorna esses códigos de status: 500, 501, 502, 503, ou 504.

  Agentes privados devem ter a versão 10.29 ou posterior para que este recurso funcione. Versões anteriores do agente ignoram esta configuração.

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

  

  • Intervalo de nova tentativa (segundos): Insira quanto tempo esperar (máximo de 5 segundos) entre as tentativas de nova tentativa.

  • Máximo de tentativas: Insira quantas vezes (máximo 5) a solicitação deve ser repetida. Se a solicitação ainda falhar após todas as tentativas, uma exceção será exibida no log de operação. O agente privado também registra cada tentativa no log. jitterbit.log arquivo.

    Todas as tentativas contam como parte da mesma execução de operação, com um único registro no log de operação. Quaisquer ações de operação para operações abaixo acionadas com base no status final após todas as tentativas.

  Nota

  Estas 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 estiverem definidas.

• Selecionar métodos: Selecione quaisquer métodos que você deseja disponibilizar como fontes ou destinos nas operações.

  Nota

  Você não pode remover métodos selecionados anteriormente que já estejam em uso por atividades SOAP.

• 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 digite um novo nome.

  Nota

  Atividades selecionadas anteriormente que estão 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 fechá-la sem salvar. Uma mensagem solicitará 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 solicitará que você confirme se deseja excluir a conexão.

Substituir um WSDL carregado

Ao substituir um WSDL enviando um com o mesmo nome, suas operações WSDL devem ter o mesmo nome de quaisquer outras que estejam em uso pelas atividades existentes. Se o nome não for o mesmo ou se as operações WSDL em uso estiverem ausentes no WSDL de substituição, a seguinte mensagem de erro instruirá você a excluir essas atividades primeiro e listará quais atividades precisam ser excluídas:

Após a exclusão, a seguinte mensagem de confirmação lista as atividades que podem ser impactadas pela substituição do WSDL para revisar as transformações adjacentes em busca de possíveis erros de mapeamento. Após a confirmação da mensagem, o WSDL será substituído em todos os locais onde for utilizado ao longo do projeto:

Próximos passos

As ações de menu para uma conexão e seus tipos de atividade podem ser acessadas no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

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 a uma operação ou como um destino para consumir dados em uma operação, ou você pode usar a conexão SOAP em um script.

Para mais informações, consulte Atividades SOAP.