Salesforce

Il connettore di Salesforce permette di connettersi a Salesforce in Designer. Puoi utilizzarlo per leggere dati dagli oggetti Salesforce e scrivere dati in Salesforce tramite un singolo connettore che presenta lo stesso comportamento sia in Alteryx Designer (Desktop) che in Alteryx One (Cloud).

Salesforce è disponibile come origine dati sia negli strumenti Dati di input e Dati di output, sia tramite gli strumenti autonomi di Input di Salesforce e Output di Salesforce. Output Data Tool Icon Strumento Dati di output

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.

Configurazione del connettore di Salesforce

Salesforce è disponibile in Designer 2025.1.2, Patch 7 o versioni successive. Se hai già utilizzato il connettore di Salesforce, consulta la sezione Migrazione al connettore unificato.

Prerequisiti

Prima di procedere, verifica la disponibilità di tutti i prerequisiti seguenti:

Requisito	Dettaglio
Versione di Designer	2025.1 Patch 5, 2025.2 Patch 3, 2026.1 o versione successiva (tutte le funzioni, ad eccezione di OAuth integrata e personalizzata) 2025.1.2 Patch 7, 2025.2.1 Patch 5 o 2026.1 (tutti i metodo di autenticazione)
Configurazione dell'app personalizzata (OAuth 2.0), se utilizzata	Un'app Salesforce connessa, con ID client, segreto client, URI di reindirizzamento (deve corrispondere all'app connessa) e ambito
URL dell'ambiente	Ambiente di produzione (impostazione predefinita), Sandbox o dominio personalizzato
DCM	È necessario abilitare DCM in Designer, accedendo a Opzioni > Impostazioni avanzate > DCM

Installazione del connettore

L'ultima versione del connettore di Salesforce può essere facilmente installata da Designer tramite Componenti aggiuntivi. Questo è il metodo di installazione consigliato, poiché consente di cercare, installare e aggiornare i connettori senza uscire da Designer e senza visitare Alteryx Marketplace.

Per installare il connettore...

In Designer, vai a Componenti aggiuntivi > Gestisci componenti aggiuntivi Marketplace. Viene visualizzato l'elenco dei connettori disponibili.
Seleziona Connettore di Salesforce, quindi Installa. Designer scarica e installa il pacchetto. Per completare l'installazione, potrebbe essere necessario riavviare Designer.
Terminate le fasi di installazione e configurazione, il connettore di Salesforce è disponibile negli strumenti Dati di input e Dati di output.

Configurazione di una connessione

Per connettersi a Salesforce tramite DCM...DCM - Designer

Trascina lo strumento Dati di input o Dati di output sull'area di disegno e seleziona Connessione ai dati.
In Configurazione del connettore, seleziona Crea o Sfoglia una connessione dati.
Se in precedenza hai creato una connessione a Salesforce, puoi selezionarla dalla scheda Recenti.
Seleziona +Nuova. Dall'elenco delle tecnologie, seleziona Salesforce.
Seleziona Connessione rapida, quindi Imposta connessione. Viene visualizzata la finestra Connessioni.
Seleziona +Nuovo.
Specifica il nome della connessione e quello dell'origine dati. Seleziona l'ambiente.
Nella sezione Credenziali seleziona il tuo metodo di autenticazione, quindi inserisci il nome della credenziale. Per ulteriori informazioni, consulta la sezione Metodi di autenticazione.
Seleziona Salva.
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.

Migrazione al connettore unificato

Se utilizzi già il connettore di Salesforce in Alteryx, leggi la sezione che segue per scoprire le modifiche apportate alla versione unificata.

Parametro	Connettore legacy	Connettore unificato (v6.1.0)
Piattaforme e strumenti	Desktop (Input e Output) Cloud (solo Input)	Desktop (Input e Output) Cloud (l'introduzione di Input e Output è ancora in corso)
Framework	Python SDK (Desktop) Driver ODBC CData (Cloud)	Framework EACD (Desktop e Cloud)
Comunicazione/API	API Salesforce v52 (estate 2021)	API Salesforce v61 o successiva (estate 24)
Metodi di autenticazione	OAuth 2.0 Nome utente + Password + Token di sicurezza	Stessi metodi, con configurazione estesa
Modello di connessione	Opzioni separate per produzione/Sandbox/URL personalizzato	DCM, con un campo singolo per l'URL dell'ambiente

Modifiche principali

Le opzioni Produzione, Sandbox e URL personalizzato del menu a tendina sono state sostituite dal campo singolo URL ambiente. Tutti i flussi di lavoro che utilizzano questi menu a tendina devono essere riconfigurati.
Il campo URL ambiente sostituisce le voci https://login.salesforce.com (URL dell'ambiente di produzione predefinito), https://test.salesforce.com (URL dell'ambiente sandbox) e Dominio personalizzato del vecchio menu a tendina.
Per l'autenticazione tramite credenziali Salesforce, ora devi fornire anche l'ID e la chiave segreta del client.
In Desktop, ora i domini personalizzati supportano tutti i metodi di autenticazione (in precedenza era supportato solo OAuth).

Per migrare i flussi di lavoro preesistenti è possibile utilizzare l'Utilità Migrazione del flusso di lavoro Alteryx, disponibile in Designer 2025.2 Patch 3 e versioni successive, Per ulteriori informazioni, consulta la sezione Utilità Migrazione del flusso di lavoro.

Nota

L'utilità di migrazione è disponibile solo su Desktop.
Dopo l'installazione del connettore unificato, in Gestisci connessioni potrebbero essere visualizzate sia le tecnologie legacy che quelle unificate di Salesforce. Si tratta di un comportamento previsto durante la transizione. Per tutti i nuovi progetti devi utilizzare il connettore unificato.

Informazioni sul connettore Salesforce

Strumenti Input e Output

Gli strumenti Input e Output di Salesforce consentono di leggere e scrivere in Salesforce.

Input di Salesforce

Lo strumento Input di Salesforce consente di leggere oggetti standard e personalizzati, scegliendo fra tre metodi diversi:

Query Builder: scegli un oggetto e seleziona i campi da leggere. Il selettore campi offre un elenco a selezione multipla, con la possibilità di selezionare tutti i campi, una funzione di ricerca a livello di stringa o sottostringa, un conteggio in tempo reale dei campi selezionati rispetto al totale e un filtro che consente di visualizzare solo i campi selezionati. Puoi anche impostare un limite di record. Per i campi sono disponibili quattro modalità: Leggi tutti i campi standard, Leggi tutti i campi personalizzati, Leggi tutti i campi e Scegli manualmente.
Query personalizzata (SOQL): puoi scrivere una query SOQL per leggere oggetti standard e personalizzati, inclusi i campi di relazione __r, quindi convalidarla prima dell'esecuzione. Una query personalizzata restituisce sempre una tabella singola.
Leggi da report: puoi sfogliare e cercare i report salvati, selezionare un report e analizzarne i risultati.

Output di Salesforce

Lo strumento Output di Salesforce può scrivere le righe in un oggetto standard o personalizzato. Scegli un'azione:

Inserisci: consente di aggiungere nuovi record.
Aggiorna: consente di modificare i record esistenti. Richiede l'ID record Salesforce.
Elimina: consente di rimuovere record. Richiede l'ID record Salesforce.
Upsert: consente di inserire nuovi record e aggiornare quelli esistenti tramite una singola azione.

I record dei processi vengono restituiti in batch ed è possibile scegliere la versione dell'API di Salesforce. Quando utilizzi Aggiorna, Elimina o Upsert devi includere l'ID record nei dati, come chiave primaria.

Modello a oggetti

Salesforce memorizza i dati in oggetti, che si comportano come tabelle di database:

Gli oggetti standard, come gli account, i contatti, i lead, le opportunità, i casi, le campagne, le attività, gli eventi e gli utenti, sono incorporati.
Gli oggetti personalizzati vengono creati all'interno dell'organizzazione dell'utente e terminano con __c, ad esempio Fattura__c.
I campi delle relazioni fra gli oggetti sono contraddistinti dal suffisso __r e possono essere referenziati in SOQL.

Metodi di autenticazione

Salesforce supporta tre metodi di autenticazione. Per scegliere quella appropriata per il tuo scenario di utilizzo, usa la tabella che segue.

Metodo	Campi obbligatori	Desktop (Flagship)	Cloud (Alteryx One)
App integrata (OAuth 2.0)	Nessuno	Sì	Non disponibile (Cloud non consente la creazione di connessioni integrate)
App personalizzata (OAuth 2.0)	ID client, segreto client, URI di reindirizzamento (valore predefinito: `http://localhost:1717/`), ambito (valore predefinito: `api offline_access)`	Sì	Sì
Credenziali Salesforce (nome utente, password, token di sicurezza)	Nome utente, password, token di sicurezza (facoltativo), ID client, segreto client	Sì	Sì
Dominio personalizzato per tutti i metodi	ND	Sì	Non disponibile (Cloud non supporta i domini personalizzati, con qualsiasi metodo).

OAuth supporta sia il flusso basato su codice di autorizzazione (da utente ad app), sia quello basato sulle credenziali client (entità di servizio per l'automazione headless o pianificata).

Limitazioni

Il connettore non supporta i test delle query di lettura o personalizzate. Per verificare il funzionamento di una query personalizzata prima di utilizzarla, esegui il flusso di lavoro per recuperare dati o utilizza la procedura di convalida SOQL.
Per gli oggetti con più di 200 campi, le modalità Leggi tutti i campi personalizzati e Leggi tutti i campi non funzionano. Per selezionare i campi necessari, o scrivere una query SOQL personalizzata che elenca campi specifici, utilizza Scegli manualmente.
Una query SOQL personalizzata restituisce sempre una tabella singola. Per combinare dati provenienti da oggetti diversi, puoi unirli all'interno della query SOQL oppure utilizzare più strumenti di input e combinare i risultati nel flusso di lavoro.
La funzione Leggi da report supporta la selezione di un singolo strumento Report per Input. Per leggere più report contemporaneamente, puoi utilizzare più strumenti di input.
Il connettore utilizza l'API REST di Salesforce. L'API Bulk di Salesforce non è ancora supportata. Per le operazioni di lettura e scrittura con grandi volumi di dati, il throughput è soggetto alle limitazioni delle API REST e delle API di Salesforce.
L'anteprima dei dati degli oggetti e dei campi è disponibile in Cloud ma non in Desktop. In Desktop, devi configurare i campi utilizzando l'elenco dei campi di Query Builder o una query SOQL.
Cloud non supporta i domini personalizzati, per qualsiasi metodo di autenticazione. Per la connessione da Cloud devi utilizzare un metodo supportato. In alternativa, stabilisci la connessione da Desktop, che consente di utilizzare i domini personalizzati con tutti i metodi.
L'Utilità Migrazione del flusso di lavoro funziona solo su Desktop.
Su Cloud non è disponibile il flusso di creazione delle connessioni applicative integrate. Devi utilizzare un'app OAuth personalizzata o le credenziali di Salesforce.
Uno stesso oggetto può produrre tipi di dati diversi a seconda che utilizzi Cloud o Desktop.
Per alcuni oggetti, Cloud potrebbe non riuscire a caricare il dataset. Se un oggetto specifico non viene caricato, prova a utilizzare una query SOQL personalizzata per tale oggetto o a ridurre il numero dei campi selezionati.
Su Desktop, il connettore è in fase di Disponibilità generale. In Cloud il supporto è in via di sviluppo e non è ancora disponibile per tutti gli utenti.

Note di release del connettore Salesforce

Salesforce - Versione 6.1.0

Connettore - Versione di release 6.1.0
v6.1.0	Richiede Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2 o 2026.2 GA per tutti i metodi di autenticazione. Utilizza DCM e comunica tramite l'API Salesforce, versione 61 e successive (estate 24). La configurazione delle connessioni basate su DCM è stata semplificata (singolo campo URL ambiente, e funzione OAuth personalizzata, che espone URI reindirizzamento e Ambito). Input: Query Builder: campo Seleziona tutto, Cerca, Conteggio , Filtro, Limite record. Lettura da report, senza limite di record. Query SOQL personalizzata con convalida. Scelta della versione dell'API. Output Azioni Inserisci, Aggiorna, Elimina e Upsert (nuova). Elaborazione in batch Scelta della versione dell'API. È stato risolto un problema che limitava la lettura dei report di Salesforce a un numero fisso di record (2000). Funziona solo quando si utilizza l'API REST standard. È stato risolto un problema che determinava la restituzione di 00:00:00 al posto dei valori di data e ora. Inoltre, ora i valori vuoti vengono gestiti correttamente. Per l'elenco delle colonne, ora è disponibile il comando Seleziona tutto. Il riutilizzo di una connessione OAuth DCM personalizzata non genera più un errore di token. La funzione OAuth integrata dell'app ora esegue l'autenticazione correttamente. In Cloud, il caricamento dei set di dati potrebbe non riuscire per alcuni oggetti. Per le query Salesforce personalizzate, l'anteprima in base allo schema è disabilitata.

Connettore - Versione di release 6.1.0

Versione

Descrizione

v6.1.0

Richiede Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2 o 2026.2 GA per tutti i metodi di autenticazione.
Utilizza DCM e comunica tramite l'API Salesforce, versione 61 e successive (estate 24).
La configurazione delle connessioni basate su DCM è stata semplificata (singolo campo URL ambiente, e funzione OAuth personalizzata, che espone URI reindirizzamento e Ambito).
Input:
Query Builder: campo Seleziona tutto, Cerca, Conteggio , Filtro, Limite record.
Lettura da report, senza limite di record.
Query SOQL personalizzata con convalida.
Scelta della versione dell'API.
Output
Azioni Inserisci, Aggiorna, Elimina e Upsert (nuova).
Elaborazione in batch
Scelta della versione dell'API.
È stato risolto un problema che limitava la lettura dei report di Salesforce a un numero fisso di record (2000). Funziona solo quando si utilizza l'API REST standard.
È stato risolto un problema che determinava la restituzione di 00:00:00 al posto dei valori di data e ora. Inoltre, ora i valori vuoti vengono gestiti correttamente.
Per l'elenco delle colonne, ora è disponibile il comando Seleziona tutto.
Il riutilizzo di una connessione OAuth DCM personalizzata non genera più un errore di token.
La funzione OAuth integrata dell'app ora esegue l'autenticazione correttamente.
In Cloud, il caricamento dei set di dati potrebbe non riuscire per alcuni oggetti.
Per le query Salesforce personalizzate, l'anteprima in base allo schema è disabilitata.

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.