Connettore di uscita file

Informazioni sul connettore di uscita file

È possibile utilizzare il connettore di uscita file per estrarre dati arricchiti da XM Discover a scopo di conformità e backup dei dati o per agire su di esso all’interno di applicazioni esterne.

È 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. Il connettore file in uscita salva i dati su un server SFTP (Secure File Transfer Protocol).

PRIMA DI INIZIARE

Prima di configurare un job utilizzando il connettore di uscita file, assicurarsi di aver:

• Nome utente e password del tuo account SFTP.
• Una chiave PGP/GPG se desideri crittografare i file forniti da XM Discover.

I formati file supportati sono:

• File di testo delimitati (CSV).
• File JavaScript Object Notation (JSON).

ISTITUZIONE DELLA CONNESSIONE

1. Accedere ai connettori.
2. Fare clic sul pulsante Nuovo job nell’angolo in alto a destra dei job.
   
3. Nella pagina Connettori, passare alle ORIGINI IN USCITA.
   
4. Fare clic su File in uscita.

Configurazione di un processo del connettore in uscita dei file

Dopo aver configurato la connessione, attenersi alla seguente procedura per configurare un processo:

• Fase 1: fornisci nome job
• Fase 2: specificare progetto e descrizione
• Fase 3: Fornisci le credenziali per una cartella SFTP Qualtrics
• Passaggio 4: Imposta le credenziali di esportazione XM Discover
• Passaggio 5: configurazione query
• Passaggio 6: fornire la configurazione dei file
• Fase 7: Mappa i campi desiderati in Qualtrics
• Fase 9: specificare il filtro (facoltativo) e il limite del record
• Fase 10: configurazione delle notifiche (facoltativo)
• Passo 11: Configura opzioni aggiuntive per job
• Passo 12: Conferma tutte le impostazioni del processo

Consiglio Q: Fare clic sui pulsanti Indietro e Avanti per spostarsi tra le pagine, oppure utilizzare i tasti freccia: SINISTRA per tornare indietro, DESTRA per andare avanti. Per annullare la configurazione, fare clic sul pulsante Annulla.

Fase 1: fornisci nome job

1. Immettere un nome processo riconoscibile nella casella Nome processo nell’angolo in alto a sinistra della pagina.
   
   Consiglio Q: è possibile modificare il nome del processo durante la configurazione tramite il campo Nome processo visualizzato nella parte superiore di ogni pagina durante la configurazione.
2. Fare clic su Successivo.

Fase 2: specificare progetto e descrizione

1. Nella pagina Specifica progetto e descrizione, selezionare un progetto da cui estrarre i dati dal menu a discesa dei progetti.
   
   Consiglio Q: il progetto deve corrispondere a quello identificato dalla chiave API di esportazione. In caso di mancata corrispondenza, il job utilizzerà il progetto identificato dalla chiave API.
   Consiglio Q: è possibile inserire una nota relativa al processo nella casella Descrizione lavoro. La descrizione processo immessa nella casella Descrizione processo è accessibile solo nell’elenco Connettori e non viene esportata come parte dei dati di un processo.
2. Fare clic su Successivo.

Fase 3: fornisci le credenziali per un account SFTP Qualtrics

1. Nella pagina Fornisci credenziali per una cartella SFTP Qualtrics, puoi selezionare un insieme di credenziali esistente dal menu a discesa oppure aggiungere un nuovo set di credenziali. Consultare la sezione Aggiunta di nuove credenziali SFTP per informazioni sull’aggiunta di un nuovo insieme di credenziali.
   
2. Fare clic su Successivo.

Passaggio 4: Imposta le credenziali di esportazione XM Discover

1. Nella pagina Configura credenziali di esportazione Discover XM, fornire l’URL del servizio XM Discover Export API rilevante per la propria regione (senza il tipo di endpoint) nella casella HOST.
   
   Consiglio Q: per ulteriori informazioni, consultare Esporta endpoint API v2.
2. Fare clic su Successivo.

Passaggio 5: configurazione query

Nella pagina Configurazione query, è possibile specificare il livello per esportare i dati da XM Discover e scegliere i record da recuperare.

