Connettore di uscita file

Informazioni sul connettore di uscita file

È possibile utilizzare il connettore in uscita dei file per esportare dati arricchiti da XM Discover al server SFTP della propria organizzazione.

È possibile esportare i dati a livello di frase e documento, limitarli a record nuovi e aggiornati e scegliere i campi, gli arricchimenti e le classificazioni da esportare. I dati esportati sono disponibili in formato CSV e JSON.

Configurazione di un job in uscita di file

1. Nella pagina Processi, fare clic su Nuovo processo.
   
2. Selezionare File 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. Scegliere un account SFTP da utilizzare o selezionare Aggiungi Nuovo per aggiungerne uno nuovo.
   
8. Se si aggiunge un nuovo account, immettere le seguenti informazioni per l’account SFTP:
   • Nome connessione: assegnare un nome alla connessione in modo da poterla riconoscere in un secondo momento.
   • Nome utente SFTP: immettere il nome utente per connettersi al server SFTP.
   • Password SFTP: immettere la password per connettersi al server SFTP.
   • Host SFTP: immettere l’URL dell’host del server SFTP.
   • Porta SFTP: immettere la porta SFTP. Di solito si tratta di 22.
   • Invia notifiche di scadenza: se desideri che le tue credenziali SFTP scadano dopo un certo periodo di tempo, seleziona questa opzione.
   • Giorni prima della scadenza: se si abilitano le notifiche di scadenza, immettere quanti giorni si desidera ricevere una notifica prima della scadenza. È possibile inserire un valore compreso tra 1 e 100 giorni.
   • Data di scadenza: impostare la data di scadenza delle credenziali. Fare clic sulla casella per aprire un calendario per scegliere la data.
9. Fare clic su Successivo.
10. Fornisci il tuo endpoint API di esportazione XM Discover.
    
11. Fare clic su Successivo.
12. 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.
13. Fornire una query di 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 del sondaggio per aggiornare solo i record selezionati utilizzando la seguente sintassi:geometyid:sv_01
14. 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.
15. 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.
16. 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.
17. Scegliere come si desidera che le classificazioni influiscano sul filtro 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.
18. 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.
19. Fare clic su Successivo.
20. Scegli il tipo di file che desideri esportare:
    
    • Separato da delimitatore “piatto”: il formato è un file di testo delimitato, come CSV o TSV.
    • File JSON: il formato è un file JSON.
21. Se si esporta in un file piatto separato da delimitatori, selezionare le impostazioni del file:
    • Codifica del file: scegliere la codifica del file, ad esempio UTF-8 o ASCII
    • Carattere delimitatore: carattere utilizzato per separare gli inserimenti, ad esempio una virgola o una tabulazione.
    • Carattere di imballaggio: il carattere utilizzato per racchiudere i dati. Lasciare vuoto questo campo se non si desidera un imballaggio.
    • Nessun imballaggio: se non si desidera che i dati siano racchiusi in un carattere aggiuntivo, attivare questa opzione.
22. Fare clic su Sfoglia e selezionare la cartella SFTP.
    
    Qtip: Quando si sceglie il percorso di una cartella, è possibile fare clic sull’icona di una cartella per espanderla. Fare clic sul nome della cartella per selezionarla, quindi fare clic su OK al termine.
23. Se si desidera che i file esportati abbiano un prefisso allegato, abilitare Fornisci un nome file per il prefisso e immettere il prefisso desiderato nella casella.
    Consiglio Q: il prefisso non può contenere [ ] \ / e non può superare i 100 caratteri.
24. Se desideri che i file esportati abbiano un postfix allegato ad essi, abilita Fornisci un nome file per il postfix e inserisci il suffisso desiderato nella casella.
    Consiglio Q: il suffisso non può contenere [ ] \ / e non può superare i 100 caratteri.
25. Se desideri crittografare i tuoi dati, abilita Crittografa i file forniti da XM Discover e inserisci la tua chiavePGP/GPG nella casella.
    Qtip: I file saranno sempre crittografati in un file GPG. È possibile immettere una chiave PGP/GPG, ma non verrà mai crittografata in un file PGP.
26. Fare clic su Successivo.
27. Mappa i campi da XM Discover a Qualtrics. Fai clic sulla casella vuota e scegli l’attributo XM Discover che desideri inviare a Qualtrics.
    
28. Selezionare il tipo di dati in cui il campo deve essere esportato:
    • 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.
29. Inserire il Nome attributo per questo campo. Questo sarà il nome del campo quando viene esportato.
30. Utilizzare i segni più ( + ) e meno ( – ) per aggiungere e rimuovere i campi in base alle esigenze.
31. Fare clic su Successivo.
32. Se lo si desidera, è possibile aggiungere un filtro connettore per filtrare i dati in entrata e limitare i dati importati.
    
33. È 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.
34. Fare clic su Successivo.
35. Scegli quando desideri ricevere una notifica. Per ulteriori informazioni, consultare Notifiche job.
    
36. Fare clic su Successivo.
37. 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.
    
38. Fare clic su Successivo.
39. Rivedere la configurazione. Se è necessario modificare un’impostazione specifica, fare clic sul pulsante Modifica per passare a quella fase nella configurazione del connettore.
    
40. Fare clic su Fine per salvare la mansione.