Connettore di uscita Qualtrics

Informazioni sul connettore di uscita Qualtrics

Il connettore in uscita Qualtrics ti consente di eseguire le seguenti azioni nel tuo account Qualtrics:

• Attiva un evento flusso di lavoro JSON e utilizza XM Scopri i dati nei flussi di lavoro Qualtrics.
• Esporta le risposte con XM Scopri gli arricchimenti da XM Discover e importale in un set di dati dei sondaggi Qualtrics.

Requisiti

Prima di configurare la connessione, avrai bisogno delle seguenti informazioni dal tuo account Qualtrics:

• L’ID del tuo centro dati Qualtrics.
• Il tuo token API Qualtrics.
• Il tuo endpoint API di esportazione XM Discover.

Processi evento JSON

Per attivare un evento JSON con il connettore in uscita Qualtrics, sarà necessario l’endpoint dell’evento JSON. Puoi copiare il punto finale facendo clic su Copia URL durante la modifica dell’evento JSON nel flusso di lavoro Qualtrics.

Processo di esportazione risposte

Se esporti le risposte in un set di dati dei sondaggi Qualtrics, devi assicurarti che i tuoi dati soddisfino i seguenti requisiti:

• Il set di dati del sondaggio deve avere campi che corrispondono agli arricchimenti XM Discover che desideri esportare. Se questi campi non esistono, è possibile aggiungerli come dati integrati o crearli utilizzando campi personalizzati.
• I documenti esportati da XM Discover devono avere un campo che corrisponda all’ID sondaggio del sondaggio in cui si desidera importare le risposte.

Creazione di un job connettore in uscita Qualtrics

1. Nella pagina Processi, fare clic su Nuovo processo.
   
2. Seleziona il connettore Qualtrics in uscita.
   
3. Assegnare un nome al job in modo da poterlo identificare.
   
4. Selezionare il progetto in cui caricare i dati.
5. Fornisci una descrizione del tuo lavoro in modo da conoscerne lo scopo.
6. Fare clic su Successivo.
7. Scegli il tipo di dati Qualtrics che desideri esportare:
   
   • Sondaggio: esporta i dati delle risposte da importare in un set di dati del sondaggio.
   • Evento JSON: esporta dati per attivare un evento workflow JSON.
8. Fare clic su Successivo.
9. Utilizza il menu a discesa per selezionare una connessione Qualtrics esistente o seleziona Aggiungi Nuovo per crearne una nuova.
   
   Qtip: per modificare o rimuovere una connessione esistente, vai alle impostazioni del tuo account.
10. Quando si aggiunge una nuova connessione, fornire quanto segue:
    • Nome connessione: assegnare un nome alla connessione in modo da poterla identificare in un secondo momento.
    • ID Datacenter Qualtrics: inserisci il tuo ID data acenter Qualtrics.
    • Token API Qualtrics: inserisci il token API del tuo account Qualtrics.
11. Se si desidera che la connessione scada dopo un certo periodo di tempo, abilitare l’opzione Invia notifiche di scadenza. Utilizzare il campo Data di scadenza per scegliere la scadenza delle credenziali. Nella casella Giorni prima della scadenza, immettere quanto in anticipo si desidera essere avvisati della scadenza della connessione, fino a 100 giorni.
12. Fare clic su Successivo.
13. Fornisci il tuo endpoint API di esportazione XM Discover.
    
14. Fare clic su Successivo.
15. Scegli il livello di dati che desideri esportare:
    
    • Frasi: utilizzare i dati a livello di frase.
    • Documenti: utilizzare dati a livello di documento.
      Consiglio Q: i passaggi rimanenti nella pagina Configurazione query sono facoltativi e consentiranno di restringere i dati esportati.
16. Fornire una querydi ricerca in base alla quale filtrare i dati in uscita. Utilizzare la stessa sintassi utilizzata per cercare i dati in Designer. Lasciare vuoto questo campo per includere tutti i dati.
    Esempio: è possibile specificare uno o più ID sondaggio per aggiornare solo i record del sondaggio selezionati utilizzando la seguente sintassi:Surveyid:sv_01