1. Selezionare una delle seguenti opzioni dal menu a discesa Selezionare il livello di dati per scegliere il livello di granularità dei dati associato ai dati in uscita:
   
   • Frasi: utilizza l’esportazione a livello di frase per informazioni più granulari e arricchimenti a livello di frase come argomenti, sentiment, punteggi dell’impegno e così via.
   • Documenti: utilizzare l’esportazione a livello di documento quando si desidera esportare valori per attributi strutturati relativi a un intero documento.
     Attenzione: quando si utilizzano gli arricchimenti a livello di frase, impostare il livello di dati su frasi.
   • Per ulteriori informazioni sugli arricchimenti disponibili per ogni livello, consultare Attributi predefiniti.
2. Fornire una query in base alla quale filtrare i dati in uscita nella casella Immettere la query(facoltativo).
   Consiglio Q: utilizzare la stessa sintassi utilizzata per cercare i dati in Designer. Per ulteriori informazioni sulle query di ricerca supportate, consultare Query di ricerca.
   Esempio: è possibile specificare uno o più ID del sondaggio per aggiornare solo i record selezionati utilizzando la seguente sintassi: geometyid:sv_01.
3. Fornire il nome del filtro del progetto da applicare ai dati in uscita nella casella Immettere il nome del filtro(facoltativo).
4. In Scegliere i record da recuperare, selezionare i record da estrarre:
   • Caricare nuovi record (default). Estrarre solo i record creati dall’ultima esecuzione del job in uscita.
   • Caricare record nuovi e aggiornati. Estrarre i record creati o aggiornati dall’ultima esecuzione del job in uscita.
   • Caricare record aggiornati. Estrarre solo i record che sono stati aggiornati dall’ultima esecuzione del job in uscita.
     Consiglio Q: i processi del connettore File in uscita impostati su Carica record nuovi e aggiornati o Carica record aggiornati possono essere pianificati per essere eseguiti solo con frequenza settimanale o mensile.
     Attenzione: la categorizzazione in esecuzione o ripetuta aggiorna un record nel sistema XM Discover.
5. È possibile definire quali dati di classificazione includere nei dati in uscita (facoltativo). Selezionare la casella di spunta Tutti i modelli per includere i dati di classificazione per tutti i modelli disponibili nel progetto. Non selezionare la casella di controllo Tutti i modelli se si desidera includere solo i modelli selezionati. Se l’opzione Tutti i modelli non è selezionata, è possibile selezionare modelli specifici da includere nei dati in uscita dal menu di riepilogo a discesa.
   
6. Selezionare una delle seguenti opzioni dai risultati dei filtri applicando le regole del modello:
   • Ignora: nessun filtro applicato in base ai modelli selezionati.
   • Attualmente classificato: restituisce le frasi/i documenti che sono stati classificati in base ai modelli selezionati durante l’ultima esecuzione di classificazione.
   • Ever Classified: restituisce le frasi/i documenti che sono stati classificati dai modelli selezionati in qualsiasi momento.
7. Selezionare la casella di controllo Se restituire gli ID categoria (true) anziché i nomi delle categorie (false) per utilizzare gli ID categoria anziché i nomi delle categorie (facoltativo).
8. Selezionare i risultati Filtri applicando la query di filtro con tutti i percorsi dei nodi foglia per aggiungere più modelli con il parametro “indicatore solo foglia” alla chiamata API di esportazione (facoltativo).
9. Fare clic su Successivo.

Passaggio 6: fornire la configurazione dei file

Nella pagina Fornisci configurazione file, scegliere il tipo di file da utilizzare per l’esportazione dei dati, quindi, a seconda del tipo di file selezionato, puntare al percorso in cui salvare i file e specificare altre impostazioni.

1. Nella sezione Configurazione file, selezionare il tipo di file dalle seguenti due opzioni:
   
   • File di testo delimitati (CSV): selezionare questa opzione per esportare i dati utilizzando file di testo delimitati (CSV).
   • File JavaScript Object Notation (JSON): selezionarlo per esportare i dati utilizzando i file JavaScript Object Notation (JSON).
2. Se si seleziona File di testo delimitati (CSV), applicare le opzioni di impostazione per questo tipo di file.
   • Codifica file: selezionare il sistema di codifica da utilizzare nel file.
   • Carattere delimitatore: specificare il carattere per delimitare le voci di dati nel file. Un solo carattere. Se si utilizza un file CSV, il delimitatore è una virgola.
   • Carattere di imballaggio: specificare il carattere da racchiudere in ogni campo di dati nel file. Un solo carattere.
   • Nessun imballaggio: selezionare questa casella di spunta se i caratteri di imballaggio sono facoltativi.
