Passa al contenuto principale
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Attività Estrai dati da file SFTP


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


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.

Qtip: Qualtrics offre i nostri server SFTP per i clienti attraverso il nostro team di servizi professionali. Esiste un costo associato a questo servizio; tuttavia, garantiamo che questi server funzioneranno con le automazioni. Per maggiori informazioni, contatta il nostro team di Servizi professionali.

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

Attenzione: affinché questa attività abbia esito positivo, il tuo account SFTP deve disporre delle autorizzazioni di lettura, scrittura ed eliminazione.

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.

Consiglio Q: Quando imposti una connessione SFTP, consigliamo al tuo team IT di inserire nella lista gli intervalli IP Qualtrics.

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.
    passando alla sezione estensioni di admin e selezionando i dati estratti dallestensione dei file sftp
  2. Passare a Estensioni.
  3. Fare clic sull’estensione Estrai dati da file SFTP.
  4. Fare clic su Aggiungi account.
    facendo clic su Aggiungi account
  5. Assegnare un nome all’account. Questo nome viene utilizzato per scopi organizzativi e per identificare il cliente.
    assegnando un nome allaccount, immettendo il nome host e la porta e scegliendo un metodo di autenticazione
  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.
    Immissione di un nome utente e di una password
  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.facendo 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.Scaricare la chiave ssh
    • Se si utilizza la propria chiave SSH, fare clic su Fornisci una chiave privata.facendo clic su Fornisci una chiave privata
      Quindi, immettere il nome utente e la chiave SSH.immettendo 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.inserendo i dettagli per utilizzare una chiave ssh crittografata
  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.
    facendo 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.  il pulsante Test

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.facendo clic su un account e selezionando Scarica chiave ssh pubblica

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.

Attenzione: questa azione aggiornerà automaticamente la chiave SSH dell’account e non potrà essere annullata. Accertarsi di voler rigenerare la chiave prima di seguire i passi in questa sezione.
  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.facendo clic su Modifica accanto a un account
  2. Fare clic sul collegamento ipertestuale per generare una nuova coppia di chiavi.
    fare clic qui per generare nuove coppie di chiavi
Qtip: Assicurati di fare clic su Scarica chiave SSH pubblica e Copia negli appunti per salvare la nuova chiave SSH.

Impostazione di un’attività Estrai dati dai file SFTP

Attenzione: l’attività Estrai dati da file SFTP ha un limite di 200 file per esecuzione, con ogni singolo file con un limite di dimensione file di 1 GB e un limite di dimensione file totale di 2 GB per tutti i file. Se i file superano questi limiti, il task non riuscirà, ovvero nessuno dei file verrà elaborato.
Attenzione: non è possibile utilizzare terminatori linea di ritorno a capo con questo task.
  1. Creare un workflow ETL.
  2. Selezionare sorgente dati (estrattore ETL).
    Aggiunta di un estrattore a un task ETL
  3. Selezionare l’attività Estrai dati dai file SFTP.
    selezione dei dati estratti 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.
    scegliendo un account o aggiungendone uno nuovo
  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.
    inserendo un nome file, una directory e un prefisso zip

    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.
    scegliendo un file e le opzioni del 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.
    abilitando lutilizzo di una convalida rigorosa

    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.
    la finestra dei file di esempio
  17. Ricontrollare che il file stia importando correttamente i dati. Se è necessario modificare le impostazioni, fare clic su Indietro nella parte superiore dell’attività.
    revisione dei campi di importazione

    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.

    la finestra di importazione quando è selezionato il delimitatore errato. Tutti i dati vengono importati come una colonna

  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.
    aggiunta di un task del caricatore al flusso di lavoro

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.

FAQ

Molte delle pagine di questo sito sono state tradotte dall'originale in inglese mediante traduzione automatica. Sebbene in Qualtrics abbiamo profuso il massimo impegno per avere le migliori traduzioni automatiche possibili, queste non sono mai perfette. Il testo originale inglese è considerato la versione ufficiale, e qualsiasi discrepanza tra questo e le traduzioni automatiche non è legalmente vincolante.