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

Introdução

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

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

Conectores de aplicação geralmente 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 usarem seu conector de marca com configurações que, de outra forma, podem não estar disponíveis.

Conectores genéricos

O Jitterbit fornece dois conectores genéricos para conexão com 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 será focado 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, o que permite que novos recursos fiquem disponíveis mais rapidamente. O conector HTTP v2 tem suporte para tipos de autenticação adicionais, conexões keep-alive e parâmetros de URL em esquemas de solicitação/resposta. O desenvolvimento futuro se concentrará neste conector.

O Jitterbit suporta conectores HTTP e HTTP v2.

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

Conectores de aplicação

Vários conectores de aplicação 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ê é encorajado a usá-lo em vez de um dos conectores HTTP genéricos. Os conectores de aplicativo geralmente 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 esteja 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 usar conectores de aplicativos ou o conector HTTP v2 em novos projetos 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 para os usuários configurarem.
Connector SDK
Os conectores 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 mais flexibilidade, pois um desenvolvedor pode adicionar aprimoramentos de acordo com as necessidades da sua organização.

Matriz de capacidade para conectores Jitterbit

Capacidade do conector	Conector HTTP v2	Conector HTTP	Conector específico do aplicativo
Suporte de autorização	Uma conexão HTTP v2 suporta estes tipos de autorização: Chave de API Assinatura AWS Autorização Básica Ficha do Portador Autorização de resumo Sem autorização OAuth 2.0	Uma conexão HTTP suporta estes tipos de autorização: Autorização Básica Autorização Digest	O suporte varia de acordo com o conector.
Suporte ao método HTTP	O conector HTTP v2 oferece suporte a esses métodos com essas atividades de mesmo nome: GET POSTAGEM COLOCAR APAGAR PATCH CABEÇA OPÇÕES	O conector HTTP suporta esses métodos com essas atividades de mesmo nome: GET POSTAGEM COLOCAR APAGAR Personalizado (qualquer verbo especificado pelo usuário)	O suporte varia de acordo com o conector.
Suporte ao padrão de operação para atividades usadas como fontes	Atividades HTTP v2 usadas como fonte podem ser usadas com estes padrões: Padrão de Transformação Padrão de arquivo de dois alvos (apenas como primeira fonte) Padrão de arquivo HTTP de dois alvos (apenas como primeira fonte) Padrão de duas transformações (como a primeira ou segunda fonte)	Atividades HTTP usadas como fonte podem ser usadas com estes padrões: Padrão de arquivo Padrão de Transformação Padrão de arquivo de dois alvos (apenas como primeira fonte) Padrão de arquivo HTTP de dois alvos (como a primeira ou segunda fonte) (Veja Nota para atividades HTTP GET abaixo desta tabela.) Padrão de duas transformações (apenas como primeira fonte) Padrão de segmentação em massa do Salesforce	O suporte varia de acordo com o conector. A maioria das atividades de conector específicas do aplicativo usadas como fonte podem ser usadas com estes padrões: Padrão de Transformação Padrão de arquivo de dois alvos (apenas como primeira fonte) Padrão de arquivo HTTP de dois alvos (apenas como primeira fonte) Padrão de duas transformações (como primeira ou segunda fonte)
Suporte ao padrão de operação para atividades usadas como alvos	Atividades HTTP v2 usadas como alvo podem ser usadas com estes padrões: Padrão de Transformação Padrão de duas transformações (como o primeiro ou segundo alvo)	Atividades HTTP usadas como alvo podem ser usadas com estes padrões: Padrão de arquivo Padrão de Script Padrão de Transformação Padrão de arquivo de dois alvos (apenas como o segundo alvo) Padrão de arquivo HTTP de dois alvos (como o primeiro ou segundo alvo) (Veja Nota para atividades HTTP GET abaixo desta tabela.) Padrão de duas transformações (apenas como o segundo alvo) Padrão de origem em massa do Salesforce	O suporte varia de acordo com o conector. A maioria das atividades de conector específicas do aplicativo usadas como alvo podem ser usadas com estes padrões: Padrão de Transformação Padrão de duas transformações (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 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 use o caminho de referência de string para essa atividade de arquivo temporário como `sourceId` ou `targetId` parâmetro de função.	Use o caminho de referência de string para a atividade como `sourceId` ou `targetId` parâmetro de função.	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 `sourceId` ou `targetId` parâmetro de função. Alguns conectores podem ter suporte adicional.
Número de Tentativas	Máximo de 5 tentativas enviadas em um intervalo de até 5 segundos. Suportado somente em agentes privados.	Máximo mais alto (recomendado não mais que 5 tentativas) em um intervalo de até 5 segundos. Suportado somente em agentes privados.	O suporte varia de acordo com o conector.
Tempo limite de transferência	30 segundos por padrão. O `connection-timeout` A chave na área Configurações adicionais da configuração de 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 e variáveis alvo cujos nomes terminam com `http.transfer.timeout` pode ser usado para alterar o tempo limite de transferência.	O suporte varia de acordo com o conector.
Suporte para redirecionamentos	50 redirecionamentos por padrão. O `max-redirect` A chave na área Configurações adicionais da configuração de atividade HTTP v2 pode ser usada para alterar o número de redirecionamentos a serem seguidos.	Os redirecionamentos não são seguidos por padrão. As variáveis de origem Jitterbit e variáveis alvo cujos nomes terminam com `http.max_redirs` pode ser usado para permitir que redirecionamentos sejam seguidos.	O suporte varia de acordo com o conector.
Suporte para dados de formulário	A configuração Multipart do HTTP v2 POST, COLOCAR, e PATCH a configuração da atividade pode ser usada para dar suporte a uploads de formulários RFC 1687 ao usar esquemas padrão. Não suportado com esquemas personalizados.	As variáveis de destino Jitterbit cujos nomes incluem `http.form_data` pode ser usado 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	Os espaços em branco e as quebras de linha da solicitação são deixados inalterados por padrão. O `trailing-linebreaks` A chave na área Configurações adicionais da configuração de atividade HTTP v2 pode ser definida como verdadeira para remover espaços em branco iniciais e finais e quebras de linha.	O `http.remove_trailing_linebreaks`Variável de destino Jitterbit pode ser usado para remover espaços em branco iniciais e finais e quebras de linha.	O suporte varia de acordo com o conector.
Configuração Keep Alive	A configuração Keep Alive em uma conexão HTTP v2 pode ser usado 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 para Cookies	Não suportado.	Suportado somente se estiver usando um agente privado e o `jitterbit.http.enable_cookies` contexto está definido para `true` no arquivo de configuração do agente (`jitterbit.conf`).	O suporte varia de acordo com o conector.
Suporte para certificados personalizados	Não suportado.	Um certificado para autenticação com o servidor HTTP pode ser especificado usando o campo Certificado de uma conexão HTTP.	O suporte varia de acordo com o conector.
Suporte para Expect: 100-continue	Não suportado.	O cabeçalho Expect: 100 continue é enviado quando Send `Expect 100-continue`é selecionado em uma conexão HTTP.	O suporte varia de acordo com o conector.
Suporte para Cifras Fracas	Não suportado.	Servidores HTTP que usam cifras fracas (DES/3DES e RC4) podem ser usados quando Permitir Cifras Fracas é selecionado em uma conexão HTTP.	O suporte varia de acordo com o conector.
Suporte para plugins Jitterbit	Não suportado.	Os plugins Jitterbit estão disponíveis para configuração durante a última etapa da configuração da atividade HTTP (consulte Plugins adicionados a uma atividade).	Não suportado.
Suporte para registro em Agentes privados	O conector HTTP v2 suporta registro detalhado do conector.	O conector HTTP suporta registro de depurar Curl.	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 e JavaScript baseadas em arquivo

As funções Jitterbit e JavaScript baseadas em arquivo 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 aplicativo, grave os dados em um arquivo temporário e use esse arquivo temporário na função de script.

Funções Jitterbit

Funções JavaScript Jitterbit