Skip to main content

Salesforce

O conector do Salesforce permite que você se conecte ao Salesforce no Designer. Use o conector para ler dados de objetos do Salesforce e gravar dados de volta no Salesforce a partir de um único conector que funciona da mesma maneira no Alteryx Designer (Desktop) e no Alteryx One (Cloud).

O Salesforce está disponível como uma fonte de dados na ferramenta Dados de Entrada e na ferramenta Dados de Saída, e como as ferramentas autônomas Entrada do Salesforce e Saída do Salesforce.Output Data Tool Icon Ferramenta Dados de Saída

Nova versão do conector no Designer

O conector do Salesforce agora faz parte da experiência de conectores do Alteryx One. Revise com atenção as informações nesta página para garantir o uso apropriado e correto das ferramentas.

Para atualizar o conector do Salesforce nos fluxos de trabalho do Designer, você pode usar o utilitário de migração de fluxo de trabalho.

Configuração do conector do Salesforce

O Salesforce está disponível no Designer 2025.1.2 patch 7 ou posterior. Se você já usou o conector do Salesforce, consulte Migração para o conector unificado.

Pré-requisitos

Antes de prosseguir, certifique-se de ter concluído os seguintes pré-requisitos:

Requisito

Detalhe

Versão do Designer

  • 2025.1 Patch 5, 2025.2 Patch 3 ou 2026.1 ou posterior (todos os recursos, exceto OAuth integrado e personalizado)

  • 2025.1.2 Patch 7, 2025.2.1 Patch 5 ou 2026.1 (todos os métodos de autenticação)

Configuração de aplicativo personalizado (OAuth 2.0), se usado

Um aplicativo conectado ao Salesforce com ID do cliente, segredo do cliente, URI de redirecionamento (deve corresponder ao aplicativo conectado) e escopo

URL do ambiente

Produção (padrão), Sandbox ou Domínio personalizado

DCM

Você deve habilitar o DCM no Designer. Acesse Opções > Configurações avançadas > DCM para habilitá-lo

Instalar o conector

Você pode instalar facilmente a versão mais recente do conector do Salesforce do Designer por meio dos Add-Ons. Esse é o método de instalação recomendado que permite navegar, instalar e atualizar conectores sem sair do Designer ou visitar o Alteryx Marketplace.

Para instalar o conector...

  1. No Designer, vá para Add-Ons > Gerenciar add-ons do Marketplace. Você verá uma lista de conectores disponíveis.

  2. Selecione Conector do Salesforce e clique em Instalar. O Designer baixa e instala o pacote. O Designer pode precisar ser reiniciado para concluir a instalação.

  3. Após a conclusão da instalação e da configuração, o conector do Salesforce estará disponível nas ferramentas Dados de Entrada e Dados de Saída.

Configurar uma conexão

Para se conectar ao Salesforce usando o DCM...DCM - Designer

  1. Arraste a ferramenta Dados de Entrada ou Dados de Saída para a tela e selecione Conectar aos dados.

  2. Em Configuração do conector , selecione Criar ou procurar uma conexão de dados.

    Se você já criou uma conexão do Salesforce antes, pode selecionar a conexão na guia Recentes.

  3. Clique em + Novo. Na lista de tecnologias, selecione Salesforce.

  4. Selecione Conexão rápida e, em seguida, selecione Configurar conexão. A janela Conexões é aberta.

  5. Clique em + Novo.

  6. Especifique o nome da conexão e o nome da fonte de dados. Selecione o Ambiente.

  7. Na seção Credenciais, selecione seu método de autenticação e insira o nome da credencial. Para obter mais informações, consulte Métodos de autenticação.

  8. Clique em Salvar.

  9. Clique em Conectar. O Salesforce pode solicitar autenticação.

  10. Na janela do navegador de arquivos, selecione o arquivo a ser lido ou gravado.

  11. Selecione a configuração de leitura ou gravação na janela Opções.

  12. Clique em Confirmar para criar uma conexão com o arquivo. Você pode continuar criando seu fluxo de trabalho.

