Estrattore Salesforce

Informazioni sull’attività dell’estrattore di Salesforce

L’attività Estrattore di Salesforce può essere utilizzata per importare dati da Salesforce da utilizzare in Qualtrics. È possibile importare i seguenti dati da Salesforce:

• Oggetti (come Account, Contatti e Opportunità).
• E-mail collegate a casi chiusi.
• Dati del rapporto.

Alla prima esecuzione, l’attività importerà tutti i record specificati. Nelle esecuzioni successive, verranno inseriti i record nuovi o aggiornati dall’ultima esecuzione.

Estrazione di oggetti da Salesforce

Questa sezione spiega come impostare questa attività per importare record di oggetti (come Account, Contatti e Opportunità) da Salesforce.

1. Creare un nuovo flusso di lavoro ETL.
2. Selezionare Origine dati (estrattore ETL).
3. Cercate l’attività Salesforce Extractor.
4. Selezionare gli oggetti.
5. Fare clic su Successivo.
6. Selezionare l’account Salesforce da cui importare i dati.
7. Se desiderate aggiungere un nuovo account Salesforce, fate clic su Aggiungi un account utente. È possibile connettersi direttamente a un account di produzione o sandbox, oppure impostare una connessione da server a server. Per ulteriori informazioni su ciascun metodo di autenticazione, vedere Collegamento tra Qualtrics e Salesforce.
   Consiglio: tutti gli account Salesforce precedentemente collegati e quelli impostati dai Brand Administrator saranno disponibili qui.
   Attenzione: Per questa attività si possono avere fino a 5 connessioni esterne al proprio account Salesforce. Se si aggiungono più di 5 connessioni, la connessione più vecchia verrà interrotta.
8. Fare clic su Successivo.
9. Fare clic su Aggiungi oggetto e scegliere loggetto da importare. È possibile importare più oggetti nella stessa attività di estrazione.
   I seguenti oggetti Salesforce sono disponibili per l’importazione:
   • Account
   • Caso
   • Contatto
   • Lead
   • Opportunità
     Consiglio Q: se non ci sono oggetti qui, la connessione tra il vostro account Salesforce e Qualtrics non è valida o è scaduta. Tornate alla schermata di selezione dell’account facendo clic su “Indietro” e aggiungete un nuovo account Salesforce.
10. Se lo si desidera, utilizzare il menu a discesa dell’elenco di Salesforce per limitare gli oggetti importati in base ai criteri di filtro dell’elenco in Salesforce (chiamato Vista elenco). Se non si seleziona alcuna opzione, verranno importati tutti gli oggetti associati.
11. Fare clic su Aggiungi campo, che aggiungerà un menu a discesa per la scelta del campo.
12. Usare il menu a discesa Seleziona campo per scegliere un campo da importare da Salesforce.
13. Ripetere i passaggi precedenti per importare altri campi per l’oggetto Salesforce selezionato.
    Consiglio Q: fare clic sull’icona del cestino avanti a un campo o a un oggetto per rimuoverlo dall’attività.
14. Al termine, fare clic su Salva.
15. Avanti, dovrete salvare i dati in Qualtrics utilizzando un’attività di caricamento. In genere si tratta dell’attività “Aggiungi contatti e transazioni alla Directory XM“.

Risoluzione dei problemi relativi alle importazioni di oggetti di Salesforce

Se il flusso di lavoro non viene completato, andare alla cronologia sessioni del flusso di lavoro per ottenere ulteriori informazioni sul fallimento. Di seguito sono riportati gli errori più comuni e le relative soluzioni:

• “Le credenziali di accesso a Salesforce non sono valide, si prega di riconnettersi”
  • Le credenziali utilizzate con l’attività non sono valide e devono essere reinserite. Per risolvere il problema, modificare l’attività che non è riuscita e scegliere un’altra credenziale valida o aggiungerne una nuova.
