Ir para o conteúdo

Considerações sobre conectores baseados em REST no Jitterbit Integration Studio

Introdução

Vários conectores do Integration Studio podem ser usados para se conectar a serviços web RESTful, também conhecidos como APIs REST. Esta página fornece considerações para escolher qual conector usar, selecionando entre dois conectores HTTP genéricos ou numerosos conectores específicos de aplicativos. Conectores REST personalizados também podem ser criados.

Considerações de alto nível e futura descontinuação

Conectores de aplicativos frequentemente incluem recursos específicos de endpoint que são mais fáceis de configurar usando o conector específico em vez dos conectores genéricos. No entanto, os conectores genéricos geralmente permitem mais flexibilidade na configuração. Conectores personalizados oferecem opções adicionais que exigem trabalho inicial para criar, mas facilitam para os usuários utilizarem seu conector de marca com configurações que podem não estar disponíveis de outra forma.

Conectores genéricos

O Jitterbit fornece dois conectores genéricos para se conectar a APIs REST:

  • HTTP: O conector HTTP é o conector HTTP original do Jitterbit, cujo código subjacente está em uso há mais de uma década. Este conector é comprovado e confiável, mas é difícil de estender e manter. Portanto, o desenvolvimento futuro não se concentrará neste conector.
  • HTTP v2: O conector HTTP v2 é a próxima versão do conector HTTP do Jitterbit. Ele foi reconstruído usando o Connector SDK extensível do Jitterbit, que permite que novos recursos fiquem disponíveis mais rapidamente. O conector HTTP v2 tem suporte para tipos adicionais de autenticação, conexões keep-alive e parâmetros de URL em esquemas de solicitação/resposta. O desenvolvimento futuro se concentrará neste conector.

Jitterbit suporta tanto os conectores HTTP quanto os conectores HTTP v2.

A intenção de longo prazo da Jitterbit é descontinuar o conector HTTP, o que será anunciado de acordo com a política de fim de vida da Jitterbit. No momento, não há um cronograma para a descontinuação e o conector HTTP continua totalmente suportado. Recomendamos que você converta conexões e atividades HTTP existentes para HTTP v2 sempre que possível.

Conectores de Aplicativo

Numerosos conectores de aplicativo estão disponíveis e continuam a ser desenvolvidos.

Na maioria dos casos, se um conector de aplicativo estiver disponível para seu endpoint, você é incentivado a usá-lo em vez de um dos conectores HTTP genéricos. Os conectores de aplicativo frequentemente incluem recursos específicos do endpoint que são mais fáceis de configurar usando o conector específico em vez dos conectores genéricos. No entanto, se você tiver uma necessidade específica que não está disponível no endpoint do aplicativo, usar um conector genérico é uma alternativa lógica.

Considerando a intenção da Jitterbit de eventualmente descontinuar o conector HTTP, recomendamos o uso de conectores de aplicativo ou do conector HTTP v2 em novos designs de projeto sempre que possível.

Conectores Personalizados

Para maior flexibilidade, você pode criar conectores personalizados usando o Connector Builder ou o Connector SDK:

  • Connector Builder
    Os conectores do Custom Connector Builder podem ser projetados para usar autenticação básica ou nenhuma autenticação. Durante a criação do conector, você seleciona entre os métodos HTTP suportados de GET, POST, PUT, DELETE, PATCH ou MERGE para criar as atividades correspondentes que os usuários podem configurar.
  • Connector SDK
    Os conectores do Custom Connector SDK podem ser projetados para usar qualquer tipo de autenticação, e o suporte para qualquer método pode ser incorporado ao conector. Esse tipo de conector personalizado oferece a maior flexibilidade, pois um desenvolvedor pode adicionar melhorias de acordo com as necessidades da sua organização.

Matriz de capacidades para conectores Jitterbit

Capacidade do Conector Conector HTTP v2 Conector HTTP Conector específico de aplicativo
Suporte à Autorização

Uma conexão HTTP v2 suporta os seguintes tipos de autorização:

Uma conexão HTTP suporta os seguintes tipos de autorização:

  • Autorização Básica
  • Autorização Digest

 O suporte varia de acordo com o conector.
Suporte a Métodos HTTP

O conector HTTP v2 suporta os seguintes métodos com essas atividades de mesmo nome:

O conector HTTP suporta os seguintes métodos com essas atividades de mesmo nome:

O suporte varia de acordo com o conector.
Suporte a Padrões de Operação para Atividades Usadas como Fontes

