Ir para o conteúdo

Crie uma Fonte HTTP

Introdução

Uma conexão HTTP pode ser configurada e usada como fonte no Jitterbit.

Quando uma conexão HTTP é usada como origem, o Jitterbit Agente envia uma ação HTTP (GET, POST, PUT, DELETE ou CUSTOM) e recupera dados do URL especificado na configuração de origem.

Crie uma Fonte HTTP

Você pode optar por criar uma nova fonte HTTP por conta própria ou em uma operação existente. Para obter mais informações sobre como as fontes funcionam nas operações, consulte Criando uma operação.

Crie uma Nova Fonte HTTP Como Fonte Independente

Dentro do seu projeto no Jitterbit Design Studio, você cria uma nova fonte HTTP por qualquer um dos seguintes:

  • Vá para Arquivo > Novo > Nova Fonte; ou

  • Na árvore à esquerda, clique com o botão direito em Fontes e selecione Nova Fonte; ou

  • Na barra de ferramentas superior, clique no ícone verde da fonte Ícone da fonte.

No pop-up, selecione HTTP como o tipo:

Tipo HTTP

Sua nova fonte aparece em sua própria aba Nova Fonte no painel direito da janela.

Nota

Se você criar uma fonte independente usando qualquer um desses métodos, observe que ela não está conectada a uma operação. Consulte Usar uma fonte HTTP existente em uma operação existente abaixo para usar a nova fonte.

Crie uma Nova Fonte HTTP em uma Operação Existente

Uma origem geralmente é criada por padrão quando você cria uma nova operação. (A exceção é uma operação que consiste apenas em um script.) Com uma operação existente, você pode especificar o tipo de sua origem:

  • Clicar duas vezes no ícone da fonte; no pop-up, selecione Criar nova fonte; ou

  • Clicar com o botão direito no ícone da fonte e selecionar Criar nova fonte.

Na tela de configuração exibida, use o menu suspenso Tipo para selecionar HTTP, conforme mostrado acima.

Use uma Fonte HTTP Existente em uma Operação Existente

Para usar uma origem HTTP existente em uma operação existente com uma origem, você pode defini-la por qualquer um dos seguintes:

  • Dentro da operação, clicar duas vezes no ícone da fonte, e no popup resultante, selecionar a fonte HTTP desejada na lista; ou

  • Dentro da operação, clicar com o botão direito do mouse no ícone da fonte, escolher Select Existing Source, e no popup resultante, selecionar a fonte HTTP desejada na lista; ou

  • Arrastar a fonte HTTP desejada da árvore à esquerda e soltá-la no ícone de origem existente da operação.

Configurar uma Fonte HTTP

Depois de criar uma fonte HTTP, a tela de configuração será aberta na visualização principal do Design Studio. Você pode retornar à tela de configuração a qualquer momento clicando duas vezes no ícone da fonte na operação ou clicando duas vezes na fonte na árvore à esquerda.

Configuração Básica

A tela de configuração será semelhante a este exemplo:

