Ir para o conteúdo

Conexão com o Salesforce

Introdução

Uma conexão com o Salesforce, criada usando o conector do Salesforce, estabelece acesso ao Salesforce. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Salesforce associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

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

Este conector suporta a política de Habilitar Reautenticação em Mudanças da organização. Se habilitada, uma mudança 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 com o Salesforce

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

Uma conexão existente com o Salesforce pode ser editada a partir dessas 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.

  • Tipo de autenticação: Selecione o tipo de autenticação para conectar ao Salesforce, seja Autenticação Básica ou Credenciais de Cliente OAuth 2.0.

    Selecione Autenticação Básica para mostrar estes campos:

    • 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 da exigência 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: Insira a senha da conta do Salesforce.

    !!! caution "Cuidado"
    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 do Salesforce, insira o token de segurança associado à conta do 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.

    Selecione Credenciais do Cliente OAuth 2.0 para mostrar esses campos:

  • URL da Instância: Insira a URL da instância do Salesforce.

  • ID do Cliente: Insira o ID do cliente do seu aplicativo Salesforce configurado.

  • Segredo do Cliente: Insira o segredo do cliente do seu aplicativo Salesforce configurado.

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

    Nota

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

  • 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 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 (veja 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 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 Fundamentos do conector.

Após configurar uma conexão Salesforce, você pode configurar uma ou mais atividades 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 você pode usar a conexão 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 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 destinado a ser usado como um alvo para consumir dados em uma operação.

  • Delete: Exclui dados no Salesforce e é destinado a ser usado como um alvo para consumir dados em uma operação.

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

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

  • Bulk Update: 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.

  • Bulk Upsert: 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.

  • Bulk Delete: 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.

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

Use Salesforce connections in 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, consulte Use Salesforce functions.