Connettore di entrata file

Informazioni su Files Inbound Connector

È possibile utilizzare il connettore in entrata dei file per caricare i dati cliente tramite un upload di file. Questi job possono essere pianificati in modo da essere ripetuti in base a una pianificazione impostata o configurati come recupero dati una tantum.

I processi in entrata file consentono di caricare i dati nei seguenti formati:

• File di testo separati da virgola (CSV, TSV, ecc.)
• XLS o XLSX
• JSON
• WebVTT

Configurazione di un job in entrata di file

1. Nella pagina Processi, fare clic su Nuovo processo.
   
2. Selezionare File.
   
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. Scegliere il tipo di file da caricare:
    
    • File “piatti” separati da delimitatori
    • File Excel (XLS, XLSX)
    • File JSON
    • File WebVTT
11. A seconda del tipo di file selezionato, sono disponibili ulteriori impostazioni da selezionare:
    • File piatti separati da delimitatore: Per i file separati da delimitatore, scegliere quanto segue:
      
      • Codifica file: scegli il sistema di codifica del file (UTF-8, ASCII, ecc.)
      • Carattere delimitatore: immettere il carattere utilizzato per delimitare gli inserimenti di dati. Per impostazione predefinita, si tratta di una virgola per i file CSV.
      • Carattere di imballaggio: immettere il carattere che racchiude la registrazione dati. Lasciare vuoto questo campo se non è selezionato Nessun imballaggio.
      • Nessun imballaggio: attivare questa opzione se il file non contiene caratteri di imballaggio.
    • JSON: immettere il percorso JSON che contiene i dati del documento da caricare in XM Discover. Lasciare vuoto questo campo se i documenti si trovano a livello radice.
      
    • Passa alla fase successiva per Excel e WebVTT.
12. Fai clic su Sfoglia e scegli il percorso della cartella sul tuo server SFTP che contiene il file che desideri caricare.
    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.
13. Inserire il nome file dell’espressione regolare che corrisponde ai file da caricare.
14. Se i file sono compressi, attivare Decomprimi file e inserire l’espressione regolare Nome file compresso che corrisponde ai file da decomprimere.
    
15. Se i file vengono decrittografati, abilitare Decrypt file(s) e immettere quanto segue:
    • Espressione regolare nome file crittografato: inserire il nome file espressione regolare per i file che devono essere decrittografati.
    • Chiave PGP/GPG: immettere la chiave PGP/GPG utilizzata per la crittografia.
    • Frase chiave: immettere la frase chiave per la decrittografia.
16. Se i file sono sia compressi che crittografati, è necessario scegliere quale deve accadere per primo:
    • Decomprimere quindi Decrypt: i file vengono decompressi e quindi decrittografati.
    • Decodifica quindi Decomprimi: i file vengono decrittografati e quindi decompressi.
17. Scegliere il tipo di dati da importare:
    
    • Chat: interazioni digitali con più linee di dialogo tra 2 o più partecipanti.
    • Chiamata: trascrizioni di chiamata con più righe di dialogo tra 2 o più partecipanti.
    • Feedback: documenti presentati come oggetti a una riga o “piatti”.
      Consiglio Q: A seconda del tipo di file, alcuni tipi di dati non sono compatibili. Ad esempio, i file WebVTT possono essere utilizzati solo per caricare trascrizioni di chiamate.
18. È necessario fornire un file di esempio, che può essere salvato sul computer o sul server SFTP:
    • Selezionare Scarica campione da archivio file se il file di esempio viene salvato sul server SFTP.
    • Selezionare Carica campione dal mio computer se il campione viene salvato sul computer.
19. Se necessario, è possibile selezionare un file modello da scaricare. Fare clic sul collegamento qui per scaricare il modello selezionato. Utilizzare questo file per aggiungere i dati da importare in XM Discover. Consulta la pagina di supporto XM Discover Data Formats per informazioni di formattazione specifiche su ogni file e tipo di dati.
20. Fai clic sul pulsante Seleziona file campione e scegli il file di esempio sul tuo computer o sul tuo server SFTP.
21. Verrà visualizzata un’anteprima del file. Se al posto dell’anteprima viene visualizzato un messaggio di errore o contenuti di file grezzi, potrebbe verificarsi un problema con le opzioni di formato dei dati selezionate. Consultare la pagina Errori file di esempio per assistenza nella risoluzione dei problemi del file.
22. Fare clic su Successivo.
23. Se necessario, adattare le mappature dei dati. Consulta la pagina di supporto Mappaggio dati per informazioni dettagliate sui campi di mappatura in XM Discover. La sezione Mappaggio dati predefinito contiene informazioni sui campi specifici di questo connettore e la sezione Mappaggio campi conversazionali illustra come mappare i dati per i dati conversazionali.
    
24. Fare clic su Successivo.
25. Se lo si desidera, è possibile aggiungere regole di sostituzione e oscuramento dei dati per nascondere i dati sensibili o sostituire automaticamente determinate parole e frasi nel feedback e nelle interazioni dei clienti. Per ulteriori informazioni, consulta la pagina di supporto Sostituzione e riduzione dei dati.
    