Atividades HTTP v2 usadas como fonte podem ser usadas com os seguintes padrões:

  • [Padrão de Transformação][TransformationPattern]
  • [Padrão de Arquivo de Dois Alvos][TwoTargetArchivePattern] (apenas como a primeira fonte)
  • [Padrão de Arquivo HTTP de Dois Alvos][TwoTargetHTTPArchivePattern] (apenas como a primeira fonte)
  • [Padrão de Duas Transformações][TwoTransformationPattern] (como a primeira ou segunda fonte)

Atividades HTTP usadas como fonte podem ser usadas com os seguintes padrões:

  • [Padrão de Arquivo][ArchivePattern]
  • [Padrão de Transformação][TransformationPattern]
  • [Padrão de Arquivo de Dois Alvos][TwoTargetArchivePattern] (apenas como a primeira fonte)
  • [Padrão de Arquivo HTTP de Dois Alvos][TwoTargetHTTPArchivePattern] (como a primeira ou segunda fonte)
    (Veja [Nota para Atividades HTTP GET][HTTPGETNote] abaixo desta tabela.)
  • [Padrão de Duas Transformações][TwoTransformationPattern] (apenas como a primeira fonte)
  • [Padrão de Alvo em Massa do Salesforce][SalesforceBulkTargetPattern]

O suporte varia de acordo com o conector.

A maioria das atividades de conectores específicos de aplicativo usadas como fonte pode ser usada com os seguintes padrões:

  • [Padrão de Transformação][TransformationPattern]
  • [Padrão de Arquivo de Dois Alvos][TwoTargetArchivePattern] (apenas como a primeira fonte)
  • [Padrão de Arquivo HTTP de Dois Alvos][TwoTargetHTTPArchivePattern] (apenas como a primeira fonte)
  • [Padrão de Duas Transformações][TwoTransformationPattern] (como a primeira ou segunda fonte)
Suporte a Padrões de Operação para Atividades Usadas como Alvos

Atividades HTTP v2 usadas como alvo podem ser usadas com os seguintes padrões:

  • [Padrão de Transformação][TransformationPattern]
  • [Padrão de Duas Transformações][TwoTransformationPattern] (como o primeiro ou segundo alvo)

Atividades HTTP usadas como alvo podem ser usadas com os seguintes padrões:

  • [Padrão de Arquivo][ArchivePattern]
  • [Padrão de Script][ScriptPattern]
  • [Padrão de Transformação][TransformationPattern]
  • [Padrão de Arquivo de Dois Alvos][TwoTargetArchivePattern] (apenas como o segundo alvo)
  • [Padrão de Arquivo HTTP de Dois Alvos][TwoTargetHTTPArchivePattern] (como o primeiro ou segundo alvo)
    (Veja [Nota para Atividades HTTP GET][HTTPGETNote] abaixo desta tabela.)
  • [Padrão de Duas Transformações][TwoTransformationPattern] (apenas como o segundo alvo)
  • [Padrão de Fonte em Massa do Salesforce][SalesforceBulkTargetPattern]

O suporte varia de acordo com o conector.

A maioria das atividades de conectores específicos de aplicativo usadas como alvo pode ser usada com os seguintes padrões:

  • [Padrão de Transformação][TransformationPattern]
  • [Padrão de Duas Transformações][TwoTransformationPattern] (como o primeiro ou segundo alvo)
Suporte a Esquemas

Esquemas de solicitação e resposta personalizados são opcionais e podem ser fornecidos pelo usuário durante a configuração da atividade HTTP v2.

Se esquemas personalizados não forem fornecidos na configuração da atividade, esquemas padrão que suportam um design geral de API REST serão usados.

 Esquemas de solicitação e resposta personalizados são opcionais e podem ser fornecidos pelo usuário durante a configuração da atividade HTTP.

O suporte varia de acordo com o conector.

Esquemas de solicitação e resposta podem ser gerados diretamente do endpoint ou o suporte a esquemas personalizados pode estar disponível.
Funções Jitterbit e JavaScript baseadas em Arquivo Grave os dados em um arquivo temporário e, em seguida, use o caminho de referência de string para essa atividade de arquivo temporário como o parâmetro de função sourceId ou targetId. Use o caminho de referência de string para a atividade como o parâmetro de função sourceId ou targetId.

Grave os dados em um arquivo temporário e, em seguida, use o caminho de referência de string para essa atividade de arquivo temporário como o parâmetro de função sourceId ou targetId.

Alguns conectores podem ter suporte adicional.
Número de Tentativas Máximo de 5 tentativas enviadas em até 5 segundos de intervalo. Suportado apenas em agentes privados. Máximo mais alto (recomendado não mais que 5 tentativas) em até 5 segundos de intervalo. Suportado apenas em agentes privados. O suporte varia de acordo com o conector.
Tempo Limite de Transferência

30 segundos por padrão.