• “La ListView {{listviewId}} per sObject {{sObjectName}} non esiste”
  • L’elenco utilizzato nell’attività non è accessibile all’utente o è stato eliminato. Per risolvere questo problema, modificare l’attività che non è riuscita e selezionare l’oggetto che ha una lista non valida. Quindi, scegliere una nuova lista da utilizzare. Il campo {{listviewId}} nel messaggio di errore contiene l’ID della lista in Salesforce e il campo {{sObjectName}} è il nome dell’oggetto in Salesforce.
• sObject {{sObjectName}} non esiste
  • L’oggetto utilizzato con l’attività non è accessibile all’utente o è stato eliminato. Per risolvere il problema, modificare l’attività fallita, rimuovere l’oggetto non valido e salvare l’attività. Il campo {{sObjectName}} del messaggio di errore contiene il nome dell’oggetto in Salesforce.
• Il campo {{fieldName}} in sObject {{sObjectId}} non esiste
  • Il campo utilizzato nell’attività non è accessibile all’utente o è stato eliminato. Per risolvere il problema, modificare l’attività fallita, rimuovere il campo non valido e salvare l’attività. Il campo {{fieldName}} nel messaggio di errore contiene il nome del campo in Salesforce e il campo {{sObjectId}} è l’ID dell’oggetto in Salesforce.
• Impossibile determinare l’isolamento dei dati
  • Se si verifica questo errore, contattare il supporto Qualtrics.
• Si è verificato un errore inatteso
  • Se si verifica questo errore, contattare il supporto Qualtrics.
• Si è verificato un errore con Sandbox
  • Se si verificano errori con Sandbox, si consiglia di utilizzare una versione non Sandbox per risolvere il problema. Gli ambienti Sandbox sono destinati a scopi di test e non sempre hanno le stesse performance degli ambienti non Sandbox.

Estrazione delle e-mail da Salesforce

Questa sezione spiega come estrarre le e-mail da Salesforce per utilizzarle in un progetto di dati sulle e-mail (nell’ambito della gestione dell’ascolto omnichannel).

1. Dalla scheda Flussi di lavoro del progetto OXM, creare un nuovo flusso di lavoro ETL.
2. Selezionare Origine dati (estrattore ETL).
3. Cercate l’attività Salesforce Extractor.
4. Selezionate Email.
5. Fare clic su Successivo.
6. Selezionare l’account Salesforce da cui importare i dati.
7. Se desiderate aggiungere un nuovo account Salesforce, fate clic su Aggiungi un account utente.
   Consiglio: tutti gli account Salesforce precedentemente collegati e quelli impostati dai Brand Administrator saranno disponibili qui.
   Attenzione: Per questa attività si possono avere fino a 5 connessioni esterne al proprio account Salesforce. Se si aggiungono più di 5 connessioni, la connessione più vecchia verrà interrotta.
8. Fare clic su Successivo.
9. Selezionare lo stato del caso Salesforce che si desidera importare. È possibile selezionare più di uno stato.
   Attenzione: È possibile selezionare solo gli stati dei casi considerati “chiusi” in Salesforce. Lo stato predefinito “Chiuso” è uno di questi e si possono avere altri stati personalizzati che sono anch’essi “chiusi”, impostati da un amministratore in Salesforce.
10. Scegliere la data per determinare quali e-mail vengono estratte. Alla prima esecuzione dell’attività, verranno estratte le e-mail il cui caso ha una “Data di chiusura” compresa tra la data selezionata e la prima data di esecuzione dell’attività (impostata dalla pianificazione durante la creazione del flusso di lavoro ETL).
    Consiglio Q: Nelle esecuzioni successive, l’estrazione delle e-mail avverrà solo se la “Data di chiusura” del caso è compresa tra l’esecuzione precedente e quella attuale (determinata dalla pianificazione ETL).
    Consiglio Q: È possibile impostare un intervallo di tempo personalizzato per estrarre i dati da un intervallo di date specifico facendo clic sul pulsante Esegui immediatamente nella parte superiore del flusso di lavoro. Ciò consente di “ignorare” il comportamento di estrazione dei dati predefinito di cui sopra. Per istruzioni dettagliate, vedere Estrazione di dati da un intervallo di date specifico. Si noti che questa opzione è disponibile solo quando si estraggono le e-mail da Salesforce.
