Salesforce

O conector do Salesforce permite que você se conecte ao Salesforce no Designer.

Salesforce is available as a data source in the Input Data tool and Output Data tool, and as the standalone Salesforce Input and Salesforce Output tool.

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.

Detalhes do conector do Salesforce

O Salesforce está disponível no Designer 2025.2 patch 3 ou versões posteriores como uma fonte de dados para a ferramenta Dados de Entrada. Para saber mais sobre as opções de tipo de arquivo, acesse [links].

Prerequisites

Ensure you have completed the following prerequisites before proceeding:

Requirement	Detail
Designer version	2025.1 Patch 5, 2025.2 Patch 3, or 2026.1 or later (all features except Built-in and Custom OAuth) 2025.1.2 Patch 7, 2025.2.1 Patch 5, or 2026.1 Patch (all auth methods)
Custom app (OAuth 2.0) setup, if used	A Salesforce Connected App with Client ID, Client Secret, Redirect URI (must match the connected app) and scope
Environment URL	Production (default), Sandbox or, Custom domain
DCM	You must enable DCM in Designer. Go to Options > Advanced Settings > DCM to enable it

Instalar o conector

Você pode instalar facilmente a versão mais recente do conector do Salesforce pelo Designer por meio de complementos. Não é preciso acessar o Alteryx Marketplace se os conectores forem instalados desta forma.

Para instalar o conector...

No Designer, acesse Complementos > Gerenciar Complementos do Marketplace.
O Designer abre uma janela com uma lista dos conectores disponíveis.
Digite Salesforce para pesquisar.

Configurar uma conexão com DCM

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

Arraste as ferramentas Dados de Entrada ou Dados de Saída da paleta de ferramentas para a tela para selecionar.
Se você já tiver criado uma conexão com o Google Drive antes, poderá clicar em Fontes de dados > Salesforce > Conexão rápida e pular para a etapa 12.
If you've created a Salesforce connection before, you can select the connection from the Recents tab.
Select + New. From the list of technologies, select Salesforce.
Na janela Conexões de dados, selecione Fontes de dados.
Select +New.
Specify the connection name and the data source name. Select the Environment.
In the Credentials section, select your authentication method, and enter the credential name. For more information, see Authentication Methods.
Clique em Salvar. Você também pode testar a conexão antes de salvar.
Clique em Conectar. O Salesforce pode solicitar autenticação.
Na janela do navegador de arquivos, selecione o arquivo a ser lido ou gravado.
Selecione a configuração de leitura ou gravação na janela Opções.
Clique em Confirmar para criar uma conexão com o arquivo. Você pode continuar criando seu fluxo de trabalho.

Input and Output Tools

The Salesforce Input and Output tools are used to read from and write to Salesforce.

Salesforce Input

Salesforce Input reads standard and custom objects. You can read in three ways:

Query Builder: Pick an object and select the fields you want to read. The field picker offers a multiselect list with Select All, search by string or substring, a live count of selected versus total fields, and a filter to show only what's selected. A record limit can also be set. Four field modes are available: Read all Standard Fields, Read all Custom Fields, Read all Fields, and Choose Manually.
Custom Query (SOQL): Write a SOQL query to read standard and custom objects, including __r relationship fields, then validate it before running. A custom query always returns a single table.
Read from Report: Browse and search saved reports, select one report, and parse its results.

Salesforce Output

Salesforce Output writes rows to a standard or custom object. Choose an action:

Insert: Add new records.
Update: Modify existing records. Requires the Salesforce record ID.
Delete: Remove records. Requires the Salesforce record ID.
Upsert: Insert new records and update existing ones in a single action.

Output processes records in batches and lets you choose the Salesforce API version. When you use Update, Delete, or Upsert, include the record ID as the primary key in your data.

Object Model

Salesforce stores data in objects, which behave like database tables:

Standard objects are built in, for example Account, Contact, Lead, Opportunity, Case, Campaign, Task, Event, and User.
Custom objects are created in your org and end with __c, for example Invoice__c.
Relationship fields between objects use the __r suffix and can be referenced in SOQL.

Métodos de autenticação

O Salesforce é compatível com...

Method	Required Fields	Desktop (Flagship)	Cloud (Alteryx One)
Built-in app (OAuth 2.0)	None	Yes	Not available (built-in connection creation is not offered on Cloud)
Custom app (OAuth 2.0)	Client ID, Client Secret, Redirect URI (default `http://localhost:1717/`), Scope (default `api offline_access)`	Yes	Yes
Salesforce Credentials (username, password, security token)	Username, Password, Security Token (optional), Client ID, Client Secret	Yes	Yes
Custom domain across all methods	NA	Yes	Not available (custom domain is not supported for all methods on Cloud)

OAuth supports both the Authorization Code flow (user to app) and the Client Credentials flow (service principal, for headless or scheduled automation).

Migration to Unified Connector

If you already use the Salesforce connector in Alteryx, read the section below. It walks through what has been changed in the unified version.

Parameter	Legacy Connector	Unified Connector (v6.1.0)
Platforms and Tools	Desktop (Input and Output) Cloud (Input only)	Desktop (Input and Output) Cloud (Input and Output, in progress)
Framework	Python SDK (Desktop) CData ODBC driver (Cloud)	EACD framework (Desktop and Cloud)
Communication / API	Salesforce API v52 (Summer '21)	Salesforce API v61+ (Summer '24)
Auth methods	OAuth 2.0 Username + Password + Security Token	Same methods, with expanded configuration
Connection model	Separate Production / Sandbox / Custom URL choices	DCM, with a single Environment URL field

Key Changes

Production, Sandbox, and Custom URL dropdown options have been replaced by a single Environment URL field. Reconfigure any workflow that used this dropdown.
Environment URL replaces the old dropdown: https://login.salesforce.com (production, default), https://test.salesforce.com (sandbox), or your custom domain.
Salesforce Credentials authentication now also requires Client ID and Client Secret.
On Desktop, custom domains now work with all authentication methods (previously OAuth only).

Existing workflows can be migrated using the Alteryx Workflow Migration Utility in Designer 2025.2 Patch 3 or later. For more information, see workflow migration utility.

Nota

The migration utility is available on Desktop only.
After installing the unified connector, you may see both the legacy and unified Salesforce technologies listed in Manage Connections. This is expected during the transition. Use the unified connector for any new work.

Limitations

The connector does not support a dry run for reads or custom queries. Run the workflow to retrieve data, or use the SOQL validation step to check a custom query before running.
For objects with more than 200 fields, the Read all Custom Fields and Read all Fields modes fail. Use Choose Manually to pick the fields you need, or write a SOQL Custom Query that lists specific fields.
A SOQL Custom Query always returns one table. To combine data from multiple objects, join them within the SOQL query, or use multiple Input tools and blend the results in the workflow.
Read from Report supports selecting a single Report per Input tool. To read multiple reports, use multiple input tools.
The connector uses the Salesforce REST API. The Salesforce Bulk API is not yet supported. For very large reads or writes, expect REST API throughput and Salesforce API limits to apply.
The object and field data preview is available on Cloud but not on Desktop. On Desktop, configure fields using the Query Builder field list or a SOQL query.
On Cloud, custom domain support across all authentication methods is not available. Use a supported method for your Cloud connection, or connect from Desktop where custom domain works with all methods.
The workflow migration utility runs on Desktop only.
On Cloud, the built-in app connection creation flow is not offered. Use a Custom OAuth app or Salesforce Credentials on Cloud.
The datatypes produced from the same object can differ between Cloud and Desktop.
On Cloud, loading a dataset can fail for some objects. If a specific object does not load, try a SOQL Custom Query for that object or reduce the selected fields.
The connector is generally available on Desktop. Cloud support is in progress and not yet generally available.

Notas de versão do conector do Salesforce

Compatibilidade com o Designer (a ser discutida)

Versão de lançamento do Conector xxxx.x.x.xxxxx
JIRA-ID	Requires Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2, or 2026.2 GA for all authentication methods. Uses DCM and communicates via Salesforce API v61+ (Summer '24). DCM-based connections with a simplified connection setup (a single Environment URL, and Custom OAuth that exposes Redirect URI and Scope). Input: Query Builder: field Select All, search, count, filter, record limit. Read from Report with no record cap. SOQL Custom Query with validation. Choose API version. Output Insert, Update, Delete, and new Upsert action. Batch processing Choose API version. Fixed an issue where reading from a Salesforce report was limited to a fixed number of records (2000). This works only when using the standard REST API. Fixed an issue where DateTime values were returned as 00:00:00, and empty values are now handled correctly. Select All is now available on the column list. Reusing an idle Custom OAuth DCM connection no longer fails with a token error. Built-in app OAuth now authenticates correctly. Dataset loading can fail for certain objects on Cloud. Preview by schema is disabled for a Salesforce Custom Query.

Versão de lançamento do Conector xxxx.x.x.xxxxx

Descrição

JIRA-ID

Requires Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2, or 2026.2 GA for all authentication methods.
Uses DCM and communicates via Salesforce API v61+ (Summer '24).
DCM-based connections with a simplified connection setup (a single Environment URL, and Custom OAuth that exposes Redirect URI and Scope).
Input:
Query Builder: field Select All, search, count, filter, record limit.
Read from Report with no record cap.
SOQL Custom Query with validation.
Choose API version.
Output
Insert, Update, Delete, and new Upsert action.
Batch processing
Choose API version.
Fixed an issue where reading from a Salesforce report was limited to a fixed number of records (2000). This works only when using the standard REST API.
Fixed an issue where DateTime values were returned as 00:00:00, and empty values are now handled correctly.
Select All is now available on the column list.
Reusing an idle Custom OAuth DCM connection no longer fails with a token error.
Built-in app OAuth now authenticates correctly.
Dataset loading can fail for certain objects on Cloud.
Preview by schema is disabled for a Salesforce Custom Query.

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.