Per interagire con i dati all'interno di Salesforce® come parte di una catena, aggiungere un passo con un comando di connessione a Salesforce. Ad esempio:
- Caricare, estrarre ed eliminare i dati tramite SOQL e operazioni di massa
- Creare e gestire oggetti Salesforce
- Aggiornare e creare record
Per abilitare questi comandi, un amministratore IT deve innanzitutto creare un connettore Salesforce. Il connettore interagisce con tutte le versioni di Salesforce Sales Cloud - Salesforce Essentials®, Lightning® Professional, Lightning Enterprise e Lightning Unlimited - tramite l'API REST.
Eliminazione massiva
Per eliminare un gran numero di record basati su un file CSV (comma-separated values), utilizzare il comando Bulk delete.
Nota: Se la cancellazione di un record non va a buon fine, il comando restituisce un CSV che elenca i numeri di riga dei record non riusciti, insieme al motivo del fallimento. È possibile utilizzare la ramificazione per eseguire azioni quando il comando non riesce, oppure caricare gli errori in Google® Drive per un'analisi successiva.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Selezionare se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, selezionare Parallelo.
- Per elaborare i record in sequenza, selezionare Seriale.
Nota: Per un lavoro molto grande, selezionare Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità seriale può comportare tempi di processo molto più lunghi. |
| Nome dell'oggetto |
Inserire il tipo di oggetto su cui eseguire l'operazione. |
| File di ingresso |
Inserire il file che contiene i record da eliminare. |
| Formato del file |
Selezionare se il file di input è CSV, JSON o XML. |
| Dimensione del lotto |
Immettere il numero di record da elaborare per ogni batch. Si consiglia di lasciare il valore predefinito. |
| Attendere il completamento |
Per eseguire il polling di Salesforce e passare al comando successivo solo quando tutti i record sono stati elaborati, selezionare questa casella. Per attivare il comando e passare immediatamente alla fase successiva, deselezionare questa casella. |
Uscite
| Uscita |
Tipo di uscita |
| Registro degli errori di cancellazione massiva |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Inserto sfuso
Per inserire un grande volume di record basati su file CSV, utilizzare il comando Bulk insert.
Nota: Se l'inserimento di un record non riesce, il comando restituisce un CSV che elenca i numeri di riga dei record non riusciti, insieme al motivo del fallimento. È possibile utilizzare la ramificazione per eseguire azioni quando il comando non riesce, oppure caricare gli errori in Google® Drive per un'analisi successiva.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Selezionare se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, selezionare Parallelo.
- Per elaborare i record in sequenza, selezionare Seriale.
Nota: Per un lavoro molto grande, selezionare Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità seriale può comportare tempi di processo molto più lunghi. |
| Nome dell'oggetto |
Inserire il tipo di oggetto su cui eseguire l'operazione. |
| File di ingresso |
Inserire il file che contiene i record da inserire. |
| Formato del file |
Selezionare se il file di input è CSV, JSON o XML. |
| Dimensione del lotto |
Immettere il numero di record da elaborare per ogni batch. Si consiglia di lasciare il valore predefinito. |
| Attendere il completamento |
Per eseguire il polling di Salesforce e passare al comando successivo solo quando tutti i record sono stati elaborati, selezionare questa casella. Per attivare il comando e passare immediatamente alla fase successiva, deselezionare questa casella. |
Uscite
| Uscita |
Tipo di uscita |
| Registro degli errori di inserimento massivo |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Interrogazione massiva
Per interrogare un grande volume di record, utilizzare il comando Bulk query.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Selezionare se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, selezionare Parallelo.
- Per elaborare i record in sequenza, selezionare Seriale.
Nota: Per un lavoro molto grande, selezionare Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità seriale può comportare tempi di processo molto più lunghi. |
| Nome dell'oggetto |
Inserire il tipo di oggetto su cui eseguire l'operazione. |
| Query SOQL |
Inserire la query SOQL da eseguire. |
Uscite
| Uscita |
Tipo di uscita |
| Risultati della query in blocco CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Aggiornamento di massa
Per aggiornare un grande volume di record, utilizzare il comando Bulk update.
Nota: Se l'aggiornamento di un record non riesce, il comando restituisce un CSV che elenca i numeri di riga dei record non riusciti, insieme al motivo del fallimento. È possibile utilizzare la ramificazione per eseguire azioni quando il comando non riesce, oppure caricare gli errori in Google® Drive per un'analisi successiva.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Selezionare se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, selezionare Parallelo.
- Per elaborare i record in sequenza, selezionare Seriale.
Nota: Per un lavoro molto grande, selezionare Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità seriale può comportare tempi di processo molto più lunghi. |
| Nome dell'oggetto |
Inserire il tipo di oggetto su cui eseguire l'operazione. |
| File di ingresso |
Inserire il file che contiene i record da aggiornare. |
| Formato del file |
Selezionare se il file di input è CSV, JSON o XML. |
| Dimensione del lotto |
Immettere il numero di record da elaborare per ogni batch. Si consiglia di lasciare il valore predefinito. |
| Attendere il completamento |
Per eseguire il polling di Salesforce e passare al comando successivo solo quando tutti i record sono stati elaborati, selezionare questa casella. Per attivare il comando e passare immediatamente alla fase successiva, deselezionare questa casella. |
Uscite
| Uscita |
Tipo di uscita |
| Registro degli errori dell'aggiornamento massivo |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Upsert di massa
Per eseguire un upsert (aggiornare i record esistenti o crearne di nuovi in base a un ID esterno) su un grande volume di record, utilizzare il comando Bulk upsert.
Nota: Se l'upsert di un record non va a buon fine, il comando restituisce un CSV che elenca i numeri di riga dei record falliti e il motivo del fallimento. È possibile utilizzare la ramificazione per eseguire azioni quando il comando non riesce, oppure caricare gli errori in Google® Drive per un'analisi successiva.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Selezionare se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, selezionare Parallelo.
- Per elaborare i record in sequenza, selezionare Seriale.
Nota: Per un lavoro molto grande, selezionare Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità seriale può comportare tempi di processo molto più lunghi. |
| Nome dell'oggetto |
Inserire il tipo di oggetto su cui eseguire l'operazione. |
| File di ingresso |
Inserire il file che contiene i record da aggiornare. |
| Formato del file |
Selezionare se il file di input è CSV, JSON o XML. |
| Dimensione del lotto |
Immettere il numero di record da elaborare per ogni batch. Si consiglia di lasciare il valore predefinito. |
| Attendere il completamento |
Per eseguire il polling di Salesforce e passare al comando successivo solo quando tutti i record sono stati elaborati, selezionare questa casella. Per attivare il comando e passare immediatamente alla fase successiva, deselezionare questa casella. |
| ID esterno |
Per identificare se un record esiste già o deve essere creato, inserire il campo ID esterno richiesto per l'oggetto coinvolto nell'upsert. |
Uscite
| Uscita |
Tipo di uscita |
| Registro degli errori dell'upsert di massa |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Creare un record
Per creare un nuovo record in Salesforce, utilizzare il comando Create record.
Proprietà
| Proprietà |
Dettaglio |
| Nome |
Immettere il nome dell'oggetto SO per cui creare il record. |
| Campi |
Inserire i campi del record da aggiornare, nel formato FIELD_NAME:VALUE. |
Uscite
| Uscita |
Tipo di uscita |
| ID del nuovo record |
Stringa |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Cancellare il record
Per eliminare un record in Salesforce in base al suo ID, utilizzate il comando Delete record.
Proprietà
| Proprietà |
Dettaglio |
| ID |
Inserire l'ID del record da eliminare. Se l'ID è sconosciuto, inserire un ID esterno nel formato EXTERNAL_ID_NAME:VALUE, ad esempio Name:John. |
| Nome |
Inserire il nome dell'oggetto da cancellare. |
Uscite
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Scarica il rapporto
Per scaricare un report personalizzato in un file CSV (comma-separated values), utilizzare il comando Download report.
Proprietà
| Proprietà |
Dettaglio |
| ID rapporto |
Inserire l'ID del report personalizzato da scaricare. |
Uscite
| Uscita |
Tipo di uscita |
| Rapporto personalizzato CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Ottenere i metadati dell'oggetto
Per recuperare i campi e i metadati associati a un oggetto Salesforce, utilizzare il comando Get object metadata.
Proprietà
| Proprietà |
Dettaglio |
| Oggetto |
Inserire il nome dell'oggetto per cui recuperare i metadati. |
Uscite
| Uscita |
Tipo di uscita |
| Metadati dell'oggetto |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Ottenere il record
Per recuperare un record da Salesforce in base al suo ID, utilizzare il comando Get record.
Proprietà
| Proprietà |
Dettaglio |
| ID |
Inserire l'ID del record da recuperare. |
| Nome |
Inserire il nome dell'oggetto SO da cui recuperare il record. |
| Campi |
Inserire i campi del report da includere (opzionale). |
Uscite
| Uscita |
Tipo di uscita |
| Ottenere il record JSON |
JSON |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Elenco dei login
Per elencare i login nell'ambiente Salesforce, utilizzare il comando List logins.
Proprietà
Nessuno
Uscite
| Uscita |
Tipo di uscita |
| Elenco accessi CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Elenco oggetti
Per elencare gli oggetti SO da Salesforce, utilizzare il comando List objects.
Proprietà
Nessuno
Uscite
| Uscita |
Tipo di uscita |
| Elenco oggetti CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Rapporti dell'elenco
Per elencare i rapporti da Salesforce, utilizzare il comando List reports.
Proprietà
Nessuno
Uscite
| Uscita |
Tipo di uscita |
| Elenco rapporti CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Query SOQL
Per eseguire una query SOQL e generarne i risultati come file CSV, utilizzare il comando SOQL query.
Nota: la sintassi di SOQL è molto simile a quella di SQL. Il comando SOQL Query può estrarre grandi volumi di dati e restituire set di dati di 1 milione o più record alla volta. Se il comando fallisce perché la query non è corretta o fa riferimento a oggetti che non esistono, gli output del comando lo segnalano.
Proprietà
| Proprietà |
Dettaglio |
| Interrogazione |
Inserire la query SOQL da eseguire. |
| Comando di interrogazione |
Selezionare se includere i record eliminati.
- Per escludere i record eliminati da, selezionare Query.
- Per includere i record cancellati da, selezionare QueryAll.
|
Uscite
| Uscita |
Tipo di uscita |
| Output della query SOQL |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
SObject - creare
Per creare un nuovo oggetto SO in Salesforce, utilizzare il comando SOjbect- create.
Proprietà
| Proprietà |
Dettaglio |
| Nome |
Inserire il nome del nuovo SObject. Per indicare che si tratta di un oggetto personalizzato, Salesforce aggiunge automaticamente __c. |
| Campi |
Immettere i campi record da creare, nel formato FIELD_NAME:TYPE, dove TYPE corrisponde a un tipo di campo Salesforce. |
Uscite
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
SOggetto - eliminare
Per eliminare gli oggetti SO in Salesforce, utilizzare il comando SObject - delete.
Proprietà
| Proprietà |
Dettaglio |
| Nome |
Inserire il nome degli oggetti SO da creare. |
Uscite
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |
Aggiornamento del record
Per aggiornare i valori dei campi di un record in Salesforce, utilizzare il comando Update record.
Proprietà
| Proprietà |
Dettaglio |
| ID |
Inserire l'ID del record da aggiornare. |
| Nome |
Inserire il nome dell'oggetto SO da aggiornare. |
| Campi |
Inserire i campi del record da aggiornare, nel formato FIELD_NAME:VALUE. |
Uscite
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Il successo |
Il successo |
| 1 |
Errore |
Fallimento generale |