Per interagire con i dati all'interno di Salesforce® come parte di una catena, aggiungi un passo con un comando di connessione a Salesforce. Ad esempio:
- Caricare, estrarre e cancellare dati tramite SOQL e operazioni in blocco
- 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 cancellare un gran numero di record basati su un file CSV (comma-separated values), usa il comando Bulk delete.
Nota: Se l'eliminazione di un record non riesce, il comando restituisce un CSV che elenca i numeri di riga dei record non riusciti e il motivo del fallimento. Puoi utilizzare la ramificazione per eseguire azioni quando il comando fallisce o per caricare gli errori in Google® Drive per un'analisi successiva.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Seleziona se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, seleziona Parallelo.
- Per elaborare i record in sequenza, seleziona Seriale.
Nota: Per un lavoro molto grande, seleziona Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità Seriale può comportare tempi di elaborazione molto più lunghi. |
| Nome SObject |
Inserisci il tipo di SObject su cui eseguire l'operazione. |
| File di input |
Inserisci il file che contiene i record da cancellare. |
| Formato del file |
Seleziona se Il file di input è CSV, JSON o XML. |
| Dimensione del lotto |
Inserisci il numero di record da elaborare per batch. Si consiglia di lasciare l'impostazione predefinita. |
| Attendi il completamento |
Per interrogare Salesforce e passare al comando successivo solo quando tutti i record sono stati elaborati, seleziona questa casella. Per attivare il comando e passare immediatamente alla fase successiva, deseleziona questa casella. |
Output
| Output |
Tipo di output |
| Eliminazione massiva del registro degli errori |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Inserimento massivo
Per inserire una grande quantità di record basati su un file CSV, usa 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 e il motivo del fallimento. Puoi utilizzare la ramificazione per eseguire azioni quando il comando fallisce o per caricare gli errori in Google® Drive per un'analisi successiva.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Seleziona se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, seleziona Parallelo.
- Per elaborare i record in sequenza, seleziona Seriale.
Nota: Per un lavoro molto grande, seleziona Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità Seriale può comportare tempi di elaborazione molto più lunghi. |
| Nome SObject |
Inserisci il tipo di SObject su cui eseguire l'operazione. |
| File di input |
Inserisci il file che contiene i record da inserire. |
| Formato del file |
Seleziona se Il file di input è CSV, JSON o XML. |
| Dimensione del lotto |
Inserisci il numero di record da elaborare per batch. Si consiglia di lasciare l'impostazione predefinita. |
| Attendi il completamento |
Per interrogare Salesforce e passare al comando successivo solo quando tutti i record sono stati elaborati, seleziona questa casella. Per attivare il comando e passare immediatamente alla fase successiva, deseleziona questa casella. |
Output
| Output |
Tipo di output |
| Registro degli errori di inserimento massivo |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Interrogazione massiva
Per interrogare un grande volume di record, usa il comando Bulk query.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Seleziona se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, seleziona Parallelo.
- Per elaborare i record in sequenza, seleziona Seriale.
Nota: Per un lavoro molto grande, seleziona Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità Seriale può comportare tempi di elaborazione molto più lunghi. |
| Nome SObject |
Inserisci il tipo di SObject su cui eseguire l'operazione. |
| Query SOQL |
Inserisci la query SOQL da eseguire. |
Output
| Output |
Tipo di output |
| Risultati della query in blocco CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Aggiornamento in blocco
Per aggiornare un gran numero di record, usa il comando Bulk update.
Nota: Se un record non viene aggiornato, il comando restituisce un CSV che elenca i numeri di riga dei record falliti e il motivo del fallimento. Puoi utilizzare la ramificazione per eseguire azioni quando il comando fallisce o per caricare gli errori in Google® Drive per un'analisi successiva.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Seleziona se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, seleziona Parallelo.
- Per elaborare i record in sequenza, seleziona Seriale.
Nota: Per un lavoro molto grande, seleziona Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità Seriale può comportare tempi di elaborazione molto più lunghi. |
| Nome SObject |
Inserisci il tipo di SObject su cui eseguire l'operazione. |
| File di input |
Inserisci il file che contiene i record da aggiornare. |
| Formato del file |
Seleziona se Il file di input è CSV, JSON o XML. |
| Dimensione del lotto |
Inserisci il numero di record da elaborare per batch. Si consiglia di lasciare l'impostazione predefinita. |
| Attendi il completamento |
Per interrogare Salesforce e passare al comando successivo solo quando tutti i record sono stati elaborati, seleziona questa casella. Per attivare il comando e passare immediatamente alla fase successiva, deseleziona questa casella. |
Output
| Output |
Tipo di output |
| Registro degli errori dell'aggiornamento massivo |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Upsert massivo
Per eseguire un upsert (aggiornare i record esistenti o crearne di nuovi in base a un ID esterno) su un grande volume di record, usa il comando Bulk upsert.
Nota: Se un record non riesce a fare l'upsert, il comando restituisce un CSV che elenca i numeri di riga dei record falliti e il motivo del fallimento. Puoi utilizzare la ramificazione per eseguire azioni quando il comando fallisce o per caricare gli errori in Google® Drive per un'analisi successiva.
Proprietà
| Proprietà |
Dettaglio |
| Modalità Concorrenza |
Seleziona se elaborare i record contemporaneamente o in sequenza.
- Per elaborare i record contemporaneamente, seleziona Parallelo.
- Per elaborare i record in sequenza, seleziona Seriale.
Nota: Per un lavoro molto grande, seleziona Seriale, poiché il volume delle connessioni al database potrebbe far fallire il lavoro in modalità Parallela. Tuttavia, la modalità Seriale può comportare tempi di elaborazione molto più lunghi. |
| Nome SObject |
Inserisci il tipo di SObject su cui eseguire l'operazione. |
| File di input |
Inserisci il file che contiene i record da aggiornare. |
| Formato del file |
Seleziona se Il file di input è CSV, JSON o XML. |
| Dimensione del lotto |
Inserisci il numero di record da elaborare per batch. Si consiglia di lasciare l'impostazione predefinita. |
| Attendi il completamento |
Per interrogare Salesforce e passare al comando successivo solo quando tutti i record sono stati elaborati, seleziona questa casella. Per attivare il comando e passare immediatamente al passo successivo, deseleziona questa casella. |
| ID esterno |
Per sapere se un record esiste già o deve essere creato, inserisci il campo ID esterno richiesto per l'oggetto coinvolto nell'upsert. |
Output
| Output |
Tipo di output |
| Registro degli errori di upsert massivo |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Crea record
Per creare un nuovo record in Salesforce, usa il comando Create record.
Proprietà
| Proprietà |
Dettaglio |
| Nome |
Inserisci il nome del SObject in cui creare il record. |
| Campi |
Inserisci i campi del record da aggiornare, nel formato FIELD_NAME:VALUE. |
Output
| Output |
Tipo di output |
| ID del nuovo record |
Stringa |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Elimina record
Per eliminare un record in Salesforce in base al suo ID, usa il comando Delete record.
Proprietà
| Proprietà |
Dettaglio |
| ID |
Inserisci l'ID del record da cancellare. Se l'ID è sconosciuto, inserisci un ID esterno nel formato EXTERNAL_ID_NAME:VALUE, ad esempio Name:John. |
| Nome |
Inserisci il nome dell'oggetto SO sotto cui cancellare il record. |
Output
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Scarica il report
Per scaricare un report personalizzato come file CSV (comma-separated values), usa il comando Download report.
Proprietà
| Proprietà |
Dettaglio |
| ID rapporto |
Inserisci l'ID del report personalizzato da scaricare. |
Output
| Output |
Tipo di output |
| Rapporto personalizzato CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Ottieni metadati dell'oggetto
Per recuperare i campi e i metadati associati a un oggetto Salesforce, usa il comando Get object metadata.
Proprietà
| Proprietà |
Dettaglio |
| Oggetto |
Inserisci il nome dell'oggetto per cui recuperare i metadati. |
Output
| Output |
Tipo di output |
| Metadati dell'oggetto |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Ottieni record
Per recuperare un record da Salesforce in base al suo ID, usa il comando Get record.
Proprietà
| Proprietà |
Dettaglio |
| ID |
Inserisci l'ID del record da recuperare. |
| Nome |
Inserisci il nome del SObject con cui recuperare il record. |
| Campi |
Inserisci i campi del report da includere (opzionale). |
Output
| Output |
Tipo di output |
| Ottieni il record JSON |
JSON |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Elenca i login
Per elencare i login nell'ambiente Salesforce, usa il comando List logins.
Proprietà
Nessuno
Output
| Output |
Tipo di output |
| Elenco dei login CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Elenca oggetti
Per elencare gli oggetti SO da Salesforce, usa il comando List objects.
Proprietà
Nessuno
Output
| Output |
Tipo di output |
| Elenco oggetti CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Elenca report
Per elencare i rapporti da Salesforce, usa il comando List reports.
Proprietà
Nessuno
Output
| Output |
Tipo di output |
| Elenca i rapporti CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Query SOQL
Per eseguire una query SOQL e generare i risultati in un file CSV, usa 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 insiemi di dati di 1 milione o più record alla volta. Se il comando fallisce perché la query non è corretta o fa riferimento a oggetti inesistenti, gli output del comando ti avviseranno.
Proprietà
| Proprietà |
Dettaglio |
| Query |
Inserisci la query SOQL da eseguire. |
| Comando della query |
Seleziona se includere i record cancellati.
- Per escludere i record cancellati, seleziona Query.
- Per includere i record cancellati, seleziona QueryAll.
|
Output
| Output |
Tipo di output |
| Uscita della query SOQL |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
SObject - crea
Per creare un nuovo oggetto SO in Salesforce, usa il comando SOjbect- create.
Proprietà
| Proprietà |
Dettaglio |
| Nome |
Inserisci il nome del nuovo oggetto SO. Per indicare che si tratta di un oggetto personalizzato, Salesforce aggiunge automaticamente __c. |
| Campi |
Inserisci i campi del record da creare nel formato FIELD_NAME:TYPE, dove TYPE corrisponde a un tipo di campo Salesforce. |
Output
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
SObject - elimina
Per eliminare gli oggetti SO in Salesforce, usa il comando SObject - delete.
Proprietà
| Proprietà |
Dettaglio |
| Nome |
Inserisci il nome dell'oggetto SO da creare. |
Output
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
Aggiorna record
Per aggiornare i valori dei campi di un record in Salesforce, usa il comando Update record.
Proprietà
| Proprietà |
Dettaglio |
| ID |
Inserisci l'ID del record da aggiornare. |
| Nome |
Inserisci il nome del SObject con cui aggiornare il record. |
| Campi |
Inserisci i campi del record da aggiornare, nel formato FIELD_NAME:VALUE. |
Output
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 1 |
Errore |
Errore generale |
<!--## Recipes
### Extract Data from Salesforce to Anaplan
To extract data from Salesforce as a CSV file and upload it directly to Anaplan®:
1. Create the chain:
1. In **Chains**, click **Add**.
2. Enter a unique name to identify the chain.
3. Click **Save**.
2. To execute a SOQL query to extract data from Salesforce as the first step of the chain:
3. Click **Add a command**.
4. Select **Salesforce**, **SOQL Query**.
4. Select the Salesforce connector.
5. Enter the query and its parameters.
6. Click **Save**.
3. To load the CSV output into Anaplan as the second step:
1. Click **Add a command**, and in **Run Condition**, select Success.
2. Select **Anaplan**, **Upload file**.
3. Select the Anaplan connector.
4. Enter the properties of the command. For **Source File**, select **SOQL Query Output**.
5. Click **Save**.
4. Click **Publish**.
-->