Attività Estrai dati da file SFTP

Informazioni sull’attività Estrai dati dai file SFTP

L’attività Estrai i dati dai file SFTP ti consente di importare i dati dal tuo server SFTP da utilizzare in Qualtrics. È possibile utilizzare questo task per elaborare solo uno o più file alla volta. Puoi combinare questa attività con altre attività, come l’attività Carica dati nella directory XM, per importare i dati in altri punti di Qualtrics.

Per ulteriori informazioni sulla configurazione e la risoluzione dei problemi di SFTP, vedere Eliminazione degli errori SFTP.

Connessione di un account SFTP

Prima di poter utilizzare l’attività Estrai dati da file SFTP, devi connettere un account SFTP da cui Qualtrics possa estrarre i dati. Gli account possono essere aggiunti da Brand Administrator per altri utenti della licenza, o da singoli utenti per il loro utilizzo personale.

Esistono 3 diverse opzioni di autenticazione:

• Password: autenticare con un nome utente e una password.
• Chiave SSH: Autentica utilizzando una chiave Secure Shell (SSH) fornita dall’utente o una chiave fornita da Qualtrics.
• Chiave SSH crittografata: Autentica utilizzando una chiave SSH crittografata.

Aggiunta di un account come amministratore del brand

Se sei un Amministratore della licenza, segui i passaggi di questa sezione per aggiungere un account SFTP per alcuni o tutti gli utenti della tua licenza da utilizzare.

1. Utilizzando il menu di navigazione in alto a sinistra, passare ad Amministrazione.
   
2. Passare a Estensioni.
3. Fare clic sull’estensione Estrai dati da file SFTP.
4. Fare clic su Aggiungi account.
   
5. Assegnare un nome all’account. Questo nome viene utilizzato per scopi organizzativi e per identificare il cliente.
   
6. Immettere il nome host del server SFTP associato.
   Esempio: Generalmente questi sono nel formato sftp.example.com
7. Immettere il numero di Porta. Di solito si tratta di 22.
8. Scegliere il metodo di autenticazione. Le opzioni includono:
   • Password: fornire un nome utente e una password per l’autenticazione.
   • Chiave SSH: fornire un nome utente e una chiave SSH per l’autenticazione, oppure utilizzare una chiave SSH generata da Qualtrics.
   • Chiave SSH crittografata: fornire la propria chiave SSH crittografata con una frase chiave per l’autenticazione.
9. Se è stata scelta la password, immettere il nome utente e la password per l’account SFTP.
   
10. Se si esegue l’autenticazione con una chiave SSH, effettuare una delle seguenti operazioni:
    • Se si utilizza una chiave SSH generata da Qualtrics, immettere un Nome utente, quindi fare clic su Genera coppia di chiavi SSH.
      È quindi possibile fare clic su Scarica chiave SSH pubblica per scaricare la chiave pubblica come file .pem sul computer. La chiave privata associata verrà memorizzata da Qualtrics. Fare clic su Copia negli appunti per copiare l’impronta digitale della chiave negli appunti. Salvare entrambi in un luogo sicuro in modo da poter fare riferimento loro, se necessario.
    • Se si utilizza la propria chiave SSH, fare clic su Fornisci una chiave privata.
      Quindi, immettere il nome utente e la chiave SSH.
      Qtip: in questa casella è necessario immettere una chiave privata non protetta da password. Inoltre, la chiave pubblica deve essere autorizzata sul server SFTP.
      Esempio:
      Questo è l’aspetto tipico di una chiave SSH (incluse le righe chiave di inizio e fine RSA):
      —–BEGIN RSA PRIVATE KEY—–
      a1b2c3d4…
      —–END RSA PRIVATE KEY—–
11. Se si esegue l’autenticazione con la chiave SSH crittografata, immettere il nome utente, la chiave SSH crittografata e la frase chiave associata alla chiave.
12. Al termine, fai clic su Connetti account.

Aggiunta di un account come singolo utente

Seguire la procedura descritta in questa sezione per aggiungere un account SFTP per l’utilizzo personale. Solo tu sarai in grado di utilizzare l’account che ti sei connesso.

