Modello di articolo

Informazioni sul connettore in entrata dei file

È possibile utilizzare il connettore in entrata dei file per caricare i dati dei clienti tramite un upload di file. Questi lavori possono essere programmati per essere ripetuti in base a una pianificazione impostata dall’utente o essere configurati per essere un’estrazione di dati una tantum.

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

• File di testo delimitati piatti (CSV, TSV, ecc.)
• XLS o XLSX
• JSON
• WebVTT

Impostazione di un lavoro in entrata sui file

1. Nella pagina Lavori, fare clic su Nuovo lavoro.
   
2. Selezionare i file.
   
3. Date un nome al vostro lavoro per poterlo identificare.
   
4. Scegliere il progetto in cui caricare i dati.
5. Date al vostro lavoro una descrizione, 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, inserire le seguenti informazioni per l’account SFTP:
   • Nome della connessione: Assegnare un nome alla connessione per poterla riconoscere in seguito.
   • Nome utente SFTP: inserire il nome utente per connettersi al server SFTP.
   • Password SFTP: inserire la password per connettersi al server SFTP.
   • Host SFTP: Inserire l’URL del server SFTP.
   • Porta SFTP: inserire la porta SFTP. Di solito sono 22.
   • Invia notifiche di scadenza: Se si desidera che le credenziali SFTP scadano dopo un certo periodo di tempo, selezionare questa opzione.
   • Giorni prima della scadenza: Se si attivano le notifiche di scadenza, inserire quanti giorni si desidera ricevere la 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 e scegliere la data.
9. Fare clic su Successivo.
10. Scegliere il tipo di file da caricare:
    
    • File “piatti” separati da un delimitatore
    • File Excel (XLS, XLSX)
    • File JSON
    • File WebVTT
11. A seconda del tipo di file selezionato, è possibile scegliere altre impostazioni:
    • File piatti separati da delimitatori: Per i file separati da delimitatori, scegliere quanto segue:
      
      • Codifica del file: Scegliere il sistema di codifica del file (UTF-8, ASCII, ecc.)
      • Carattere delimitatore: Inserire il carattere utilizzato per delimitare le voci dei dati. Per impostazione predefinita, si tratta di una virgola per i file CSV.
      • Carattere di chiusura: Inserire il carattere che racchiude l’inserimento dei dati. Lasciare questo campo vuoto se è stato selezionato Nessun involucro.
      • Nessun allegato: Attivare questa opzione se il file non contiene caratteri di allegato.
    • JSON: inserire il percorso JSON che contiene i dati del documento che si desidera caricare su XM Discover. Lasciare questo campo vuoto se i documenti sono a livello di radice.
      
    • Passare all’avanti per Excel e WebVTT.
12. Fare clic su Sfoglia e scegliere il percorso della cartella sul server SFTP che contiene il file da caricare.
    Consiglio Q: 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 l’espressione regolare del nome del file che corrisponde ai file che si desidera caricare.
14. Se i file sono compressi, abilitare Unzip file(s) e inserire l’espressione regolare Zipped Filename che corrisponde ai file che devono essere decompressi.
    
15. Se i file sono decifrati, attivare Decifra file e immettere quanto segue:
    • Espressione regolare del nome del file crittografato: Inserire l’espressione regolare del nome del file per i file che devono essere decifrati.
    • Chiave PGP/GPG: Inserire la chiave PGP/GPG utilizzata per la crittografia.
    • Passphrase: Inserire la passphrase per la decifrazione.
16. Se i file sono sia compressi che crittografati, è necessario scegliere quale debba essere il primo:
    • Decomprimere e decrittografare: I file vengono decompressi e poi decifrati.
    • Decriptare e decomprimere: I file vengono decifrati e poi 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 chiamate con più linee di dialogo tra 2 o più partecipanti.
    • Feedback: Documenti presentati come file singole o oggetti “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 le trascrizioni delle chiamate.
18. È necessario fornire un file campione, che può essere salvato sul computer o sul server SFTP:
    • Selezionare Scarica Campione da File Storage se il file del campione è salvato sul server SFTP.
    • Selezionare Carica campione dal mio computer se il campione è salvato sul computer.
19. Se necessario, è possibile selezionare un file modello da scaricare. Fare clic sul link qui per scaricare il modello selezionato. Utilizzare questo file per aggiungere i dati che si desidera importare in XM Discover. Per informazioni specifiche sulla formattazione di ciascun file e tipo di dati, consultare la pagina di supporto XM Discover Data Formats.
20. Fare clic sul pulsante Seleziona file campione e scegliere il file campione sul computer o sul server SFTP.
21. Viene visualizzata un’anteprima del file. Se al posto dell’anteprima viene visualizzato un messaggio di errore o il contenuto del file grezzo, è possibile che ci sia un problema con le opzioni di formato dei dati selezionate. Per informazioni sulla risoluzione dei problemi del file, consultare la pagina Errori del file di Campione.
22. Fare clic su Successivo.
23. Se necessario, modificare le mappature dei dati. Per informazioni dettagliate sulla mappatura dei campi in XM Discover, consultare la pagina di supporto Data Mapping. La sezione Mappatura dei dati predefiniti contiene informazioni sui campi specifici di questo connettore, mentre la sezione Mappatura dei campi di conversazione spiega come mappare i dati per i dati di conversazione.
    
24. Fare clic su Successivo.
25. Se lo si desidera, è possibile aggiungere regole di sostituzione e di eliminazione dei dati per nascondere i dati sensibili o sostituire automaticamente determinate parole e frasi nei feedback e nelle interazioni dei clienti. Per ulteriori informazioni, consultare la pagina di supporto Data Substitution and Redaction.
    