3. Fare clic su Sfoglia nella sezione Percorso file per puntare alla cartella in cui devono essere archiviati i file sul server SFTP.
4. Nella finestra Scegli percorso file, selezionare la cartella in cui archiviare i file.
   
   Consiglio Q: fare clic sul nome della cartella per selezionarla, quindi sull’icona della cartella per aprirla.
5. Una volta selezionata la cartella in cui sono archiviati i file, fare clic su Ok.
6. Nella sezione Regole di attribuzione nomi, è possibile selezionare le seguenti opzioni:
   
   • Fornire un nome file per il prefisso: selezionare questa opzione per fornire un prefisso da aggiungere al nome file generato. Utilizzare questa opzione per applicare regole di attribuzione nomi personalizzate per comprendere meglio quali file corrispondono a un determinato job o esecuzione job.
     Suggerimento Q: il valore non può contenere [ ] \ / e deve contenere al massimo 100 caratteri.
   • Fornire un nome file per il suffisso: selezionare questa opzione per fornire un suffisso da aggiungere al nome file generato. Utilizzare questa opzione per applicare regole di attribuzione nomi personalizzate per comprendere meglio quali file corrispondono a un determinato job o esecuzione job.
     Suggerimento Q: il valore non può contenere [ ] \ / e deve contenere al massimo 100 caratteri.
7. È possibile crittografare i file forniti da XM Discover e fornire una chiave PGP/GPG per la crittografia nella casella chiave PGP/GPG(facoltativo). Selezionare la casella di controllo Codifica file forniti da XM Discover per garantire che i dati vengano trasferiti in modo sicuro da XM Discover e fornire una chiave PGP/GPG per la crittografia. In alternativa, deselezionare la casella di spunta Codifica file forniti da XM Discover se non è necessaria alcuna crittografia.
8. Fare clic su Successivo.

Passaggio 7: mappa i campi desiderati nei file

Nella pagina Mappa i campi desiderati nei file, puoi selezionare quali attributi XM Discover e risultati di classificazione includere nell’esportazione.

1. Fai clic all’interno della casella del campo personalizzato vuoto e seleziona il campo XM Discover che desideri includere nell’esportazione.
2. Selezionare il formato in cui esportare i dati dal menu a discesa Tipo di dati.
3. Immettere il nome del campo da utilizzare nel file esportato nella casella Nome attributo.
4. Fare clic sull’icona più ( + ) per aggiungere altri campi personalizzati e mapparli ai campi nel file esportato, se necessario.
5. Fare clic su Successivo.

Fase 8: specificare il filtro (facoltativo) e il limite del record

1. Nella pagina Specifica filtro, è possibile definire una condizione di filtro per un processo per esportare solo i record che lo soddisfano (facoltativo).
   
   Consiglio Q: Per ulteriori informazioni sull’applicazione di un filtro, vedere Filtro connettore.
2. È possibile specificare un limite di record nella casella Specifica limite record. In alternativa, è possibile lasciare il limite di record come valore predefinito Tutti se si desidera che tutti i record vengano esportati in un unico push.
   Qtip: Il limite di registrazione è un limite per ogni esecuzione del job. Se lo si imposta su 1.000, il processo verrà eseguito in base alla pianificazione impostata e si interromperà dopo l’esportazione di 1.000 record. Se lo si imposta su Ogni giorno, ciò significa che verrà eseguito una volta al giorno e si otterranno fino a 1.000 record esportati per ogni giorno.
   Consiglio Q: Per i dati conversazionali, il limite viene applicato in base alle conversazioni piuttosto che alle righe.
3. Fare clic su Successivo.

Fase 9: Configurazione notifiche (facoltativo)

