Conexão Salesforce

Introdução

Uma conexão do Salesforce é configurada usando o conector do Salesforce, estabelecendo acesso ao endpoint do Salesforce. Depois que uma conexão é estabelecida, você pode 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. Além disso, a conexão do Salesforce pode ser usada em scripts.

Criar ou editar uma conexão Salesforce

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

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).

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

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).

Configurar uma conexão Salesforce

A configuração de uma conexão do Salesforce inclui estes campos:

• Nome do Endpoint: Insira um nome a ser usado para identificar a conexão do Salesforce. O nome deve ser exclusivo para cada conexão do Salesforce e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint do Salesforce, que se refere a uma conexão específica e suas atividades.

• Host do servidor: Insira a URL do servidor Salesforce. Se 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 de sandbox, marque a caixa de seleção Sandbox abaixo.

• Sandbox: Se você estiver usando uma instância de 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: Insira o nome de usuário para a conta Salesforce. É necessária uma conta Salesforce que não tenha autenticação multifator (MFA) habilitada.

  Para configurar uma conta do 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 O MFA é necessário 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.

  Cuidado

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

  Invalid username, password, security token; or user locked out. [INVALID_LOGIN]
  

  Nesse caso, o teste de conexão ainda pode 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 necessário pela configuração de segurança da instância do Salesforce, insira o token de segurança associado à conta do Salesforce. Para obter mais informações, consulte a documentação do Salesforce para 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 para você confirmar 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, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos passos

Após uma conexão do Salesforce ter sido criada, as ações de menu para essa conexão ficam acessíveis na aba Componentes do painel do projeto. Consulte menu de ações de conexão para mais detalhes.

Depois de 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

As atividades do Salesforce interagem com a conexão do Salesforce para atuar como fontes (fornecendo dados dentro de uma operação) ou destinos (recebendo dados dentro de uma operação).

Depois de configurar uma conexão com o Salesforce, use o menu suspenso Mostrar para filtrar por Endpoints e clique no bloco de conexão com o Salesforce para exibir as atividades que estão disponíveis para serem usadas com uma conexão com o Salesforce:

Para mais informações, veja estas atividades:

Atividades padrão do Salesforce

• Consulta: Consulta dados de um endpoint do Salesforce e deve ser usado como uma fonte em uma operação.
• Inserir: Insere novos dados em um endpoint do Salesforce e deve ser usado como um alvo em uma operação.
• Atualizar: Atualiza dados existentes em um endpoint do Salesforce e deve ser usado como um alvo em uma operação.
• Inserir: Atualiza dados existentes e insere novos dados em um endpoint do Salesforce e deve ser usado como um alvo em uma operação.
• Excluir: Exclui dados em um endpoint do Salesforce e deve ser usado como um alvo em uma operação.

Atividades em massa do Salesforce

As atividades em massa do Salesforce são mais rápidas e escaláveis melhor do que as atividades não em massa do Salesforce, mas devem ser usadas somente se você não precisar usar uma transformação para alterar dados antes de atingir o destino.

• Consulta em massa: Consulta um grande número de registros de um endpoint do Salesforce e deve ser usado como uma fonte em uma operação.
• Inserir em massa: Insere um grande número de novos registros em um endpoint do Salesforce e deve ser usado como um alvo em uma operação.
• Atualização em massa: Atualiza um grande número de registros existentes em um endpoint do Salesforce e deve ser usado como um alvo em uma operação.
• Upsert em massa: Atualiza um grande número de registros existentes e insere um grande número de novos registros em um endpoint do Salesforce e deve ser usado como um alvo em uma operação.
• Exclusão em massa: Exclui um grande número de registros de um endpoint do Salesforce e deve ser usado como um alvo em uma operação. Os registros excluídos são armazenados na Lixeira do Salesforce antes de serem excluídos permanentemente.
• Exclusão em massa definitiva: Exclui permanentemente um grande número de registros de um endpoint do Salesforce e deve ser usado como um alvo em uma operação. Registros excluídos permanentemente se tornam automaticamente qualificados para exclusão.

Usando 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 um parâmetro. Para obter mais informações, consulte Usar funções do Salesforce.