26. Fare clic su Successivo.
27. Se si desidera, è possibile aggiungere un filtro al connettore per filtrare i dati in entrata e limitare i dati importati.
    
28. È anche possibile limitare il numero di record importati in un singolo lavoro inserendo un numero nella casella Specifica limite record. Inserire “Tutti” se si desidera importare tutti i record.
    Consiglio Q: Per i dati delle conversazioni, il limite si applica in base alle conversazioni anziché alle righe.
29. Fare clic su Successivo.
30. Scegliete quando volete essere avvisati. Per ulteriori informazioni, vedere Notifiche di lavoro.
    
31. Fare clic su Successivo.
32. Scegliere come gestire i documenti duplicati. Per ulteriori informazioni, vedere Gestione dei duplicati.
    
33. Scegliere Pianifica esecuzioni incrementali se si desidera che il lavoro venga eseguito periodicamente in base a una pianificazione, oppure Imposta un’estrazione una tantum se si desidera che il lavoro venga eseguito una sola volta. Per ulteriori informazioni, vedere Pianificazione dei lavori.
34. Scegliere un periodo di conservazione per i file elaborati. I file vengono eliminati dopo il periodo impostato.
    
35. Fare clic su Successivo.
36. Valutate la vostra configurazione. Se è necessario modificare un’impostazione specifica, fare clic sul pulsante Modifica per accedere alla fase di impostazione del connettore.
    
37. Fare clic su Fine per salvare il lavoro.

Mappatura dei dati predefinita

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

• tipo_di_feedback: Identifica i dati in base al loro tipo. Questo è utile per i rapporti quando il progetto contiene diversi tipi di dati (ad esempio, sondaggi e feedback sui social media). Per impostazione predefinita, il valore di questo attributo è impostato su “call” per le trascrizioni delle chiamate, “chat” per le interazioni digitali o “feedback” per i feedback individuali. Utilizzare le trasformazioni personalizzate per impostare un valore personalizzato, definire un’espressione o mapparlo su un altro campo.
• valore_fonte: Identifica i dati ottenuti da un’origine specifica. Può essere qualsiasi cosa che descriva l’origine dei dati, come il nome di un sondaggio 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 mapparlo su un altro campo.
• data_documento: il campo data primario associato a un documento. Questa data viene utilizzata nei rapporti di XM Discover, nelle tendenze, negli avvisi e così via. Per la data del documento è possibile utilizzare qualsiasi campo data del dataset. È anche possibile impostare una data specifica per il documento.
• natural_id: Identificatore univoco di un documento. Si raccomanda vivamente di avere un ID unico per ogni documento per elaborare correttamente i duplicati. Per ID naturale, è possibile selezionare qualsiasi campo di testo o numerico dai dati. In alternativa, è possibile generare automaticamente gli ID aggiungendo un campo personalizzato.
• feedback_provider: Identifica i dati ottenuti da un fornitore specifico. Per il caricamento 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 lavoro utilizzato per caricarli. È possibile modificare il valore di questo attributo durante l’impostazione tramite il campo NOME CAMPO, visualizzato nella parte superiore di ogni pagina durante l’impostazione.
• loadDate: indica quando un documento è stato caricato in XM Discover. Questo campo viene impostato automaticamente e non può essere modificato.

Aggiornamento della configurazione del Campione

I connettori in entrata dei file richiedono un file campione per generare le mappature dei dati. Se si desidera modificare le mappature dei dati dopo aver creato un lavoro, procedere come segue:

1. Disimparare i campi che non sono presenti nel nuovo file campione.
2. Aggiornare la configurazione del campione caricando un nuovo file campione con una nuova serie di campi. Di seguito sono riportati i passaggi per aggiornare la configurazione del campione.
3. Aggiornare le mappature dei dati in base al nuovo file Campione.

Aggiornamento della configurazione del campione

1. Nel menu delle opzioni del lavoro, selezionare Aggiorna configurazione campione per un lavoro di file esistente.
   
2. Fare clic su Seleziona file per il caricamento e scegliere il file campione salvato sul computer.
   
   Consiglio Q: se il file contiene campi che non sono presenti nella mappatura dei dati, si riceverà un errore. Per risolvere questo problema, modificare la mappatura dei dati in modo che abbia gli stessi campi del file campione.
3. Controllare due volte le impostazioni dei file. Per ulteriori informazioni sulle impostazioni dei file campione, consultare la pagina Connettore in entrata file.
4. Fare clic su Ok.

Aggiornamento del percorso e della maschera dei file

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

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

XM DISCOVER Cifrari per lo scambio di chiavi supportati

La connessione a un server SFTP richiede una serie di handshake SSH per coordinare la crittografia utilizzata tra il server e l’automazione. Per stabilire una connessione, il server SFTP dovrà disporre di almeno un cifrario per ogni tipo di cifratura che corrisponda a un cifrario supportato dalle automazioni. Di seguito è riportata la lista dei cifrari supportati dalle automazioni, raggruppati per tipo di cifratura.

Ecco una lista di cifrari per lo scambio di chiavi supportati dai server SFTP di XM Discover:

• diffie-hellman-group14-sha256
• diffie-hellman-gruppo18-sha512
• ecdh-sha2-nistp256
• ecdh-sha2-nistp384
• ecdh-sha2-nistp521
• curva25519-sha256
• curve25519-sha256@libssh.org
• diffie-hellman-gruppo16-sha512
• ecdh-nistp256-kyber-512r3-sha256-d00@openquantumsafe.org
• ecdh-nistp384-kyber-768r3-sha384-d00@openquantumsafe.org
• ecdh-nistp521-kyber-1024r3-sha512-d00@openquantumsafe.org
• x25519-kyber-512r3-sha256-d00@amazon.com