1. Seguire la procedura descritta nella sezione Configurazione di un’attività Estrai dati da file SFTP fino ad arrivare alla fase in cui si seleziona un account da utilizzare.
2. Fare clic su Aggiungi account utente.
   
3. Segui le istruzioni riportate sopra nella sottosezione “Aggiunta di un account come amministratore del brand” per maggiori informazioni sulla connessione del tuo account. Le stesse opzioni e impostazioni di autenticazione sono disponibili quando si aggiunge un account come singolo utente.

Verifica della connessione

Dopo aver aggiunto un account, è possibile verificare la connessione dall’interno dell’attività Estrai dati dai file SFTP. In fondo all’attività, fare clic su Verifica connessione. In questo modo verrà caricato un piccolo file di test sul server, ne verrà letto il contenuto e quindi eliminato il file. 

Download di chiavi SSH pubbliche

Se si utilizza una chiave SSH generata da Qualtrics, è possibile scaricare la chiave pubblica per la connessione. Quando si visualizza l’elenco degli account SFTP da utilizzare, fare clic sul menu a tre puntini a destra di un account, quindi scegliere Scarica chiave SSH pubblica. Questo scaricherà la chiave per il tuo computer come file .pem.

Aggiornamento delle chiavi SSH generate da Qualtrics

Se si utilizza una chiave SSH generata da Qualtrics, è possibile rigenerare la chiave, se necessario. Ciò è utile se si ritiene che la chiave sia stata compromessa o se l’azienda richiede di ruotare le chiavi dopo un determinato periodo di tempo.

1. Quando si visualizza l’elenco degli account SFTP da utilizzare, fare clic sul menu a tre puntini a destra dell’account e fare clic su Modifica account.
2. Fare clic sul collegamento ipertestuale per generare una nuova coppia di chiavi.
   

Impostazione di un’attività Estrai dati dai file SFTP

1. Creare un workflow ETL.
2. Selezionare sorgente dati (estrattore ETL).
   
3. Selezionare l’attività Estrai dati dai file SFTP.
   
4. Selezionare l’account SFTP da cui estrarre i file. Tutti gli account aggiunti dagli Amministratori della licenza, nonché gli account che hai aggiunto da solo, saranno elencati qui.
   
5. Per aggiungere nuove credenziali dell’account SFTP, fare clic su Aggiungi un account utente e seguire la procedura nella sezione sulla connessione di un account SFTP.
6. Fare clic su Successivo.
7. Immettere il modello del nome del file, utilizzato per identificare i file da elaborare osservando il prefisso del file. Verranno elaborati tutti i file con il prefisso specificato. Immettere il prefisso desiderato nella casella.
   
   Esempio: Supponiamo di avere un file chiamato Qualtrics ics-DataImport.csv. Posso inserire “Q” o “Qualtrics” come prefisso, a seconda che ci siano altri file nel server che voglio elaborare.
   Consiglio Q: fare clic sulla casella di controllo Utilizza espressione regolare se si desidera utilizzare l’espressione regolare per il modello del nome file.
8. Immettere la directory Pickup o il percorso della directory per trovare il file sul server. È possibile inserire un percorso relativo o un percorso assoluto.
   Qtip: questo percorso della directory fa distinzione tra maiuscole e minuscole e deve puntare a una cartella esistente, altrimenti il workflow avrà esito negativo. Qualtrics non sarà in grado di accedere ai file se si trovano in una directory di livello superiore a quella specificata nella directory di ritiro.

   Esempio: A seconda del percorso immesso, le potenziali directory di prelievo potrebbero essere:

   • /home/username/myFolder (percorso assoluto)
   • myFolder (percorso relativo)
9. Se il file è compresso, abilitare l’opzione Stai estraendo da un file zip. Quindi, immettere il Prefisso per il file all’interno dello zip che verrà utilizzato per trovare il file corretto da importare dal file zip.
   Qtip: Sono supportate solo le compressioni .zip. I file nel file .zip possono essere crittografati, ma il file .zip stesso non può essere (ad esempio, nomefile.csv.pgp.zip è supportato ma non nomefile.csv.zip.pgp).
