File Connettore in entrata
Cosa puoi trovare in questa pagina
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 di importazione file consentono di caricare dati nei seguenti formati:
- File di testo delimitati piatti (CSV, TSV, ecc.)
- XLS o XLSX
- JSON
- WebVTT
Attenzione: Per utilizzare questa funzione, l'organizzazione deve disporre di un proprio server SFTP. Qualtrics mette a disposizione dei clienti dei server SFTP. Questo servizio comporta un costo; tuttavia, garantiamo che questi server sono compatibili con Qualtrics. Per ulteriori informazioni, si prega di contattare il proprio responsabile commerciale.
Impostazione di un lavoro in entrata sui file
Consiglio Q: per utilizzare questa funzione è necessaria l'autorizzazione "Manage Jobs".
Nella pagina Lavori, fare clic su Nuovo lavoro.
Selezionare i file.
Date un nome al vostro lavoro per poterlo identificare.
Scegliere il progetto in cui caricare i dati.
Date al vostro lavoro una descrizione, in modo da conoscerne lo scopo.
Fare clic su Successivo.
Scegliere il metodo di autenticazione per il server SFTP:
- Autenticazione di base: Connettersi utilizzando un nome utente e una password.
- Chiave SSH: connettiti utilizzando una chiave Secure Shell (SSH) fornita da te o da Qualtrics.
Utilizzare il menu a tendina per selezionare una connessione esistente o selezionare Aggiungi nuovo per creare una nuova connessione. Per ulteriori informazioni sulla creazione di una nuova connessione, vedere Aggiunta di un account SFTP.
Fare clic su Successivo.
Scegliere il tipo di file da caricare:
- File "piatti" separati da un delimitatore
- File Excel (XLS, XLSX)
- File JSON
- File WebVTT
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: selezionare il sistema di codifica del file (ad es. UTF-8, ASCII).
- 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.
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.
Attenzione:l'utente SFTP utilizzato da questo processo deve disporre dei permessi di lettura, eliminazione e creazione di cartelle per la directory di origine. Le credenziali di sola lettura non sono supportate. Una volta elaborato un file, il connettore lo elimina dalla directory di origine in modo che non venga rielaborato. Il connettore crea inoltre, in quella directory, una cartella "archive" e una cartella "bad" per archiviare le copie dei file elaborati e di quelli con errori. Se non è possibile concedere i permessi per "creare cartelle", creare manualmente le cartelle "archive" e "bad" nella directory di origine. È comunque necessaria l'autorizzazione alla cancellazione.
Inserire l'espressione regolare del nome del file che corrisponde ai file che si desidera caricare.
Se i file sono compressi, abilitare Unzip file(s) e inserire l'espressione regolare Zipped Filename che corrisponde ai file che devono essere decompressi.
Se i tuoi file sono stati decriptati, seleziona l'opzione "Decripta i file" e inserisci 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.
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.
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: se hai selezionato “feedback”, apparirà un secondo menu che ti consentirà di scegliere il tipo di dati relativi all’interazione da includere nel feedback. Le opzioni sono: chiamata, chat, e-mail, recensione, social e sondaggio.
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.
È 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.
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.
Fare clic sul pulsante Seleziona file campione e scegliere il file campione sul computer o sul server SFTP.
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.
Fare clic su Successivo.
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.
Fare clic su Successivo.
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.
Fare clic su Successivo.
Se si desidera, è possibile aggiungere un filtro al connettore per filtrare i dati in entrata e limitare i dati importati.
È 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.
Fare clic su Successivo.
Scegliete quando volete essere avvisati. Per ulteriori informazioni, consulta Notifiche di lavoro.
Fare clic su Successivo.
Scegliere come gestire i documenti duplicati. Per ulteriori informazioni, consulta Gestione dei duplicati.
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, consulta Pianificazione dei lavori.
Scegliere un periodo di conservazione per i file elaborati. I file vengono eliminati dopo il periodo impostato.
Fare clic su Successivo.
Valutate la vostra configurazione. Se è necessario modificare un'impostazione specifica, fare clic sul pulsante Modifica per accedere alla fase di impostazione del connettore.
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.
Consiglio Q: per informazioni sulla mappatura dei campi dati delle conversazioni, vedere Mappatura dei campi dati delle conversazioni.
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:
Aggiornamento della configurazione del campione
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.
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.
Attenzione: Vengono elaborati solo i file della cartella selezionata; le sottocartelle devono essere elaborate separatamente.
XM DISCOVER Cifrari per lo scambio di chiavi supportati
Consiglio Q: per ricevere assistenza sulle impostazioni descritte in questa sezione, ti consigliamo di rivolgerti al team IT della tua organizzazione.
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.
Consiglio Q: per garantire un accesso ininterrotto e sicuro ai server FTP, ti consigliamo di mantenere aggiornato il tuo software client FTP ed eseguire dei test dopo ogni modifica per assicurarti che funzioni correttamente.
Ecco un elenco dei principali algoritmi di scambio di chiavi supportati dai server SFTP 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
Consiglio Q: a causa del nostro impegno per la sicurezza, non supportiamo più rsa1024-sha1 o diffie-hellman-group-exchange-sha256. Si consiglia al team IT di aggiornare di conseguenza il software del client FTP.
È fantastico! Grazie per il tuo feedback!
Grazie per il tuo feedback!