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

Introdução

Vários conectores do Studio podem ser usados para se conectar 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 diversos conectores específicos de aplicações. Conectores REST personalizados também podem ser criados.

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

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

Conectores genéricos

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

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. Foi reconstruído para permitir 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 será focado neste conector.

O Jitterbit suporta ambos os 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á cronograma para descontinuação e o conector HTTP permanece totalmente suportado. Recomendamos que você converta conexões e atividades HTTP existentes para HTTP v2 quando possível.

Conectores de aplicações

Diversos conectores de aplicações estão disponíveis e continuam sendo desenvolvidos.

Na maioria dos casos, se um conector de aplicação estiver disponível para seu endpoint, recomenda-se usá-lo em vez de um dos conectores HTTP genéricos. Conectores de aplicações 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 da aplicação, usar um conector genérico é uma alternativa lógica.

Considerando a intenção do Jitterbit de eventualmente descontinuar o conector HTTP, recomendamos usar conectores de aplicações ou o conector HTTP v2 em novos designs de 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
Conectores do Connector Builder personalizados 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
Conectores do Connector SDK personalizados podem ser projetados para usar qualquer tipo de autenticação, e suporte para qualquer método pode ser integrado ao conector. Este tipo de conector personalizado oferece a máxima 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 Aplicação
Suporte de Autorização	Uma conexão HTTP v2 suporta estes tipos de autorização: Chave de API Assinatura AWS Autorização Básica Token de Portador Autorização Digest Autorização Hawk Sem Autorização Autorização NTLM OAuth 2.0 (2 e 3 pernas)	Uma conexão HTTP suporta estes tipos de autorização: Autorização Básica Autorização Digest	O suporte varia por conector.
Suporte de Método HTTP	O conector HTTP v2 suporta estes métodos com atividades de mesmo nome: GET POST PUT DELETE PATCH HEAD OPTIONS	O conector HTTP suporta estes métodos com atividades de mesmo nome: GET POST PUT DELETE Personalizado (qualquer verbo especificado pelo usuário)	O suporte varia por conector.
Suporte de 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 com Dois Destinos (apenas como primeira fonte) Padrão de Arquivo HTTP com Dois Destinos (apenas como primeira fonte) Padrão com Duas Transformações (como 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 com Dois Destinos (apenas como primeira fonte) Padrão de Arquivo HTTP com Dois Destinos (como primeira ou segunda fonte) (Veja Nota para Atividades HTTP GET abaixo desta tabela.) Padrão com Duas Transformações (apenas como primeira fonte) Padrão de Destino em Lote do Salesforce	O suporte varia por conector. A maioria das atividades de conector específico de aplicação usadas como fonte pode ser usada com estes padrões: Padrão de Transformação Padrão de Arquivo com Dois Destinos (apenas como primeira fonte) Padrão de Arquivo HTTP com Dois Destinos (apenas como primeira fonte) Padrão com Duas Transformações (como primeira ou segunda fonte)
Suporte de Padrão de Operação para Atividades Usadas como Destinos	Atividades HTTP v2 usadas como destino podem ser usadas com estes padrões: Padrão de Transformação Padrão com Duas Transformações (como primeiro ou segundo destino)	Atividades HTTP usadas como destino podem ser usadas com estes padrões: Padrão de Arquivo Padrão de Script Padrão de Transformação Padrão de Arquivo com Dois Destinos (apenas como segundo destino) Padrão de Arquivo HTTP com Dois Destinos (como primeiro ou segundo destino) (Veja Nota para Atividades HTTP GET abaixo desta tabela.) Padrão com Duas Transformações (apenas como segundo destino) Padrão de Fonte em Lote do Salesforce	O suporte varia por conector. A maioria das atividades de conector específico de aplicação usadas como destino pode ser usada com estes padrões: Padrão de Transformação Padrão com Duas Transformações (como primeiro ou segundo destino)
Suporte de Schema	Schemas 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 schemas personalizados não forem fornecidos na configuração da atividade, serão usados schemas padrão que suportam um design geral de API REST.	Schemas 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 por conector. Schemas de solicitação e resposta podem ser gerados diretamente do endpoint ou suporte a schemas personalizados pode estar disponível.
Funções Jitterbit e JavaScript Baseadas em Arquivo	Escreva os dados em um arquivo temporário e 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`.	Escreva os dados em um arquivo temporário e 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 intervalos de até 5 segundos. Suportado apenas em agentes privados.	Máximo superior (recomenda-se não mais de 5 tentativas) em intervalos de até 5 segundos. Suportado apenas em agentes privados.	O suporte varia por conector.
Tempo Limite de Transferência	30 segundos por padrão. A chave `connection-timeout` na área 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 fonte Jitterbit e variáveis de destino cujos nomes terminam com `http.transfer.timeout` podem ser usadas para alterar o tempo limite de transferência.	O suporte varia por conector.
Suporte para Redirecionamentos	50 redirecionamentos por padrão. A chave `max-redirect` na área 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 fonte Jitterbit e variáveis de destino cujos nomes terminam com `http.max_redirs` podem ser usadas para permitir que redirecionamentos sejam seguidos.	O suporte varia por conector.
Suporte para Dados de Formulário	A configuração Multipart da configuração de atividade HTTP v2 POST, PUT e PATCH pode ser usada para suportar uploads de formulário RFC 1687 ao usar schemas padrão. Não suportado com schemas personalizados.	As variáveis de destino Jitterbit cujos nomes incluem `http.form_data` podem ser usadas com uploads de formulário RFC 1687.	O suporte varia por conector.
Suporte para Remover Espaços em Branco Finais 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 Configurações Adicionais da configuração da atividade HTTP v2 pode ser definida como true para remover espaços em branco e quebras de linha iniciais e finais.	A variável de destino Jitterbit `http.remove_trailing_linebreaks` pode ser usada para remover espaços em branco e quebras de linha iniciais e finais.	O suporte varia por conector.
Configuração de Keep Alive	A configuração Keep Alive em uma conexão HTTP v2 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 por conector.
Suporte para Cookies	Não suportado.	Suportado apenas se usar um agente privado e a configuração `jitterbit.http.enable_cookies` estiver definida como `true` no arquivo de configuração do agente (`jitterbit.conf`).	O suporte varia por conector.
Suporte para 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.	O suporte varia por 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.	O suporte varia por conector.
Suporte para Cifras Fracas	A configuração Adicionar Cifras em uma conexão HTTP v2 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.	O suporte varia por conector.
Suporte para Plugins Jitterbit	Não suportado.	Plugins Jitterbit estão disponíveis para configurar na última etapa da configuração da atividade HTTP (veja Plugins Adicionados a uma Atividade).	Não suportado.
Suporte para Logging em Agentes Privados	O conector HTTP v2 suporta logging detalhado do conector.	O conector HTTP suporta logging de debug Curl.	O suporte varia por conector.

Observação 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 com 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 HTTP v2 e conectores de aplicação, escreva os dados em um arquivo temporário e depois use esse arquivo temporário na função de script.

Funções Jitterbit

Funções Jitterbit JavaScript