10. Selezionare un tipo di file.
    
    Le opzioni includono:
    • CSV
    • TSV
    • JSON

      Consiglio Q: i file JSON devono avere il loro contenuto racchiuso tra parentesi quadre, []. Ad esempio:

      [
         {
             "frutta": "Apple",
             "taglia": "Grande",
             "colore": "Rosso"
         }
       ]

    • Excel (.xslx o .xls)
11. Se si elabora un file CSV, selezionare il Delimitatore per il file. Le opzioni includono virgola, punto e virgola, tabulazione e barra verticale.
12. Se lo si desidera, selezionare Decodifica file prima di eseguire l’importazione mediante PGP. Per ulteriori informazioni su questo metodo supplementare di crittografia e protezione dei dati, consultare PGP Encryption.
    Qtip: assicurati che i file che desideri importare siano crittografati con la chiave pubblica di Qualtrics prima di caricarli sul tuo server SFTP. Per farlo, potresti dover parlare con il tuo team IT.
13. Se si desidera saltare i file che non possono essere elaborati, selezionare Ignora file non validi. Se questa opzione non è selezionata, l’intero flusso di lavoro fallirà quando si tenta di elaborare il file non valido.
    Consiglio Q: Ci sono una serie di motivi per cui un file non può essere elaborato. Il più comune è che è troppo grande o i suoi dati sono corrotti in qualche modo.
14. Scegli cosa vuoi che accada dopo l’elaborazione del file. Le opzioni includono:
    • Elimina il file elaborato: dopo aver elaborato il file, Qualtrics lo elimina dal tuo server SFTP. Questa opzione è abilitata per impostazione predefinita.
    • Conserva il file elaborato: dopo aver elaborato il file, Qualtrics lascia il file sul tuo server SFTP.
15. Decidere se si desidera utilizzare la convalida rigorosa, che rifiuterà automaticamente i file estratti in caso di determinati problemi di formattazione. Leggere il messaggio nell’attività per ulteriori informazioni sui file che verranno rifiutati.
    
    Consiglio Q: abilita Ignora righe errate per caricare il file ed escludere eventuali righe con problemi di formattazione.
16. Fai clic su Scegli file e carica un file di esempio, che indicherà a Qualtrics i campi che desideri importare e determinerà le successive attività che puoi utilizzare con questa attività. Il file caricato deve contenere i campi che si desidera importare come parte di questa attività.
    Qtip: scaricare i file di esempio nel task o scaricare i file nella sezione dei file di esempio per i modelli su come strutturare i dati in base al proprio caso di utilizzo. L’unico formato di codifica file supportato è UTF-8. Alcuni software per fogli di calcolo salvano come Unicode UTF-8, che è diverso da UTF-8, in caso di errori imprevisti. Assicurarsi di eseguire l’esportazione in formato UTF-8 e non in formato Unicode UTF-8.
    
17. Ricontrollare che il file stia importando correttamente i dati. Se è necessario modificare le impostazioni, fare clic su Indietro nella parte superiore dell’attività.
    

    Qtip: se tutti i dati vengono importati come una colonna, si sta utilizzando il delimitatore errato. Il seguente screenshot mostra l’aspetto di questo elemento nella finestra del task.

    

18. Se i dati sono corretti, fare clic su Salva.
19. Termina la creazione del flusso di lavoro ETL. Quando si sceglie un task del caricatore, si decide la destinazione dei dati estratti. Vedere le attività del caricatore disponibili per un elenco di opzioni.
    

File di esempio

Di seguito sono riportati file di esempio su come strutturare i dati per l’importazione, a seconda del tipo di dati che si desidera importare. Fare clic sul nome di un file per scaricare il file di esempio.

• Dati utente
• Dati risposta sondaggio
• Dati di contatto Salesforce
• Dati account Salesforce
• Dati membro del team del cliente Salesforce
• Dati dipendente

FAQ