Configuração da fonte HTTP

  • Nome: Insira um nome exclusivo e apropriado para a fonte.

  • Tipo: Use o menu suspenso para selecionar HTTP, se ainda não estiver especificado.

  • Parâmetros de conexão: Especifique os detalhes da sua conexão HTTP:

    • URL: Insira uma URL válida para a fonte. Uma fonte HTTP é definida pela URL do recurso, como http://www.example.com/ups.app/xml/ShipConfirm.

      • Para usar criptografia SSL, use https:// em vez de http:// no URL, como https://www.example.com/ups.app/xml/ShipConfirm.

      • Se parâmetros de consultar forem especificados, forneça-os como seriam em um navegador da web, como https://www.example.com/queryrecord?id=10.

    • Login: Se aplicável, insira o nome de usuário e a senha que permite acesso à URL. Deixe esses campos em branco se nenhum nome de usuário ou senha for necessário.

    • Senha: Digite uma senha para usar com o Login para acessar a URL referenciada no campo URL, se necessário.

  • Ativar opção Repetir: Disponível apenas no Design Studio versões 10.22 e superiores 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, 501, 502, 503, ou 504.

    Para que esta configuração tenha efeito, os Agentes Privados devem ter a versão 10.22 ou superior. Com versões anteriores do agente, a configuração desta configuração será ignorada sem erro.

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

    • Max Retry: Insira o número máximo de tentativas (recomendado não mais que 5 tentativas) que uma solicitação será reenviada ao NetSuite. 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 arquivo de log do Agente Privado jitterbit.log registrará cada nova tentativa.

      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 eventos On Success ou On Failure 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.

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

  • Verbo HTTP: Use o menu suspenso para selecionar GET, POST, PUT, DELETE ou CUSTOM, dependendo dos requisitos do endpoint. Para um POST, uma solicitação vazia é postada na URL e a resposta é usada como fonte.

  • Testar conexão: Clicando no botão Testar conexãoO botão { .icon-inline } testará a fonte HTTP; O Jitterbit executará uma solicitação HTTP HEAD e retornará um erro se não for bem-sucedido. Observe que HEAD pode não ser permitido pelo servidor HTTP referenciado pela URL, mesmo que GET ou POST seja.

  • Clique no botão Salvar na barra de ferramentas principal ou na barra de ferramentas do destino para salvar a configuração.

Opções

Parâmetros de conexão adicionais podem ser especificados clicando em Opções na parte inferior da seção Parâmetros de conexão:

Parâmetros de conexão HTTP

  • Opções de segurança: Para que o Agente use um certificado para autenticar com o hospedar, especifique um certificado apropriado no menu suspenso. (O botão verde à direita do menu suspenso atualizará a lista de certificados disponíveis no Harmony.)

    • 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.)

  • Ignorar Linhas: Os números indicados da primeira e da última linha que devem ser ignorados para cada arquivo. Se houver cabeçalhos ou rodapés a serem ignorados, insira o número de linhas nos campos Primeiro e Último conforme apropriado.

    Nota

    Esta configuração não entra em vigor quando uma fonte HTTP é referenciada a partir de um script usando o ReadFile ou WriteFile funções.

  • Configurações de proxy: Use o menu suspenso para selecionar uma destas opções para um proxy personalizado para o hospedar HTTP:

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

    • Padrão: As configurações de proxy são habilitadas usando a configuração de proxy do Agente 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.

    • Personalizado: As configurações de proxy são habilitadas para esta fonte específica usando informações personalizadas fornecidas aqui. Esta opção ignora a configuração de proxy do Agente se existir. Quando Personalizado é selecionado, estes campos ficam disponíveis:

      Campos adicionais personalizados

      Consulte Ativando proxy para Agentes Privados para obter detalhes sobre esses campos.

      Nota

      Os campos Host, User, Password e NTLM Domain suportam variáveis inseridas na sintaxe de colchetes com agentes 10.66 e mais tarde.

Propriedades Avançadas

Parâmetros avançados adicionais podem ser especificados clicando em Propriedades avançadas na parte inferior da seção Opções. Dizem respeito aos cabeçalhos HTTP enviados com a solicitação e aos parâmetros relacionados ao SSL:

Propriedades avançadas de HTTP

  • Ativar codificação de conteúdo: Se marcada, o cabeçalho "Accept-Encoding" será enviado com a codificação suportada pelo Jitterbit. Atualmente, 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 um cabeçalho HTTP. Especifique um cabeçalho por linha, a menos que o cabeçalho seja agrupado de acordo com o padrão HTTP. Os elementos de dados globais entre colchetes serão substituídos 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:

    Opções de versão HTTP SSL

Variáveis globais de Origem Predefinidas Que Afetam um Envio HTTP

Estas variáveis globais de origem predefinidas afetam fontes HTTP:

  • jitterbit.source.http.max_redirs
  • jitterbit.source.http.request.header._HeaderName_(mostrado no editor de script como jitterbit.source.http.response.header.*)
  • jitterbit.source.http.response
  • jitterbit.source.http.ssl_cert_id
  • jitterbit.source.http.status_code
  • jitterbit.source.http.transfer_timeout

Consulte Variáveis Jitterbit de origem para detalhes.