Ir para o conteúdo

Conexão Salesforce

Introdução

Uma conexão Salesforce, criada usando o conector Salesforce, estabelece acesso ao Salesforce. Uma vez que uma conexão é configurada, é possível 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

Este conector suporta a política de Habilitar Reautenticação em Caso de Alteração da organização. Se habilitado, uma alteração no Host do Servidor ou Nome de Usuário nesta conexão requer que os usuários reentrem a Senha e o Token de Segurança para a conexão.

Criar ou editar uma conexão Salesforce

Uma nova conexão Salesforce é criada usando o conector Salesforce a partir de uma destas localizações:

Uma conexão Salesforce existente pode ser editada a partir destas localizações:

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 aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da Conexão: Insira um nome para identificar a conexão Salesforce. O nome deve ser exclusivo 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.

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

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

  • Nome de Usuário: Insira o nome de usuário da conta Salesforce. É necessário ter uma conta Salesforce que não tenha a autenticação multifator (MFA) habilitada.

    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 FAQ sobre Autenticação Multifator do Salesforce.

  • Senha: Insira a senha da conta Salesforce.

    Atenção

    Uma senha do Salesforce que utiliza caracteres ASCII estendidos, como £, pode causar o seguinte erro ao buscar dados durante a configuração da atividade:

    Nome de usuário, senha, token de segurança inválidos; ou usuário bloqueado. [INVALID_LOGIN]

    Nesse caso, o teste de conexão pode ainda ser bem-sucedido. Se você receber esse erro durante a configuração da atividade e estiver usando caracteres especiais na senha, tente alterar a senha.

  • Token de Segurança: Se exigido pela configuração de segurança da instância Salesforce, insira o token de segurança associado à conta Salesforce. Para mais informações, consulte a documentação do Salesforce sobre Redefinir seu Token de Segurança ou Não é possível ver a opção Redefinir Token de Segurança.

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

  • Salvar Alterações: Clique para salvar e fechar a configuração da 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 pede 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede que você confirme que deseja excluir a conexão.

Próximos passos

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

Após configurar uma conexão com o Salesforce, é possível configurar uma ou mais atividades do Salesforce associadas a essa conexão para serem usadas como uma fonte para fornecer dados a uma operação ou como um destino para consumir dados em uma operação, ou ainda 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 não for necessário usar uma transformação para alterar os dados antes de chegar ao destino.

  • Consulta: Consulta dados do Salesforce e é destinada a ser usada como uma fonte 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, sendo 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.

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

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

  • Atualização em Massa: Atualiza um grande número de registros existentes no Salesforce e é destinado a ser usado como um alvo para consumir dados em uma operação.

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

  • Exclusão em Massa: Exclui um grande número de registros do Salesforce e é destinado a ser usado como um alvo 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 Dura em Massa: Exclui de forma permanente um grande número de registros do Salesforce e é destinado a ser usado como um alvo para consumir dados em uma operação. Os registros excluídos de forma permanente tornam-se automaticamente elegíveis para exclusão.

Use conexões do Salesforce em scripts

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