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 requerem trabalho inicial para serem criadas, mas facilitam o uso do conector da sua 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 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, que permite que novos recursos se tornem 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 será focado 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 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 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
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: Chave de API Assinatura AWS Autorização Básica Token Bearer Autorização Digest Sem Autorização OAuth 2.0	Uma conexão HTTP suporta os seguintes tipos de autorização: Autorização Básica Autorização Digest	O suporte varia conforme o conector.
Suporte a Métodos HTTP	O conector HTTP v2 suporta estes métodos com estas atividades de mesmo nome: GET POST PUT DELETE PATCH HEAD OPTIONS	O conector HTTP suporta estes métodos com estas atividades de mesmo nome: GET POST PUT DELETE Personalizado (qualquer verbo especificado pelo usuário)	O suporte varia conforme o conector.
Suporte a Padrões 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 a primeira fonte) Padrão de Arquivo HTTP de Dois Alvos (apenas como a 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 a 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 a primeira fonte) Padrão de Alvo em Massa do Salesforce	O suporte varia conforme o conector. A maioria das atividades de conectores específicos de aplicativo usadas como fonte pode ser usada com estes padrões: Padrão de Transformação Padrão de Arquivo de Dois Alvos (apenas como a primeira fonte) Padrão de Arquivo HTTP de Dois Alvos (apenas como a primeira fonte) Padrão de Duas Transformações (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 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 Fonte em Massa do Salesforce	O suporte varia conforme o conector. A maioria das atividades de conectores específicos de aplicativo usadas como alvo pode ser usada 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 conforme 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	Escreva 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`.	Escreva 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é um intervalo de 5 segundos. Suportado apenas em agentes privados.	Máximo mais alto (recomendado não mais que 5 tentativas) em até um intervalo de 5 segundos. Suportado apenas em agentes privados.	O suporte varia conforme o 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 origem 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 conforme o conector.
Suporte a 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 origem Jitterbit e variáveis de destino cujos nomes terminam com `http.max_redirs` podem ser usadas para permitir que os redirecionamentos sejam seguidos.	O suporte varia conforme o conector.
Suporte a Dados de Formulário	A configuração Multipart da atividade POST, PUT e PATCH do 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 cujos nomes incluem `http.form_data` podem ser usadas com uploads de formulário RFC 1687.	O suporte varia conforme o conector.
Suporte para Remover Espaços em Branco Finais e Quebras de Linha	Espaços em branco e quebras de linha de 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 verdadeira 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 conforme o conector.
Configuração de Manter Conexão	A configuração Manter Conexão 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 conforme o conector.
Suporte a Cookies	Não suportado.	Suportado apenas se usando 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 conforme 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.	O suporte varia conforme o conector.
Suporte para Expect: 100-continue	Não suportado.	O cabeçalho Expect: 100 continue é enviado quando a opção Enviar `Expect 100-continue` é selecionada em uma conexão HTTP.	O suporte varia conforme o conector.
Suporte a Cifras Fracas	Não suportado.	Servidores HTTP que usam cifras fracas (DES/3DES e RC4) podem ser usados quando a opção Permitir Cifras Fracas é selecionada em uma conexão HTTP.	O suporte varia conforme 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).	Não suportado.
Suporte para Registro em Agentes Privados	O conector HTTP v2 suporta registro detalhado do conector.	O conector HTTP suporta registro de depuração Curl.	O suporte varia conforme 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, 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