Conexão HTTP¶

Introdução¶

Uma conexão HTTP é configurada usando o conector HTTP, estabelecendo acesso a um serviço web HTTP ou HTTPS (incluindo serviços web RESTful). Depois que uma conexão for estabelecida, você poderá configurar uma ou mais atividades HTTP associadas a essa conexão para serem usadas como origem para fornecer dados a uma operação ou script ou como destino para consumir dados em uma operação ou script.

Crie Ou Edite uma Conexão HTTP¶

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

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A página Conexões globais (consulte Criar uma conexão global em Conexões Globais).

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

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).
• A página Conexões globais (consulte Editar uma conexão global em Conexões Globais).

Configurar uma Conexão HTTP¶

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

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

• URL base: Insira um URL base válido para a conexão. Para usar a criptografia SSL, basta usar https:// na URL. Não inclua nenhum parâmetro ou caminho de consultar, a menos que eles sejam usados para todas as atividades associadas (você poderá especificar caminhos e parâmetros exclusivos durante a configuração da atividade). O URL final será concatenado do URL Base fornecido aqui junto com quaisquer caminhos especificados durante a configuração da atividade.

• Nome de usuário e Senha: Se aplicável, insira um nome de usuário e uma senha que permitirão o acesso ao servidor HTTP. Você pode deixar esses campos em branco para autenticação anônima se nenhum nome de usuário ou senha for necessário.

• Certificado: Use o menu suspenso para selecionar um certificado disponível 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.

• Tentar novamente: Funcional apenas ao usar um ambiente associado a um Grupo de Agentes Privados, esta configuração é usada para tentar novamente uma solicitação quando um endpoint HTTP retorna um destes códigos de status: 500, 502, 503, ou 504.

  Esta configuração entra em vigor quando usada com Agentes Privados versão 10.22 ou posterior.

  Nota

  Para Agentes Privados versão 10.30 a 10.33, o RecoverableStatusCode configuração e a lista de códigos de erro devem ser adicionadas manualmente ao arquivo de configuração do Agente Privado.

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

  

  • Intervalo de Novas Tentativas (Segundos): Insira o número de segundos (máximo de 5 segundos) para esperar entre o reenvio de uma solicitação para o endpoint HTTP.

  • Max Retries: Insira o número máximo de tentativas (recomendado não mais que 5 tentativas) que uma solicitação será reenviada para o endpoint HTTP. 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 da operação. Além disso, o Agente Privado registrará cada nova 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 configurados para executar operações abaixo são acionados com base no status final da operação após novas tentativas até o número máximo de tentativas.

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

  

  • Opção de segurança: Se aplicável, selecione Usar autenticação HTTP básica para autenticar com o hospedar usando autenticação HTTP básica sem criptografia SSL. Observe que se esta opção for utilizada, a senha fornecida será enviada em texto não criptografado. (A menos que seja necessário, isso não é recomendado.)

    Se esta opção não for usada, 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. Além do HTTP Basic, o Harmony oferece suporte a estas opções de autenticação HTTP:

    • Resumo HTTP

    • HTTP Digest com autenticação com sabor IE

  • Ignorar linhas: Se houver cabeçalhos e/ou rodapés nos dados de origem que você deseja que sejam ignorados, insira o número de linhas a serem ignoradas em Primeira e Última Campos.

  • Configurações de proxy: Se você quiser especificar um proxy personalizado, use o menu suspenso para selecionar uma destas opções:

    • Padrão: As configurações de proxy são habilitadas, usando a Configuração de proxy do Agente Privado se existir. Se as configurações de proxy não forem especificadas na configuração do agente, a configuração Padrão terá o mesmo resultado que a configuração Desativar.

    • Desativar: As configurações de proxy estão desativadas para esta conexão específica, ignorando a configuração de proxy do Agente Privado se existir.

    • Personalizado: As configurações de proxy são habilitadas para esta conexão específica usando informações personalizadas fornecidas aqui. Esta opção ignora a configuração de proxy do Agente Privado se existir e, em vez disso, usa informações de proxy personalizadas. Quando Personalizado é selecionado, campos adicionais ficam disponíveis para você configurar. Para obter detalhes sobre esses campos, consulte Ativando proxy para Agentes Privados.

      Nota

      Campos adicionais com um ícone de variável suporta variáveis com agentes 10.66 e posteriores.

  • Propriedades HTTP avançadas: Se aplicável, defina estas opções avançadas:

    • Content-Type: Insira o tipo de conteúdo da estrutura de solicitação que é esperado pela API específica. Se o método usado não aceitar dados estruturados ou se a API não exigir que o tipo de conteúdo seja especificado, você poderá deixar este campo em branco. Exemplos de tipos de conteúdo incluem text/plain, application/json, application/x-www-form-urlencoded, etc.

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

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

    • Enviar Expect 100-continue: Se selecionado, o cabeçalho Expect: 100-continue será enviado. Com esta opção, nenhum dado é 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.

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

    • HTTP Accept Encoding Gzip: Selecionada por padrão, esta opção informa ao servidor HTTP que o Harmony pode aceitar um arquivo compactado em Gzip resposta. 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 tratará normalmente.

      Nota

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

    • Aplicável apenas ao usar HTTPS: Use o menu suspenso para selecionar uma versão SSL específica se o servidor HTTP exigir. O padrão é Negociar.

    • Cabeçalhos de solicitação (uma linha por cabeçalho): 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 agrupado 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 variáveis entre colchetes [ ] com seus valores.

• Teste: Clique para verificar a conexão enviando uma solicitação HTTP GET sem autorização.

• 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 que 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 solicita que você confirme que deseja excluir a conexão.

Próximos Passos¶

Após a criação de uma conexão HTTP, as ações de menu para essa conexão estarão acessíveis na guia Componentes do aba do projeto. Consulte Menu Ações de conexão para detalhes.

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

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

Para obter mais informações, consulte Atividades HTTP, que abrange atividades GET, PUT, POST, DELETE e Custom.