Migração para o conector unificado

Se você já usa o conector do Salesforce no Alteryx, leia a seção abaixo. Ele mostra o que foi alterado na versão unificada.

Parâmetro

Conector herdado

Conector unificado (v6.1.0)

Plataformas e ferramentas

Desktop (Entrada e Saída)

Cloud (somente Entrada)

Desktop (Entrada e Saída)

Cloud (Entrada e Saída, em andamento)

Estrutura

SDK do Python (Desktop)

Driver CData ODBC (Cloud)

Estrutura EACD (Desktop e Cloud)

Comunicação/API

API do Salesforce v52 (verão de 21)

API do Salesforce v61 ou posterior (verão de 24)

Métodos de autenticação

OAuth 2.0

Nome de usuário, senha e token de segurança do Salesforce

Os mesmos métodos, com configuração expandida

Modelo de conexão

Opções separadas de URL de produção/Sandbox/personalizado

DCM, com um único campo URL de ambiente

Principais alterações

  • Os menus suspensos Produção, Sandbox e URL personalizado foram substituídos por um único campo URL de ambiente. Reconfigure qualquer fluxo de trabalho que usou esse menu suspenso.

  • O URL do ambiente substitui o antigo menu suspenso: https://login.salesforce.com (produção, padrão), https://test.salesforce.com (sandbox) ou seu domínio personalizado.

  • A autenticação de credenciais do Salesforce agora também requer ID do cliente e segredo do cliente.

  • No Desktop, os domínios personalizados agora funcionam com todos os métodos de autenticação (anteriormente apenas OAuth).

Os fluxos de trabalho existentes podem ser migrados usando o utilitário de migração do fluxo de trabalho do Alteryx no Designer 2025.2 Patch 3 ou posterior. Para obter mais informações, consulte Utilitário de migração de fluxo de trabalho.

Nota

  • O utilitário de migração está disponível apenas no Desktop.

  • Depois de instalar o conector unificado, você pode ver as tecnologias herdadas e unificadas do Salesforce listadas em Gerenciar conexões. Isso é esperado durante a transição. Use o conector unificado para qualquer novo trabalho.

Sobre o conector Salesforce

Ferramentas Entrada e Saída

As ferramentas Entrada e Saída do Salesforce são usadas para ler e gravar no Salesforce.

Entrada do Salesforce

O recurso Entrada do Salesforce lê objetos padrão e personalizados. Você pode ler de três maneiras:

  • Construtor de consultas: escolha um objeto e selecione os campos que deseja ler. O seletor de campos oferece uma lista de seleção múltipla com Selecionar tudo, pesquisar por cadeia de caracteres (string) ou subcadeia de caracteres, uma contagem em tempo real de campos selecionados versus totais e um filtro para mostrar apenas o que está selecionado. Um limite de registros também pode ser definido. Há quatro modos de campo disponíveis: Ler todos os campos padrão, Ler todos os campos personalizados, Ler todos os campos e Escolher manualmente.

  • Consulta personalizada (SOQL): grave uma consulta SOQL para ler objetos padrão e personalizados, incluindo campos de relação __r e valide-a antes de executá-la. Uma consulta personalizada sempre retorna uma única tabela.

  • Ler a partir do relatório: navegue e pesquise relatórios salvos, selecione um relatório e analise seus resultados.

Saída do Salesforce

A ferramenta Saída do Salesforce grava linhas em um objeto padrão ou personalizado. Escolha uma ação:

  • Inserir: adiciona novos registros.

  • Atualizar: modifica registros existentes. Requer o ID de registro do Salesforce.

  • Excluir: remove registros. Requer o ID de registro do Salesforce.

  • Upsert: insira novos registros e atualize os existentes em uma única ação.