17. Inserire il nome del filtro del progetto che si intende applicare ai dati in uscita. Lasciare vuoto questo campo se non si intende filtrare i dati.
18. Scegli i record che desideri importare:
    • Caricare nuovi record: record creati dall’ultima esecuzione del job in uscita.
    • Caricare record nuovi e aggiornati: record creati o aggiornati dall’ultima esecuzione del job in uscita.
    • Carica record aggiornati: record aggiornati dall’ultima esecuzione del job in uscita.
19. Utilizzare il menu a discesa per scegliere i modelli di classificazione da includere nei dati. Selezionare la casella di spunta Tutti i modelli per includere i dati di classificazione per tutti i modelli disponibili nel progetto.
20. Selezionare come si desidera che le classificazioni influiscano sul filtraggio dei dati:
    • Ignora: nessun filtro applicato in base ai modelli selezionati.
    • Attualmente classificato: restituisce i record classificati dai modelli selezionati durante l’esecuzione di classificazione più recente.
    • Sempre classificati: restituisce i record che sono stati classificati dal modello o dai modelli selezionati in qualsiasi momento.
21. Scegli le opzioni di esportazione aggiuntive che desideri utilizzare:
    • Se restituire gli ID categoria (true) invece dei nomi categoria (false): esportare gli ID categoria anziché i nomi categoria
    • Filtra i risultati applicando la query filtro con tutti i percorsi dei nodi foglia: aggiunge più modelli con il parametro “flag_only” alla chiamata API di esportazione.
    • Ignorare i valori vuoti: ignorare l’aggiornamento di un documento di indagine se tutti i relativi valori in uscita sono vuoti.
22. Fare clic su Successivo.
23. La fase successiva dipende dal fatto che si stiano esportando i dati del sondaggio o inviando i dati a un endpoint JSON per attivare un flusso di lavoro:
    • Sondaggio: scegliere il sondaggio in cui si desidera esportare i dati e fare clic su Avanti.
      
      Quindi, seleziona l’attributo XM Discover che contiene il tuo ID sondaggio Qualtrics.
      
      Consiglio Q: verranno aggiornati solo i documenti con ID indagine che corrispondono all’indagine selezionata nella fase precedente.
    • Evento JSON: immettere l’endpoint JSON dall’evento JSON.
      
24. Mappa i campi da XM Discover a Qualtrics. Fai clic sulla casella vuota e scegli l’attributo XM Discover che desideri inviare a Qualtrics.
    
25. Seleziona il tipo di dati che il campo deve esportare come, che corrisponde al tipo di variabile dati incorporati del campo in Qualtrics:
    
    • Non mappare: nessun tipo di variabile specificato.
    • Attributo numerico: tipo di variabile numerica.
    • Attributo testo: tipo di variabile set di testo.
    • Attributo data: tipo di variabile data.
    • Testuale: tipo di variabile di testo.
26. Inserisci il nome del campo incorporato di Qualtrics che deve essere compilato con i valori dell’attributo XM Discover selezionato.
27. Utilizzare i segni più ( + ) e meno ( – ) per aggiungere e rimuovere i campi in base alle esigenze.
28. Fare clic su Successivo.
29. Se lo si desidera, è possibile aggiungere un filtro connettore per filtrare i dati in entrata e limitare i dati importati.
    
30. È inoltre possibile limitare il numero di record importati in un singolo processo immettendo un numero nella casella Specifica limite record. Inserire “Tutti” se si desidera importare tutti i record.
    Consiglio Q: Per i dati conversazionali, il limite viene applicato in base alle conversazioni piuttosto che alle righe.
31. Fare clic su Successivo.
32. Scegli quando desideri ricevere una notifica. Per ulteriori informazioni, consultare Notifiche job.
    
33. Fare clic su Successivo.
34. Scegliere quando viene eseguito il job. È possibile eseguire un pull una tantum o configurare un recupero di dati ricorrente. Per ulteriori informazioni, consultare Pianificazione job.
    
35. Fare clic su Successivo.
36. Rivedere la configurazione. Se è necessario modificare un’impostazione specifica, fare clic sul pulsante Modifica per passare a quella fase nella configurazione del connettore.
    
37. Fare clic su Fine per salvare la mansione.

Una volta salvato il tuo lavoro, i dati specificati verranno esportati in Qualtrics in base alla programmazione impostata. Se si sta avviando un evento JSON, assicurarsi di creare il resto del flusso di lavoro, che include l’aggiunta di condizioni da limitare quando il workflow viene eseguito e task per determinare l’output del flusso di lavoro.