Ir para o conteúdo

Conector Salesforce no Jitterbit Studio

Resumo

O conector Salesforce estabelece acesso ao Salesforce.

O conector Salesforce fornece uma interface para criar uma conexão Salesforce, a base usada para gerar instâncias de atividades do Salesforce. Essas atividades, uma vez configuradas, interagem com o Salesforce através da conexão.

O conector Salesforce é acessado a partir da guia Endpoints e conectores de projeto na paleta do componente de design (consulte Paleta de componentes de design).

Dica

Receitas de integração e modelos de processo estão disponíveis para este conector através do Jitterbit Marketplace.

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão Salesforce. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Juntos, uma conexão Salesforce específica e suas atividades são denominados endpoint do Salesforce:

Tipos de atividade Salesforce

Existem onze atividades disponíveis, cinco padrão e seis em lote. As atividades em lote devem ser usadas apenas se você não precisar usar uma transformação para alterar dados antes de atingir o destino.

  • Consulta: Consulta dados do Salesforce e se destina a ser usada como uma fonte para fornecer dados em uma operação.

  • Inserir: Insere novos dados no Salesforce e se destina a ser usada como um destino para consumir dados em uma operação.

  • Atualizar: Atualiza dados existentes no Salesforce e se destina a ser usada como um destino para consumir dados em uma operação.

  • Upsert: Atualiza dados existentes e insere novos dados no Salesforce e se destina a ser usada como um destino para consumir dados em uma operação.

  • Excluir: Exclui dados no Salesforce e se destina a ser usada como um destino para consumir dados em uma operação.

  • Consulta em Lote: Consulta um grande número de registros do Salesforce e se destina a ser usada como uma fonte para fornecer dados em uma operação.

  • Inserção em Lote: Insere um grande número de novos registros no Salesforce e se destina a ser usada como um destino para consumir dados em uma operação.

  • Atualização em Lote: Atualiza um grande número de registros existentes no Salesforce e se destina a ser usada como um destino para consumir dados em uma operação.

  • Upsert em Lote: Atualiza um grande número de registros existentes e insere um grande número de novos registros no Salesforce e se destina a ser usada como um destino para consumir dados em uma operação.

  • Exclusão em Lote: Exclui um grande número de registros do Salesforce e se destina a ser usada como um destino para consumir dados em uma operação. Os registros excluídos são armazenados na Lixeira do Salesforce antes de serem excluídos permanentemente.

  • Exclusão Permanente em Massa: Exclui permanentemente um grande número de registros do Salesforce e é destinado a ser usado como um destino para consumir dados em uma operação. Registros excluídos permanentemente se tornam automaticamente elegíveis para exclusão.

Este conector é um conector nativo: suas atualizações são lançadas com a aplicação Studio ou com o agente, em vez de separadamente. Consulte Atualizações do conector Studio.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

O conector Salesforce oferece suporte ao uso de agentes Harmony na nuvem ou privados na versão 9.4.2 ou superior.

Se estiver configurando uma conexão Salesforce usando autenticação básica, é necessária uma conta Salesforce que não tenha a autenticação multifator (MFA) ativada. Para configurar uma conta Salesforce sem MFA, certifique-se de que o Conjunto de Permissões atribuído ao login de integração do sistema Salesforce não tenha a seleção de Autenticação Multifator para Logins de API. Os tipos de login de integração do sistema estão isentos do requisito de MFA do Salesforce, conforme descrito pelo Salesforce em Is MFA required for my integration users? (A MFA é obrigatória para meus usuários de integração?) na documentação Perguntas frequentes sobre Autenticação Multifator do Salesforce.

Se estiver configurando uma conexão Salesforce usando autenticação OAuth 2.0 de dois passos, consulte os pré-requisitos do OAuth 2.0 de dois passos para obter mais informações.

Nota

A versão do agente 11.59 / 12.3 ou posterior é necessária para usar OAuth 2.0 de dois passos com o conector Salesforce.

A versão de API que o conector usa para atividades que não são em massa depende da versão do agente Jitterbit:

Versão do agente Jitterbit Versão da API SOAP do Salesforce Versão do Salesforce
12.10 ou posterior (OAuth 2.0) 67.0 Verão '26
12.7 a 12.9 (OAuth 2.0) 66.0 Primavera '26
12.4 a 12.6 (OAuth 2.0) 65.0 Inverno '26
12.3 ou posterior (Básico ou sem autenticação)
11.47 a 11.59 (Básico ou sem autenticação)		 64.0 Verão '25
11.41 a 11.46 63.0 Primavera '25
11.35 a 11.40 62.0 Inverno '25
11.30 a 11.34 61.0 Verão '24
11.23 a 11.29
10.85 a 10.87		 60.0 Primavera '24
11.18 a 11.22
10.80 a 10.84		 59.0 Inverno '24
11.11 a 11.17
10.73 a 10.79		 58.0 Verão '23
11.7 a 11.10
10.69 a 10.72		 57.0 Primavera '23
11.0 a 11.6
10.55 a 10.68		 54.0 Primavera '22
10.44 a 10.54 52.0 Verão '21
10.42 a 10.43 51.0 Outono '21
10.28 a 10.41 50.0 Inverno '21
10.23 a 10.27 49.0 Verão '20
10.17 a 10.22 48.0 Primavera '20
10.11 a 10.16 47.0 Inverno '20
10.3 a 10.10 45.0 Primavera '19
9.8 a 10.2 44.0 Inverno '19
9.4.2 a 9.7 41.0 Inverno '18

Confirme a versão exata da API usada por um agente privado

Para um agente privado, verifique o log tomcat/logs/catalina.out após uma solicitação do conector ser executada (por exemplo, após clicar em Test na conexão). O log registra a URL da solicitação, por exemplo Service request URL: https://login.salesforce.com/services/Soap/u/64.0, onde o número após /u/ é a versão da API do Salesforce invocada.

A Salesforce Bulk API baseada em SOAP é usada para atividades em massa.

A Salesforce Bulk API usa um header X-SFDC-Session preenchido com um ID de sessão obtido quando a conexão é autenticada.

Atualizações de agente que ignoram versões da API SOAP do Salesforce incluem implicitamente suporte para versões intermediárias da API.

Consulte a documentação fornecida nos links acima para informações sobre os campos de schema.

Solução de problemas e instruções

Consulte Solução de problemas do conector Salesforce para informações adicionais. O guia Solução de problemas do conector também cobre problemas de eventos do Salesforce: eventos não podem ser habilitados após reinicialização do agente e limitações de atividade de escuta. Além disso, as seguintes páginas de instruções fornecem instruções detalhadas sobre como realizar determinadas tarefas com projetos de integração que usam o conector Salesforce:

Recursos adicionais

Os seguintes tutoriais de microleitura Jitterbit estão disponíveis através da nossa série de vídeos Jitterbit basics: