Salesforce

Il connettore di Salesforce permette di connettersi a Salesforce in 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.

Nuova versione del connettore in Designer

Ora il connettore Salesforce fa parte dell'esperienza dei connettori di Alteryx One. Rivedi attentamente le informazioni contenute in questa pagina per assicurarti di utilizzare correttamente gli strumenti appropriati.

Se vuoi aggiornare il connettore Salesforce nei tuoi flussi di lavoro Designer, puoi usare l'utilità Migrazione del flusso di lavoro.

Dettagli del connettore Salesforce

Salesforce è disponibile nelle versioni Designer 2025.2 Patch 3 e successive, come origine dati per lo strumento Dati di input. Per ulteriori dettagli sulle opzioni del tipo di file, vai a [collegamento].

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

Installazione del connettore

L'ultima versione del connettore Salesforce può essere facilmente installata da Designer tramite Componenti aggiuntivi. Se scegli questa modalità di installazione dei connettori, non è necessario visitare Alteryx Marketplace.

Per installare il connettore...

In Designer, vai a Componenti aggiuntivi > Gestisci componenti aggiuntivi Marketplace.
In Designer viene aperta una finestra con l'elenco dei connettori disponibili.
Digita Salesforce per cercare quello desiderato.

Configura la connessione con DCM.

Per la connessione a Salesforce con DCM...DCM - Designer

Trascina lo strumento Dati di input o Dati di output dalla tavolozza degli strumenti all'area di disegno, quindi selezionalo.
Se in precedenza hai già creato una connessione a Google Drive, puoi selezionare Origini dati > Salesforce > Connessione rapida e andare direttamente al passaggio 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.
Nella finestra Connessioni dati, seleziona Origini dati.
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.
Seleziona Salva. Puoi anche testare la connessione prima di salvare.
Seleziona Connetti. Salesforce può richiedere l'autenticazione.
Nella finestra di ricerca dei file, seleziona il file di lettura o scrittura.
Seleziona la configurazione di lettura o scrittura nella finestra Opzioni.
Seleziona Conferma per creare una connessione al file. Puoi continuare a creare il flusso di lavoro.

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.

Metodi di autenticazione

Salesforce supporta…

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.

Note di release del connettore Salesforce

Compatibilità con Designer (da discutere)

Versione di release del connettore 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.

Versione di release del connettore xxxx.x.x.xxxxx

Descrizione

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.

Connettori autonomi di Salesforce

Tipo di connessione	Strumenti Alteryx. La versione più recente è disponibile in Alteryx Marketplace.
Tipo di supporto	Lettura e scrittura
Convalidato su	La versione del client ODBC 2.2.20 è disponibile anche per gli strumenti Dati di input e Dati di output.

Note di release degli strumenti Salesforce

Versione	Descrizione
v5.1.4	Compatibile con Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Compatibile solo con AMP Engine. DCM necessario per il funzionamento di questo connettore in Alteryx Server. Il connettore Salesforce imposta automaticamente la precisione di Ora e Data e ora su millisecondi per evitare zeri decimali aggiuntivi, continuando a supportare la risoluzione in nanosecondi quando richiesto dal flusso di lavoro. (TPM-4753, TPM-4736) Risolto il problema a causa del quale gli strumenti Salesforce ignoravano le impostazioni del proxy su Server. (TPM-4647) Risolto il problema a causa del quale Server non poteva eseguire i flussi di lavoro con gli strumenti Salesforce perché dipendevano dai token di accesso di Designer. (TPM-4846) Risolto il problema a causa del quale gli strumenti per sviluppatori di Designer mostravano i valori segreti nei file JSON restituiti. (TPM-4788)
v5.1.3	Compatibile con Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Compatibile solo con AMP Engine. DCM necessario per il funzionamento di questo connettore in Alteryx Server. Aggiunto il supporto per i domini Salesforce personalizzati quando si utilizza DCM. Autenticazione migliorata. Aggiornato l'SDK alla versione 2.4.2. Aggiornata l'API alla versione più recente. Risolto il problema per il quale gli strumenti Salesforce ignoravano lo script PAC quando si utilizza DCM. (TPM-4620) Risolto il problema per il quale lo strumento Input Salesforce non riusciva a leggere alcune colonne del tipo di data. (TPM-4604) Risolto il problema per il quale lo strumento Output Salesforce non mostrava la mappatura del campo per l'operazione di aggiornamento. (TPM-4519) Risolto il problema per il quale gli strumenti Salesforce visualizzavano "Accesso negato" se il token di sicurezza non era creato in DCM. (TPM-4507) Risolto il problema per il quale gli strumenti Salesforce non disponevano della versione API allineata in base al tag front-end. (TPM-4493) Risolto il problema per il quale gli strumenti Salesforce non potevano connettersi utilizzando il dominio personalizzato. (TPM-4488) Risolto il problema per il quale gli strumenti Salesforce avvertivano di un troncamento imprevisto degli indicatori di data e ora. (TPM-4368) Risolto il problema per il quale lo strumento Input Salesforce troncava i valori quando si utilizzavano oggetti di relazione annidati in una query SOQL personalizzata. (TPM-4367) Risolto il problema per il quale gli strumenti Output Salesforce continuavano ad essere eseguiti se i flussi di lavoro contenevano più strumenti Output Salesforce. (TPM-4268) Risolto il problema per il quale gli strumenti Salesforce visualizzavano più versioni API come opzioni selezionabili. (TPM-4264) Risolto il problema per il quale lo strumento Output Salesforce non riusciva a scrivere i dati con le operazioni di inserimento e aggiornamento. (TPM-4248) Risolto il problema per il quale gli strumenti Salesforce non potevano leggere correttamente il tipo di dati percentuale. (TPM-4174) Risolto il problema per il quale gli strumenti Salesforce restituiva un errore con campi di data personalizzati. (TPM-4051) Risolto il problema per il quale gli strumenti Salesforce restituivano il messaggio "Codice di errore 400: Sintassi richiesta errata o metodo non supportato". (TPM-3982) Risolto il problema per il quale gli strumenti Salesforce ignoravano le impostazioni del proxy. (TPM-3919) Risolto il problema per il quale lo strumento Input Salesforce restituiva il campo versionData come URL anziché come corpo di un documento. (TPM-3662) Problemi noti Alcuni campi appaiono come Null dopo l'aggiornamento alla nuova versione degli strumenti Salesforce. (TPM-4805) I connettori SDK ignorano il proxy su Server (Galleria). (TPM-4647) Gli strumenti per sviluppatori HMTL di Designer mostrano il valore segreto nel JSON restituito. (TPM-4788) Le query restituiscono record nulli nello strumento Input Salesforce. (TPM-4641)
v5.1.2	Compatibile con Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Compatibile solo con AMP Engine. DCM necessario per il funzionamento di questo connettore in Alteryx Server. Aggiornato per l'esecuzione su Designer e Server 2024.1. Risolto il problema che interrompeva l'esecuzione di Input Salesforce dopo 45 minuti. (TPM-3556) Risolto il problema a causa del quale i metadati di origine e descrizione erano assenti. (TPM-3486) Risolto il problema a causa del quale gli strumenti Salesforce ignoravano le impostazioni del proxy. (TPM-3358) Risolto il problema a causa del quale Input Salesforce restituiva l'errore "Codice errore 401: Nessuna autorizzazione. Vedi gli schemi di autorizzazione". (TDCE-449 e TDCE-361)
v5.1.1	Compatibile con Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Compatibile solo con AMP Engine. DCM necessario per il funzionamento di questo connettore in Alteryx Server. Aggiornato per l'esecuzione su Designer e Server 2024.1. Risolto il problema che impediva in funzionamento dell'autenticazione tramite l'applicazione Oauth personalizzata. (TFLN-1912) Risolto il problema che causava l’esecuzione a oltranza di Input Salesforce quando questo era configurato per la lettura di un set di dati vuoto. (TPM-2453) Problemi noti Lo strumento Salesforce 5.1.1 non funziona su Designer FIPS e Server FIPS. Come soluzione alternativa, utilizza la versione 5.1.0. (TFLN-1982) I metadati di origine e descrizione al momento non sono presenti nei risultati del flusso di lavoro. (TPM-3486)
v5.1.0	Compatibile con Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Compatibile solo con AMP Engine. Aggiunto il supporto per DCM in Output Salesforce. DCM necessario per il funzionamento di questo connettore in Alteryx Server. Output Salesforce è ora capace di operare con FIPS. Prestazioni della funzionalità di configurazione automatica migliorate. Aggiunta l'opzione di test simulato in Input Salesforce. Risolto il problema che impediva a Input Salesforce 5.0.10 di analizzare correttamente i tipi di dati. (TFLN-1676)
v5.0.10	Compatibile con Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Compatibile solo con AMP Engine. Aggiunto il supporto per DCM. DCM necessario per il funzionamento di questo connettore in Alteryx Server. Compatibile con FIPS. Aggiunto il supporto per l'autenticazione OAuth e i domini personalizzati. Risolto il problema a causa del quale Input Salesforce non mostrava tutti i campi e gli oggetti (TPM-1579) Risolto il problema a causa del quale Input Salesforce analizzava il file PAC in modo non corretto (TFLN-1243) Risolto il problema a causa del quale Input Salesforce non visualizzava la finestra di configurazione quando la lingua di Designer era impostata sul francese (TDCE-119) Problemi noti Report elenca solo i report recenti, non tutti quelli disponibili per l'utente. I report restituiscono solo i primi 2000 record.
v4.2.4	Risolve un problema relativo all'errore di analisi delle query personalizzate dallo strumento Input Salesforce. I lavori di Input Salesforce non avranno più esito negativo quando pianificati o eseguiti dalla riga di comando. Risolve un problema di verifica del certificato nello strumento Input Salesforce. Supporta il caricamento dello strumento Input Salesforce in Gallery senza token.
v4.1.0	Aggiunto il supporto per la connessione tramite un proxy utilizzando il rilevamento e la configurazione automatici. Compatibile con Alteryx versione 2019.2 e successive.
v4.0.0	Aggiunta la possibilità di eseguire query sui report Salesforce. Per impostazione predefinita, Query Builder e Query personalizzata restituiscono tutti i record (inclusi quelli eliminati). Aggiungi 'isDeleted=False' nella clausola WHERE per escludere i record eliminati. Compatibile con Alteryx versione 2018.3 - 2019.2.
v3.1	Corregge i difetti relativi al limite di record nella scheda Runtime della configurazione del flusso di lavoro e alle password contenenti caratteri speciali XML. Compatibile con Alteryx versione 11.0 - 2018.2.

Note di release dello strumento Output Salesforce (obsoleto)

Versione	Descrizione
v1.3.1	Aggiornamento delle metainformazioni dello strumento
v1.3	È stata aggiornata la versione dell'API Salesforce nell'engine delle macro. È stato corretto un difetto per consentire la corretta esecuzione dell'escape dei caratteri.
v1.2	I campi Data e ora vengono convertiti automaticamente nel formato AAAA-MM-GGThh:mm:ss.sss. È stato risolto un problema per cui venivano visualizzati i messaggi di errore "Il nome tabella è obbligatorio" e "L'operazione di output è necessaria" anche se l'utente non era ancora connesso.