1. Nella pagina Configurazione notifiche, è possibile selezionare le notifiche che gli osservatori di un processo devono ricevere se si verifica uno degli eventi elencati di seguito.
   • Vengono esportati zero record.
   • Sono stati trovati valori mancanti consecutivi.
   • L’esecuzione di un processo non riesce.
   • L’esecuzione di un processo ha avuto esito parzialmente positivo.
   • Un job termina con un timeout.
   • Un job non riesce.
     Consiglio Q: è possibile selezionare qualsiasi combinazione di notifiche o decidere di non scegliere alcuna notifica. In questo caso, i controlli di un processo non ricevono notifiche. Per ulteriori informazioni sulle impostazioni di configurazione delle notifiche, consultare Notifiche job.
     Consiglio Q: il timeout predefinito per i processi del connettore in uscita file è di 48 ore.
2. Fare clic su Successivo.

Passo 10: Configura opzioni aggiuntive per job

1. Nella pagina Configura opzioni aggiuntive per il processo, nella sezione Pianifica processo storico/incrementale, selezionare una delle seguenti opzioni:
   • Pianifica esecuzioni incrementali per configurare una pianificazione per le esportazioni dati incrementali.
     Consiglio Q: i processi del connettore File in uscita impostati su Carica record nuovi e aggiornati o Carica record aggiornati possono essere pianificati per essere eseguiti solo con frequenza settimanale o mensile.
     Consiglio Q: utilizzare l’opzione Crea processo ma non estrarre i dati se si desidera convalidare il processo e le relative impostazioni prima dell’esportazione dei dati. Per ulteriori informazioni sulla pianificazione di esecuzioni incrementali, consultare Pianificazione job.
   • Configura pull una tantum per eseguire un’esportazione dati una tantum.
     Consiglio Q: è possibile modificare le impostazioni di pianificazione in un secondo momento; consultare Recupero dei dati per le esecuzioni una tantum e Pianificazione job per le esecuzioni regolari.
2. Nella sezione Dati incrementali supplementari, è possibile specificare la quantità di dati supplementari (in giorni o ore) da rilevare durante un’esecuzione incrementale per garantire che tutti i dati storici rilevanti siano disponibili per il trasferimento in uscita (facoltativo).
   Consiglio Q: il valore massimo per questo campo è 30 giorni.
3. Fare clic su Successivo.

Passo 11: Conferma tutte le impostazioni del processo

1. Nella pagina Conferma tutte le impostazioni processo, è possibile visualizzare un riepilogo di tutte le impostazioni di un processo e modificarle, se necessario, prima di eseguire l’esportazione dei dati. Per eseguire l’esportazione dei dati, fare clic sul pulsante Concludere quando si è pronti per eseguire l’esportazione dei dati. Verrà visualizzato un messaggio di conferma che conferma che il processo è stato inviato correttamente.
2. Quando si fa clic su Fine, si verifica quanto segue: Le esportazioni una tantum vengono eseguite immediatamente. A meno che non sia stata abilitata l’opzione “Crea processo ma non estrarre dati”, le esportazioni pianificate vengono eseguite immediatamente, quindi impostate per l’esecuzione in base alla pianificazione definita.

Per ulteriori informazioni sul monitoraggio dei job, consultare Riepilogo pagina dei job.

Aggiunta di nuove credenziali SFTP

1. Selezionare Aggiungi Nuovo.
2. Immettere il nome del nuovo insieme di credenziali nella casella NOME CONNESSIONE.
   
3. Inserire il nome utente SFTP nella casella NOME UTENTE SFTP.
4. Immettere la password SFTP nella casella PASSWORD SFTP.
5. Immettere l’indirizzo del server SFTP nella casella HOST SFTP.
6. Immettere la porta SFTP nella casella PORTA SFTP.
   Qtip: La porta predefinita è 22.
7. È possibile impostare la scadenza delle credenziali dopo un determinato periodo di tempo (facoltativo). Per definire una data di scadenza per questo insieme di credenziali e impostare un promemoria per tutti gli osservatori dei processi, selezionare la casella di controllo Invia notifiche di scadenza. In questo modo viene attivata la casella Giorni prima della scadenza.
8. Immettere un valore nella casella Giorni prima della scadenza per impostare quanti giorni prima della scadenza devono iniziare le notifiche. I valori possibili sono compresi tra 1 e 100 giorni.
   Consiglio Q: questo promemoria viene attivato ogni volta che il processo viene eseguito una volta che la data di scadenza è inferiore al numero di giorni impostato nella casella Giorni prima della scadenza.
9. Selezionare la Data di scadenza dal selettore della data di calendario. La data di scadenza verrà quindi aggiunta alla casella Data di scadenza.