A saída processa registros em lotes e permite que você escolha a versão da API do Salesforce. Ao usar Atualizar, Excluir ou Upsert, inclua o ID de registro como a chave primária em seus dados.

Modelo de objeto

O Salesforce armazena dados em objetos, que se comportam como tabelas de banco de dados:

  • Os objetos padrão são integrados, por exemplo, Conta, Contato, Lead, Oportunidade, Caso, Campanha, Tarefa, Evento e Usuário.

  • Os objetos personalizados são criados em sua organização e terminam com __c, por exemplo, Invoice__c.

  • Os campos de relação entre objetos usam o sufixo __r e podem ser referenciados no SOQL.

Métodos de autenticação

O Salesforce é compatível com três métodos de autenticação. Use a tabela abaixo para escolher a melhor opção para o seu caso de uso.

Método

Campos obrigatórios

Desktop (principal)

Cloud (Alteryx One)

Aplicativo integrado (OAuth 2.0)

Nenhum

Sim

Não disponível (a criação de conexão nativa não é oferecida no Cloud)

Aplicativo personalizado (OAuth 2.0)

ID do cliente, Segredo do cliente, URI de redirecionamento (padrão http://localhost:1717/), Escopo (padrão api offline_access)

Sim

Sim

Credenciais do Salesforce (nome de usuário, senha, token de segurança)

Nome de usuário, Senha, Token de segurança (opcional), ID do cliente, Segredo do cliente

Sim

Sim

Domínio personalizado em todos os métodos

N/A

Sim

Não disponível (domínio personalizado não é compatível com todos os métodos no Cloud)

 

O OAuth é compatível tanto com o fluxo de código de autorização (do usuário para o aplicativo) quanto com o fluxo de credenciais de cliente (entidade de serviço, para automação sem interface ou agendada).

Limitações

  • O conector não oferece suporte a uma simulação (dry-run) para leituras ou consultas personalizadas. Execute o fluxo de trabalho para recuperar dados ou use a etapa de validação SOQL para verificar uma consulta personalizada antes de executá-lo.

  • Para objetos com mais de 200 campos, os modos Ler todos os campos personalizados e Ler todos os campos falham. Use Escolher manualmente para escolher os campos de que você precisa ou grave uma consulta personalizada SOQL que lista campos específicos.

  • Uma consulta personalizada SOQL sempre retorna uma tabela. Para combinar dados de múltiplos objetos, junte-os na consulta SOQL ou use múltiplas ferramentas Entrada e combine os resultados no fluxo de trabalho.

  • Ler a partir do relatório é compatível com a seleção de uma única ferramenta Relatório por Entrada. Para ler múltiplos relatórios, use múltiplas ferramentas entrada.

  • O conector usa a API REST do Salesforce. A API em massa do Salesforce ainda não é compatível. Para operações de leitura ou gravação de grande porte, é provável que sejam aplicados os limites de taxa de transferência da API REST e da API do Salesforce.

  • A pré-visualização de dados de objeto e campo está disponível no Cloud, mas não no Desktop. No Desktop, configure os campos usando a lista de campos do Construtor de consultas ou uma consulta SOQL.

  • No Cloud, o suporte a domínios personalizados em todos os métodos de autenticação não está disponível. Use um método compatível para sua conexão com o Cloud ou conecte-se a partir do Desktop, onde o domínio personalizado funciona com todos os métodos.

  • O utilitário de migração do fluxo de trabalho é executado apenas no Desktop.

  • No Cloud, o fluxo interno de criação de conexão do aplicativo não é oferecido. Use um aplicativo OAuth personalizado ou credenciais do Salesforce no Cloud.

  • Os tipos de dados produzidos a partir do mesmo objeto podem diferir entre o Cloud e o Desktop.

  • No Cloud, carregar um conjunto de dados pode falhar para alguns objetos. Se um objeto específico não carregar, tente uma consulta personalizada SOQL para esse objeto ou reduza os campos selecionados.

  • O conector geralmente está disponível no Desktop. O suporte do Cloud está em andamento e ainda não está disponível para o público geral.

Notas de versão do conector do Salesforce

Salesforce versão 6.1.0

Versão de lançamento do Conector 6.1.0

Versão

Descrição

v6.1.0

  • Exige o Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2 ou disponibilidade geral 2026.2 para todos os métodos de autenticação.

  • Usa o DCM e se comunica por meio da API do Salesforce v61 e versões posteriores (Verão de 2024).

  • Conexões baseadas no DCM com uma configuração de conexão simplificada (um único URL de ambiente e OAuth personalizado que expõe o URI de redirecionamento e o Escopo).

  • Entrada:

    Construtor de consultas: campo Selecionar tudo, pesquisar, contar, filtrar, limite de registros.

    Leia do Relatório sem limite de registros.

    Consulta personalizada SOQL com validação.

    Escolha a versão da API.

  • Saída

    Inserir, Atualizar, Excluir e a nova ação Upsert.

    Processamento em lote

    Escolha a versão da API.

  • Corrigido um problema em que a leitura de um relatório do Salesforce era limitada a um número fixo de registros (2000). Isso funciona somente ao usar a API REST padrão.

  • Corrigido um problema em que os valores de DateTime eram retornados como 00:00:00, e os valores vazios agora são tratados corretamente.

  • Agora, Selecionar tudo está disponível na lista de colunas.

  • A reutilização de uma conexão do DCM ociosa com OAuth personalizado não falha mais com um erro de token.

  • O OAuth do aplicativo nativo agora autentica corretamente.

  • O carregamento do conjunto de dados pode falhar para determinados objetos no Cloud.

  • A pré-visualização por esquema está desabilitada para uma consulta personalizada do Salesforce.

Conectores autônomos do Salesforce

Tipo de conexão

Ferramentas do Alteryx. A versão mais recente está disponível no Alteryx Marketplace.

Tipo de suporte

Leitura e gravação

Validado em

Versão de cliente ODBC 2.2.20 também disponível para as ferramentas Dados de Entrada e Saída.

Notas de versão das ferramentas do Salesforce

Versão

Descrição

v5.1.4

  • É compatível com o Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • O conector do Salesforce padroniza a precisão de hora e data/hora para milissegundos para evitar zeros extras à direita, enquanto ainda oferece suporte à resolução de nanossegundo quando exigido pelo fluxo de trabalho. (TPM-4753, TPM-4736)

  • Corrigido o problema em que as ferramentas do Salesforce ignoravam as configurações de proxy no Server. (TPM-4647)

  • Corrigido o problema em que o Server não podia executar fluxos de trabalho com as ferramentas do Salesforce porque elas dependiam de tokens de acesso do Designer. (TPM-4846)

  • Corrigido o problema em que as ferramentas de desenvolvedor do Designer expunham valores secretos nos arquivos JSON retornados. (TPM-4788)

v5.1.3

  • É compatível com o Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Adicionado suporte para domínios personalizados do Salesforce ao usar o DCM.

  • Melhora na autenticação.

  • SDK atualizado para a versão 2.4.2.

  • API atualizada para a versão mais recente.

  • Corrigido o problema em que as ferramentas do Salesforce ignoravam o script PAC ao usar o DCM. (TPM-4620)

  • Corrigido o problema em que a ferramenta Entrada do Salesforce não conseguia ler determinadas colunas do tipo data. (TPM-4604)

  • Corrigido o problema em que a ferramenta Saída do Salesforce não conseguia exibir o mapeamento de campos para a operação de atualização. (TPM-4519)

  • Corrigido o problema em que as ferramentas do Salesforce exibiam "Acesso negado" se o token de segurança não era criado no DCM. (TPM-4507)

  • Corrigido o problema em que as ferramentas do Salesforce não tinham a versão da API alinhada de acordo com a tag de front-end. (TPM-4493)

  • Corrigido o problema em que as ferramentas do Salesforce não conseguiam se conectar usando o domínio personalizado. (TPM-4488)

  • Corrigido o problema em que as ferramentas do Salesforce avisavam sobre truncamento inesperado de carimbos de data/hora. (TPM-4368)

  • Corrigido o problema em que a ferramenta Entrada do Salesforce truncava valores ao usar objetos de relacionamento aninhados em uma consulta SOQL personalizada. (TPM-4367)

  • Corrigido o problema em que as ferramentas Saída do Salesforce eram executadas indefinidamente se os fluxos de trabalho contivessem múltiplas ferramentas Saída do Salesforce. (TPM-4268)

  • Corrigido o problema em que as ferramentas do Salesforce exibiam múltiplas versões de API como opções selecionáveis. (TPM-4264)

  • Corrigido o problema em que a ferramenta Saída do Salesforce falhava ao gravar dados com as operações de inserção e atualização. (TPM-4248)

  • Corrigido o problema em que as ferramentas do Salesforce não conseguiam ler o tipo de dados de porcentagem corretamente. (TPM-4174)

  • Corrigido o problema em que as ferramentas do Salesforce retornavam um erro com campos de data personalizados. (TPM-4051)

  • Corrigido o problema em que as ferramentas do Salesforce retornavam "Código de erro 400: sintaxe de solicitação incorreta ou método sem suporte". (TPM-3982)

  • Corrigido o problema em que as ferramentas do Salesforce apresentavam desempenho lento. (TPM-3919)

  • Corrigido o problema em que a ferramenta Entrada do Salesforce retornava o campo "versionData" como URL em vez de corpo de documento. (TPM-3662)

Problemas conhecidos

  • Determinados campos aparecem como nulos após a atualização para a nova versão das ferramentas do Salesforce. (TPM-4805)

  • Os conectores SDK ignoram o proxy no Server (Gallery). (TPM-4647)

  • As ferramentas de desenvolvedor HMTL do Designer expõem o valor secreto no JSON retornado. (TPM-4788)

  • As consultas retornam registros nulos na ferramenta Entrada do Salesforce. (TPM-4641)

v5.1.2

  • É compatível com o Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Atualizamos para ser executado no Designer e no Server 2024.1.

  • Corrigido o problema de falha da ferramenta Entrada do Salesforce após 45 minutos de execução. (TPM-3556)

  • Corrigido o problema de ausência da origem e descrição dos metadados. (TPM-3486)

  • Corrigido o problema em que as ferramentas do Salesforce ignoravam as configurações de proxy. (TPM-3358)

  • Corrigido o problema em que a ferramenta Entrada do Salesforce retorna o erro "Código de erro 401: Sem permissão; consulte os esquemas de autorização". (TDCE-449 e TDCE-361)

v5.1.1

  • É compatível com o Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Atualizamos para ser executado no Designer e no Server 2024.1.

  • Corrigido o problema em que a autenticação via aplicativo OAuth personalizado não funcionava. (TFLN-1912)

  • Problema corrigido em que a ferramenta Entrada do Salesforce era executada indefinidamente quando configurada para ler um conjunto de dados vazio. (TPM-2453)

Problemas conhecidos

  • A ferramenta do Salesforce 5.1.1 não está funcionando no Designer-FIPS e no Server-FIPS. Como solução alternativa, use a versão 5.1.0. (TFLN-1982)

  • Os metadados de origem e descrição estão atualmente ausentes nos resultados dos fluxos de trabalho. (TPM-3486)

v5.1.0

  • É compatível com o Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • Adicionado suporte para DCM à ferramenta Saída do Salesforce.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • A ferramenta Saída do Salesforce agora é capaz de operar com FIPS.

  • Desempenho do recurso de configuração automática melhorado.

  • Adicionada a opção de simulação (dry-run) à ferramenta Entrada do Salesforce.

  • Problema corrigido em que a ferramenta Entrada do Salesforce 5.0.10 analisava incorretamente os tipos de dados. (TFLN-1676)

v5.0.10

  • É compatível com o Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • Suporte adicional para DCM.

    • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Capaz de operar com FIPS.

  • Suporte adicionado para autenticação OAuth e domínios personalizados.

  • Problema corrigido em que a ferramenta Entrada do Salesforce não mostrava todos os campos e objetos. (TPM-1579)

  • Problema corrigido em que a ferramenta Entrada do Salesforce analisava incorretamente o arquivo PAC. (TFLN-1243)

  • Problema corrigido em que a ferramenta Entrada do Salesforce não exibia a janela de configuração quando o idioma do Designer estava definido como francês. (TDCE-119)

Problemas conhecidos

  • A ferramenta Geração de Relatórios lista apenas relatórios recentes, não todos os relatórios disponíveis para o usuário.

  • Os relatórios retornam apenas os primeiros 2.000 registros.

v4.2.4

  • Corrige o defeito com Consultas personalizadas que não são analisadas na ferramenta Entrada do Salesforce.

  • Os trabalhos de Entrada do Salesforce não falharão mais quando programados ou executados na linha de comando.

  • Corrige o defeito com a verificação do certificado na ferramenta Entrada do Salesforce.

  • Compatível com o upload da ferramenta Entrada do Salesforce para o Gallery sem token.

v4.1.0

  • Suporte adicional para conexão por meio de um proxy usando detecção e configuração automáticas.

  • Compatível com Alteryx versão 2019.2 e posterior.

v4.0.0

  • Capacidade adicional de consultar relatórios do Salesforce.

  • O Query Builder e a Consulta personalizada retornam todos os registros (incluindo excluídos) por padrão.

  • Adicione 'IsDeleted=False' na sentença WHERE para excluir registros excluídos.

  • Compatível com a versão 2018.3 - 2019.2 do Alteryx.

v3.1

  • Corrige defeitos do Limite de registros na guia Tempo de execução da configuração de fluxo de trabalho e senhas contendo caracteres especiais XML.

  • Compatível com a versão 11.0 - 2018.2 do Alteryx.

Notas de versão da ferramenta Saída do Salesforce (descontinuada)

Versão

Descrição

v1.3.1

  • Atualização das metainformações da ferramenta.

v1.3

  • Atualização da versão da API do Salesforce no mecanismo de macro.

  • Defeito corrigido para escapar caracteres corretamente.

v1.2

  • Os campos DateTime são convertidos automaticamente para AAAA-MM-DDThh:mm:ss.sss.

  • Foi corrigido o problema em que as mensagens de erro "Nome da tabela necessário" e "Operação de saída necessária" eram exibidas mesmo que o usuário ainda não tivesse feito login.

Nota

  • Certifique-se de ter o AMP Engine habilitado para os fluxos de trabalho que contêm a ferramenta Entrada do Salesforce 2.2.0 e versões posteriores.

  • Para configurar um aplicativo de API personalizado para esta ferramenta, consulte este guia.

  • Se você quiser processar um arquivo PAC que direciona solicitações por meio de múltiplos IPs de proxy, use tokens de segurança.

Domínios personalizados do Salesforce

As ferramentas do Salesforce oferecem suporte a domínios personalizados do Salesforce.

Para se conectar a um domínio personalizado manualmente…

  1. Na janela de configuração das ferramentas do Salesforce, selecione Usar URL de ambiente personalizado.

  2. Insira seu domínio personalizado em Ambiente personalizado.

Para se conectar a um domínio personalizado usando o DCM…

  1. Clique em Configurar conexão. O DCM é aberto.

  2. Clique em + Novo. A janela "Nova fonte de dados" é aberta com a tecnologia Salesforce pré-selecionada.

  3. Selecione Personalizado em Ambiente.

  4. Insira seu domínio personalizado no Ambiente personalizado e selecione Salvar.

Nesta secção: