Conexão HTTP¶

Introdução¶

Uma conexão HTTP, criada usando o conector HTTP, estabelece acesso pelo protocolo HTTP ou HTTPS a um serviço como REST API, GraphQL API ou formulário web. Depois que uma conexão for configurada, você poderá criar instâncias de atividades HTTP associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Crie Ou Edite uma Conexão HTTP¶

Uma nova conexão HTTP é criada usando o conector HTTP 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 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 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 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¶

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

• Nome da conexão: Insira um nome a ser usado para identificar a conexão. 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 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 antes de reenviar uma solicitação para o endpoint HTTP.

  • Max Retries: Insira o número máximo de vezes (recomendado não mais que 5 vezes) para tentar novamente enviar uma solicitação ao 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.

    Nota

    Esta configuração não entra em vigor quando as atividades HTTP são referenciadas a partir de um script usando o ReadFile ou WriteFile funções.

  • 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, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade podem ser acessados 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.

• PEGAR: Recupera informações sobre um recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

• COLOCAR: Substitui um recurso existente em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

• PUBLICAR: Cria um novo recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

• EXCLUIR: Exclui um recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

• Personalizado: Executa um método HTTP especificado em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.