Ir para o conteúdo

Conexão Salesforce

Introdução

Uma conexão Salesforce, criada usando o conector Salesforce, estabelece acesso ao Salesforce. Após configurar uma conexão, você pode criar instâncias de atividades Salesforce associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

É necessário usar a versão do Agent 11.59 / 12.3 ou posterior para usar OAuth 2.0 de 2 pernas com o conector Salesforce.

Este conector suporta a política de organização Ativar Reautenticação ao Alterar. Se ativada, uma alteração no Host do servidor ou Nome de usuário nesta conexão exige que os usuários reinsiram a Senha e o Token de segurança da conexão.

Criar ou editar uma conexão Salesforce

Uma nova conexão Salesforce é criada usando o conector Salesforce em um destes locais:

Uma conexão Salesforce existente pode ser editada nestes locais:

Configurar uma conexão Salesforce

Cada elemento da interface do usuário da tela de configuração da conexão Salesforce é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Nome da conexão: Digite um nome para identificar a conexão Salesforce. O nome deve ser único para cada conexão Salesforce e não deve conter barras (/) ou dois-pontos (:). Este nome também é usado para identificar o endpoint Salesforce, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Tipo de autenticação: Selecione o tipo de autenticação para conectar ao Salesforce, Autenticação básica ou Credenciais do cliente OAuth 2.0.

    Selecione Autenticação básica para exibir estes campos:

    • Host do servidor: Digite a URL do servidor Salesforce. Se você estiver usando uma instância de produção, deixe a URL padrão como https://login.salesforce.com. Se você estiver usando uma instância sandbox, marque a caixa de seleção Sandbox abaixo.

    • Sandbox: Se você estiver usando uma instância sandbox do Salesforce, marque esta caixa de seleção para alternar o campo Host do servidor acima para https://test.salesforce.com.

    • Nome de usuário: Digite o nome de usuário da conta Salesforce. É necessária uma conta Salesforce que não tenha 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 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 A MFA é necessária para meus usuários de integração? em sua documentação Perguntas frequentes sobre autenticação multifator do Salesforce.

  • Senha: Digite a senha da conta do Salesforce.

    Selecione OAuth 2.0 Client Credentials para exibir estes campos:

    Consulte os pré-requisitos do OAuth 2.0 de 2 pernas para mais informações.

    Nota

    A versão do Agent 11.59 / 12.3 ou posterior é necessária para usar OAuth 2.0 de 2 pernas com o conector Salesforce.

  • Testar: Clique para verificar a conexão usando as credenciais fornecidas.

  • Salvar: Clique para salvar e fechar a configuração de conexão.

  • Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximas etapas

As ações de menu para uma conexão e seus tipos de atividade são acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, consulte Menus de ações em Noções básicas do conector.

Após configurar uma conexão do Salesforce, você pode configurar uma ou mais atividades do Salesforce associadas a essa conexão para serem usadas como uma origem para fornecer dados a uma operação ou como um destino para consumir dados em uma operação, ou você pode usar a conexão do Salesforce em um script.

Configurar atividades

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

  • Consulta: Consulta dados do Salesforce e é destinada a ser usada como uma origem para fornecer dados em uma operação.

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

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

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

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

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

  • Bulk Insert: Insere um grande número de novos registros no Salesforce e é destinada a ser usada como destino para consumir dados em uma operação.

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

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

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

  • Bulk Hard Delete: Exclui permanentemente um grande número de registros do Salesforce e é destinada a ser usada como destino para consumir dados em uma operação. Os registros excluídos permanentemente se tornam automaticamente elegíveis para exclusão.

Usar conexões do Salesforce em scripts

As conexões do Salesforce podem ser referenciadas em um script usando funções de script que usam um salesforceOrg como parâmetro. Para mais informações, consulte Usar funções do Salesforce.