11. Fare clic su Successivo.
12. Nella pagina avanti dell’estrattore, si vedranno i campi di Salesforce collegati all’oggetto EmailMessage di Salesforce.
    Attenzione: I campi composti di Salesforce non appaiono qui, poiché non possono essere importati in Qualtrics.
13. La parte sinistra della tabella contiene campi opzionali che possono essere importati, se lo si desidera. Alcuni progetti sono contrassegnati come “Preferiti”, poiché possono essere utili in un progetto OXM.
14. La parte destra della tabella contiene i campi che saranno importati in Qualtrics.
    Consiglio Q: alcuni attributi sono obbligatori e saranno già presenti in questa colonna. Non possono essere rimossi.
15. Per spostare un campo tra i due lati della tabella, fare clic sul campo e poi sul pulsante freccia. È possibile fare clic su più campi per selezionarli contemporaneamente.
16. Fare clic su AVANTI.
17. La pagina Avanti contiene i campi del Caso. Solo i casi con e-mail saranno importati in QUALTRrics. È possibile regolare i campi importati in Qualtrics utilizzando lo stesso metodo di prima.
18. Fare clic su Successivo.
19. L’ultima pagina contiene i campi collegati all’oggetto Account (che è collegato all’oggetto Caso in Salesforce tramite AccountId). È possibile regolare i campi importati in Qualtrics utilizzando lo stesso metodo di prima.
20. Fare clic su Successivo.
21. Dopo aver estratto i dati da Salesforce, è necessario indicare a Qualtrics dove salvare i dati con un’attività di caricamento dati. Quando si estraggono le e-mail da Salesforce, si utilizza l’attività Carica dati su Conversational Analytics per caricare i dati in un progetto Dati e-mail.

Estrazione dei dati dei rapporti da Salesforce

Questa sezione spiega come estrarre i dati dai rapporti di Salesforce per utilizzarli in Qualtrics.

1. Creare un nuovo flusso di lavoro ETL.
2. Selezionare Origine dati (estrattore ETL).
3. Cercate l’attività Salesforce Extractor.
4. Selezionare Rapporti. 
5. Fare clic su Successivo.
6. Selezionare l’account Salesforce da cui importare i dati.
7. Se desiderate aggiungere un nuovo account Salesforce, fate clic su Aggiungi un account utente.
   Consiglio: tutti gli account Salesforce precedentemente collegati e quelli impostati dai Brand Administrator saranno disponibili qui.
   Attenzione: Per questa attività si possono avere fino a 5 connessioni esterne al proprio account Salesforce. Se si aggiungono più di 5 connessioni, la connessione più vecchia verrà interrotta.
8. Fare clic su Successivo.
9. Fare clic su Scegli rapporto per selezionare un rapporto da cui importare i dati.
10. Selezionare un campo primario per l’importazione. Tutti i valori di questo campo devono essere univoci, poiché questo campo viene utilizzato per evitare la duplicazione dei dati.
11. Per iniziare ad aggiungere altri campi, fare clic su Aggiungi campo.
12. Utilizzare il menu a discesa Seleziona campo per selezionare un campo da importare. Ripetere questi passaggi per tutti i campi necessari.
    Consiglio Q: per rimuovere un campo dalla mappatura, fare clic sull’icona del cestino.
13. Fai clic su Salva.

Avanti, dovrete salvare i dati in Qualtrics utilizzando un’attività di caricamento. In genere si tratta dell’attività “Aggiungi contatti e transazioni alla Directory XM“.