A chave connection-timeout na área de Configurações Adicionais da configuração da atividade HTTP v2 pode ser usada para alterar o tempo limite de transferência.

3.600 segundos por padrão.

As [variáveis de origem Jitterbit][JitterbitSourceVariables] e [variáveis de destino][JitterbitTargetVariables] cujos nomes terminam com http.transfer.timeout podem ser usadas para alterar o tempo limite de transferência.

 O suporte varia de acordo com o conector.
Suporte a Redirecionamentos

50 redirecionamentos por padrão.

A chave max-redirect na área de Configurações Adicionais da configuração da atividade HTTP v2 pode ser usada para alterar o número de redirecionamentos a seguir.

Redirecionamentos não são seguidos por padrão.

As [variáveis de origem Jitterbit][JitterbitSourceVariables] e [variáveis de destino][JitterbitTargetVariables] cujos nomes terminam com http.max_redirs podem ser usadas para permitir que os redirecionamentos sejam seguidos.

 O suporte varia de acordo com o conector.
Suporte a Dados de Formulário

A configuração Multipart do POST, PUT e PATCH da atividade HTTP v2 pode ser usada para suportar uploads de formulário RFC 1687 ao usar esquemas padrão.

Não suportado com esquemas personalizados.

 As [variáveis de destino Jitterbit][JitterbitTargetVariables] cujos nomes incluem http.form_data podem ser usadas com uploads de formulário RFC 1687. O suporte varia de acordo com o conector.
Suporte para Remoção de Espaços em Branco e Quebras de Linha

Espaços em branco e quebras de linha da solicitação são deixados inalterados por padrão.

A chave trailing-linebreaks na área de Configurações Adicionais da configuração da atividade HTTP v2 pode ser definida como verdadeira para remover espaços em branco e quebras de linha iniciais e finais.

 A variável de destino Jitterbit [http.remove_trailing_linebreaks][JitterbitTargetVariables] pode ser usada para remover espaços em branco e quebras de linha iniciais e finais. O suporte varia de acordo com o conector.
Configuração de Manter Conexão A configuração Manter Conexão em uma [conexão HTTP v2][HTTPv2Connection] pode ser usada para manter uma única conexão TCP aberta para múltiplas solicitações e respostas HTTP. Não suportado. O suporte varia de acordo com o conector.
Suporte a Cookies Não suportado. Suportado apenas se usando um [agente privado][PrivateAgent] e a configuração [jitterbit.http.enable_cookies][PreDefGlobalVars] estiver definida como true no [arquivo de configuração do agente (jitterbit.conf)][JitterbitConf]. O suporte varia de acordo com o conector.
Suporte a Certificados Personalizados Não suportado. Um certificado para autenticar com o servidor HTTP pode ser especificado usando o campo Certificado de uma [conexão HTTP][HTTPConnection]. O suporte varia de acordo com o conector.
Suporte para Expect: 100-continue Não suportado. O cabeçalho Expect: 100 continue é enviado quando Enviar Expect 100-continue é selecionado em uma [conexão HTTP][HTTPConnection]. O suporte varia de acordo com o conector.
Suporte a Cifras Fracas A configuração Adicionar Cifras em uma [conexão HTTP v2][HTTPv2Connection] pode ser usada para definir manualmente cifras fracas. Servidores HTTP que usam cifras fracas (DES/3DES e RC4) podem ser usados quando Permitir Cifras Fracas é selecionado em uma [conexão HTTP][HTTPConnection]. O suporte varia de acordo com o conector.
Suporte a Plugins Jitterbit Não suportado. Plugins Jitterbit estão disponíveis para configuração durante a última etapa da configuração da atividade HTTP (veja [Plugins Adicionados a uma Atividade][PluginsAdded]). Não suportado.
Suporte para Registro em Agentes Privados O conector HTTP v2 suporta [registro detalhado do conector][VerboseLogging]. O conector HTTP suporta [registro de depuração Curl][CurlDebugLogging]. O suporte varia de acordo com o conector.

Nota para atividades HTTP GET

Quando uma atividade HTTP GET é usada como Atividade de Destino 1 / Atividade de Origem 2 no padrão de arquivo HTTP de dois destinos, a atividade retorna uma mensagem indicando sucesso {"success": true} ou falha {"success": false} em vez da resposta real.

Funções Jitterbit baseadas em arquivos e JavaScript

As funções Jitterbit baseadas em arquivos e JavaScript estão listadas abaixo. As atividades do conector HTTP podem ser usadas diretamente como um parâmetro de função. Para uso com conectores HTTP v2 e de aplicativos, escreva os dados em um arquivo temporário e, em seguida, use esse arquivo temporário na função de script.

Funções Jitterbit

Funções Jitterbit em JavaScript