26. Fare clic su Successivo.
27. Se lo si desidera, è possibile aggiungere un filtro connettore per filtrare i dati in entrata e limitare i dati importati.
    
28. È 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.
29. Fare clic su Successivo.
30. Scegli quando desideri ricevere una notifica. Per ulteriori informazioni, consultare Notifiche job.
    
31. Fare clic su Successivo.
32. Scegliere la modalità di gestione dei documenti duplicati. Consultare Gestione duplicati per ulteriori informazioni.
    
33. Selezionare Pianifica esecuzioni incrementali se si desidera che il job venga eseguito periodicamente in base a una pianificazione oppure Configura pull una tantum se si desidera che il job venga eseguito una sola volta. Per ulteriori informazioni, consultare Pianificazione job.
34. Selezionare un periodo di conservazione per i file elaborati. I file vengono eliminati dopo il periodo impostato.
    
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.

Mappaggio dati predefinito

Questa sezione contiene informazioni sui campi predefiniti per i processi in entrata dei file.

• feedback_type: identifica i dati in base al tipo. Ciò è utile per il reporting quando il progetto contiene diversi tipi di dati (ad esempio, questionari e feedback sui social media). Per impostazione predefinita, il valore di questo attributo è impostato su “call” per trascrizioni di chiamate, “chat” per interazioni digitali o “feedback” per feedback individuali. Utilizzare le trasformazioni personalizzate per impostare un valore personalizzato, definire un’espressione o mapparla a un altro campo.
• source_value: identifica i dati ottenuti da un’origine specifica. Può trattarsi di qualsiasi elemento che descriva l’origine dei dati, ad esempio il nome di un’indagine o di una campagna di marketing mobile. Per impostazione predefinita, il valore di questo attributo è impostato su “File”. Utilizzare le trasformazioni personalizzate per impostare un valore personalizzato, definire un’espressione o mapparla a un altro campo.
• document_date: il campo data principale associato a un documento. Questa data viene utilizzata in XM Discover per report, tendenze, avvisi e così via. È possibile utilizzare qualsiasi campo data nel set di dati per la data del documento. È anche possibile impostare una data documento specifica.
• natural_id: identificatore univoco di un documento. Si consiglia vivamente di disporre di un ID univoco per ogni documento per elaborare correttamente i duplicati. Per l’ ID naturale, è possibile selezionare qualsiasi campo di testo o numerico dai propri dati. In alternativa, è possibile generare automaticamente gli ID aggiungendo un campo personalizzato.
• feedback_provider: identifica i dati ottenuti da un provider specifico. Per i caricamenti di file, il valore di questo attributo è impostato su “File” e non può essere modificato.
• job_name: identifica i dati in base al nome del job utilizzato per caricarlo. È possibile modificare il valore di questo attributo durante la configurazione tramite il campo Nome job visualizzato nella parte superiore di ogni pagina durante la configurazione.
• loadDate: indica quando un documento è stato caricato in XM Discover. Questo campo viene impostato automaticamente e non può essere modificato.

Aggiornamento della configurazione di esempio

I connettori in entrata dei file richiedono un file di esempio per generare mappaggi di dati. Se si intende modificare le mappature dei dati dopo la creazione di un processo, eseguire le seguenti operazioni:

1. Annullare il mapping dei campi non presenti nel nuovo file di esempio.
2. Aggiorna la configurazione di esempio caricando un nuovo file campione con un nuovo insieme di campi. I passaggi per aggiornare la configurazione di esempio sono riportati di seguito.
3. Aggiornare le mappature dei dati in base al nuovo file campione.

Aggiornamento della configurazione di esempio

1. Nel menu delle opzioni del processo, selezionare Aggiorna configurazione di esempio per un processo di file esistente.
   
2. Selezionare Fare clic su Per selezionare il file da caricare e scegliere il file di esempio salvato sul computer.
   
   Consiglio Q: se il file contiene campi non presenti nella mappatura dei dati, verrà visualizzato un errore. Per risolvere questo problema, modifica la mappatura dei dati in modo che abbia gli stessi campi del tuo file di esempio.
3. Ricontrollare le impostazioni del file. Consultare la pagina File Connettore in entrata per ulteriori informazioni sulle impostazioni dei file di esempio.
4. Fare clic su OK.

Aggiornamento percorso e maschera file

I connettori di file in entrata richiedono un percorso e una maschera di file (espressione regolare nome file) per trovare i file corretti da importare. È possibile aggiornare il percorso e la maschera di file per qualsiasi processo di file esistente.

1. Nel menu delle opzioni del processo, selezionare Aggiorna percorso e maschera file per un processo di file esistente.
   
2. Fare clic su Sfoglia.
   
3. Selezionare la cartella in cui sono archiviati i file.
   
   Attenzione: vengono elaborati solo i file nella cartella selezionata; le sottocartelle devono essere elaborate separatamente.
4. Fare clic su OK.
5. Nel campo Nome file espressione regolare, inserire la maschera del file (nome file espressione regolare) che corrisponde ai file che si desidera importare.
   
6. Fai clic su Salva.