Aufgabe „Daten aus SFTP-Dateien extrahieren“

Aufgabe zum Extrahieren von Daten aus SFTP-Dateien

Mit der Aufgabe Daten aus SFTP-Dateien extrahieren können Sie Daten von Ihrem SFTP-Server zur Verwendung in Qualtrics importieren. Mit dieser Aufgabe können Sie nur eine oder mehrere Dateien gleichzeitig verarbeiten. Sie können diese Aufgabe mit anderen Aufgaben kombinieren, z.B. mit der Aufgabe Daten in XM Directory laden, um Daten an andere Stellen in Qualtrics zu importieren.

Weitere Informationen zur SFTP-Einrichtung und Fehlerbehebung finden Sie unter SFTP-Fehlerbehebung.

Verbinden eines SFTP-Kontos

Bevor Sie die Aufgabe Daten aus SFTP-Dateien extrahieren verwenden können, müssen Sie ein SFTP-Konto für Qualtrics verbinden, um die Daten aus zu extrahieren. Konten können von Administratoren hinzugefügt werden, damit andere Benutzer der Marke sie verwenden können, oder von einzelnen Benutzern für ihre persönliche Verwendung.

Es gibt drei verschiedene Authentifizierungsoptionen:

• Kennwort: Authentifizieren Sie sich mit einem Benutzernamen und einem Kennwort.
• SSH-Schlüssel: Authentifizieren Sie mit einem von Ihnen angegebenen SSH-Schlüssel (Secure Shell) oder einem von Qualtrics bereitgestellten Schlüssel.
• Verschlüsselter SSH-Schlüssel: Authentifizieren Sie mit einem verschlüsselten SSH-Schlüssel.

Konto als Administrator hinzufügen

Wenn Sie ein Administrator sind, führen Sie die Schritte in diesem Abschnitt aus, um ein SFTP-Konto für einige oder alle Benutzer in Ihrer Lizenz hinzuzufügen.

1. Navigieren Sie über das Navigationsmenü oben links zu Admin.
   
2. Navigieren Sie zu Erweiterungen.
3. Klicken Sie auf die Erweiterung Daten aus SFTP-Dateien extrahieren.
4. Klicken Sie auf Konto hinzufügen.
   
5. Geben Sie dem Konto einen Namen. Dieser Name wird für organisatorische Zwecke und zur Identifikation des Accounts verwendet.
   
6. Geben Sie den Hostnamen des zugehörigen SFTP-Servers ein.
   Beispiel: Im Allgemeinen haben diese das Format sftp.example.com.
7. Geben Sie die Portnummer ein. (In der Regel ist dies Q1.)
8. Wählen Sie Ihre Authentifizierungsmethode aus. Folgende Optionen sind verfügbar:
   • Kennwort: Geben Sie einen Benutzernamen und ein Kennwort für die Authentifizierung an.
   • SSH-Schlüssel: Geben Sie einen Benutzernamen und einen SSH-Schlüssel für die Authentifizierung an, oder verwenden Sie einen von Qualtrics generierten SSH-Schlüssel.
   • Verschlüsselter SSH-Schlüssel: Geben Sie Ihren eigenen verschlüsselten SSH-Schlüssel mit einer Kennphrase für die Authentifizierung an.
9. Wenn Sie Kennwort wählen, geben Sie den Benutzernamen und das Kennwort für das SFTP-Konto ein.
   
10. Wenn Sie sich mit einem SSH-Schlüssel authentifizieren, führen Sie einen der folgenden Schritte aus:
    • Wenn Sie einen von Qualtrics generierten SSH-Schlüssel verwenden, geben Sie einen Benutzernamen ein, und klicken Sie dann auf SSH-Schlüsselpaar generieren.
      Sie können dann auf Öffentlichen SSH-Schlüssel herunterladen klicken, um den öffentlichen Schlüssel als .pem-Datei auf Ihren Computer herunterzuladen. Der zugehörige private Schlüssel wird von Qualtrics gespeichert. Klicken Sie auf In Zwischenablage kopieren, um den Fingerabdruck des Schlüssels in die Zwischenablage zu kopieren. Sichern Sie beide an einem sicheren Ort, damit Sie sie bei Bedarf referenzieren können.
    • Wenn Sie Ihren eigenen SSH-Schlüssel verwenden, klicken Sie auf Geben Sie einen privaten Schlüssel an.
      Geben Sie dann Ihren Benutzernamen und den SSH-Schlüssel ein.
      Tipp: Sie müssen einen privaten Schlüssel ohne Kennwortschutz in dieses Feld eingeben. Außerdem muss der öffentliche Schlüssel auf Ihrem SFTP-Server autorisiert sein.
      Beispiel:
      So sieht ein SSH-Schlüssel typischerweise aus (einschließlich der RSA-Anfangs- und Endschlüsselzeilen):
      —–BEGIN RSA PRIVATE KEY—–
      a1b2c3d4…
      —–END RSA PRIVATE KEY—–
11. Wenn Sie sich mit einem verschlüsselten SSH-Schlüssel authentifizieren, geben Sie den Benutzernamen, den verschlüsselten SSH-Schlüssel und die Kennphrase ein, die mit Ihrem Schlüssel verknüpft sind.
12. Wenn Sie fertig sind, klicken Sie auf Konto verbinden.

Hinzufügen eines Kontos als Einzelbenutzer

Führen Sie die Schritte in diesem Abschnitt aus, um ein SFTP-Konto für Ihre persönliche Verwendung hinzuzufügen. Nur Sie können das Konto verwenden, mit dem Sie eine Verbindung herstellen.

1. Folgen Sie den Schritten im Abschnitt Einrichten einer Aufgabe zum Extrahieren von Daten aus SFTP-Dateien, bis Sie zu dem Schritt gelangen, in dem Sie ein zu verwendendes Konto auswählen.
2. Klicken Sie auf Benutzerkonto hinzufügen.
   
3. Befolgen Sie die Anweisungen im Unterabschnitt „Hinzufügen eines Kontos als Administrator“ oben, um weitere Informationen zum Verbinden Ihres Kontos zu erhalten. Wenn Sie ein Konto als einzelner Benutzer hinzufügen, stehen Ihnen dieselben Authentifizierungsoptionen und -einstellungen zur Verfügung.

Verbindung testen

Nachdem Sie ein Konto hinzugefügt haben, können Sie die Verbindung aus der Aufgabe Daten aus SFTP-Dateien extrahieren heraus testen. Klicken Sie unten in der Aufgabe auf Verbindung testen. Dadurch wird eine kleine Testdatei auf Ihren Server hochgeladen, der Inhalt gelesen und anschließend gelöscht. 

Öffentliche SSH-Schlüssel werden heruntergeladen

Wenn Sie einen von Qualtrics generierten SSH-Schlüssel verwenden, können Sie den öffentlichen Schlüssel für die Verbindung herunterladen. Wenn Sie die Liste der zu verwendenden SFTP-Konten anzeigen, klicken Sie auf das Menü mit den drei Punkten rechts neben einem Konto, und wählen Sie dann Öffentlichen SSH-Schlüssel herunterladen. Dadurch wird der Schlüssel als .pem-Datei auf Ihren Computer heruntergeladen.

Aktualisieren von Qualtrics-generierten SSH-Schlüsseln

Wenn Sie einen von Qualtrics generierten SSH-Schlüssel verwenden, können Sie den Schlüssel bei Bedarf neu generieren. Dies ist nützlich, wenn Sie glauben, dass der Schlüssel kompromittiert wurde, oder wenn Ihr Unternehmen erfordert, dass Sie Schlüssel nach einer bestimmten Zeit drehen.

1. Wenn Sie die Liste der zu verwendenden SFTP-Konten anzeigen, klicken Sie auf das Menü mit den drei Punkten rechts neben dem Konto und dann auf Konto bearbeiten.
2. Klicken Sie auf den Hyperlink, um ein neues Schlüsselpaar zu generieren.
   

Aufgabe „Daten aus SFTP-Dateien extrahieren“ einrichten

1. Legen Sie einen ETL-Workflow an.
2. Wählen Sie Datenquelle (ETL-Extraktor).
   
3. Wählen Sie die Aufgabe Daten aus SFTP-Dateien extrahieren.
   
4. Wählen Sie das SFTP-Konto aus, aus dem Dateien extrahiert werden sollen. Hier werden alle Konten aufgeführt, die von Administratoren hinzugefügt wurden, sowie alle Konten, die Sie selbst hinzugefügt haben.
   
5. Wenn Sie neue SFTP-Kontoanmeldedaten hinzufügen möchten, klicken Sie auf Benutzerkonto hinzufügen, und führen Sie die Schritte im Abschnitt Verbinden eines SFTP-Kontos aus.
6. Klicken Sie auf Weiter.
7. Geben Sie das Dateinamensmuster ein, das verwendet wird, um anhand des Präfixes der Datei zu identifizieren, welche Dateien verarbeitet werden sollen. Alle Dateien mit dem von Ihnen angegebenen Präfix werden verarbeitet. Geben Sie das gewünschte Präfix in das Feld ein.
   
   Beispiel: Angenommen, ich habe eine Datei namens Qualtrics-DataImport.csv. Ich kann „Q“ oder „Qualtrics“ als Präfix eingeben, je nachdem, ob es andere Dateien auf dem Server gibt, den ich verarbeiten möchte.
   Tipp: Aktivieren Sie das Kontrollkästchen Regulären Ausdruck verwenden, wenn Sie Regex für Ihr Dateinamensmuster verwenden möchten.
8. Geben Sie das Pickup-Verzeichnis oder den Verzeichnispfad ein, um die Datei auf dem Server zu finden. Sie können entweder einen relativen Pfad oder einen absoluten Pfad eingeben.
   Tipp: Dieser Verzeichnispfad unterscheidet zwischen Groß- und Kleinschreibung und muss auf einen vorhandenen Ordner verweisen, sonst schlägt der Workflow fehl. Qualtrics kann nicht auf Dateien zugreifen, die sich in einem Verzeichnis höherer Ebene als dem im Pickup-Verzeichnis angegebenen befinden.

   Beispiel: Je nachdem, welchen Pfad Sie eingeben, können folgende Abholverzeichnisse möglich sein:

   • /home/username/myFolder (absoluter Pfad)
   • myFolder (relativer Pfad)
9. Wenn Ihre Datei komprimiert ist, aktivieren Sie die Option Extrahieren Sie aus einer ZIP-Datei?. Geben Sie dann das Präfix für die Datei in der ZIP-Datei ein, die verwendet wird, um die richtige Datei für den Import aus der ZIP-Datei zu finden.
   Tipp: Es werden nur ZIP-Komprimierungen unterstützt. Die Dateien in der ZIP-Datei können verschlüsselt werden, die ZIP-Datei selbst jedoch nicht (z.B. wird Dateiname.csv.pgp.zip unterstützt, Dateiname.csv.zip.pgp jedoch nicht).
10. Wählen Sie einen Dateityp aus.
    
    Folgende Optionen sind verfügbar:
    • CSV
    • TSV
    • JSON

      Tipp: JSON-Dateien müssen ihren Inhalt in eckige Klammern [] einschließen. Zum Beispiel:

      [
         {
             "fruit": "Apple",
             "size": "Large",
             "color": "Red"
         }
       ]

    • Excel (.xslx oder .xls)
11. Wenn Sie eine CSV-Datei verarbeiten, wählen Sie das Trennzeichen für die Datei. Zu Ihren Optionen gehören Komma, Semikolon, Tabulator und Pipe.
12. Wählen Sie bei Bedarf Dateien vor dem Import mit PGP entschlüsseln. Weitere Informationen über diese zusätzlichen Mittel der Verschlüsselung und des Datenschutzes finden Sie unter PGP Encryption.
    Tipp: Stellen Sie sicher, dass die Dateien, die Sie importieren möchten, mit dem öffentlichen Qualtrics-Schlüssel verschlüsselt sind, bevor Sie sie auf Ihren SFTP-Server hochladen. Dazu müssen Sie möglicherweise mit Ihrem IT-Team sprechen.
13. Wenn Sie Dateien überspringen möchten, die nicht verarbeitet werden können, wählen Sie Fehlerhafte Dateien überspringen. Wenn diese Option nicht ausgewählt ist, schlägt der gesamte Workflow fehl, wenn er versucht, die fehlerhafte Datei zu verarbeiten.
    Tipp: Es gibt eine Reihe von Gründen, warum eine Datei nicht verarbeitet werden kann. Die häufigste ist, dass sie zu groß ist oder ihre Daten in irgendeiner Weise beschädigt sind.
14. Wählen Sie aus, was nach der Verarbeitung der Datei geschehen soll. Folgende Optionen sind verfügbar:
    • Verarbeitete Datei löschen: Nach der Verarbeitung löscht Qualtrics sie von Ihrem SFTP-Server. Diese Option ist standardmäßig aktiviert.
    • Bewahren Sie die verarbeitete Datei auf: Nach der Verarbeitung der Datei verlässt Qualtrics die Datei auf Ihrem SFTP-Server.
15. Entscheiden Sie, ob Sie eine strikte Validierung verwenden möchten, die extrahierte Dateien bei bestimmten Formatierungsproblemen automatisch ablehnt. Lesen Sie die Meldung in der Aufgabe, um weitere Informationen darüber zu erhalten, welche Dateien abgelehnt werden.
    
    Tipp: Aktivieren Sie Fehlerhafte Zeilen überspringen, um Ihre Datei hochzuladen und Zeilen mit Formatierungsproblemen auszuschließen.
16. Klicken Sie auf Datei auswählen, und laden Sie eine Beispieldatei hoch, die Qualtrics mitteilt, welche Felder Sie importieren möchten, und legen Sie die nachfolgenden Aufgaben fest, die Sie mit dieser Aufgabe verwenden können. Die Datei, die Sie hochladen, sollte die Felder enthalten, die Sie im Rahmen dieser Aufgabe importieren möchten.
    Tipp: Laden Sie die Beispieldateien in der Aufgabe herunter, oder laden Sie die Dateien im Abschnitt mit den Beispieldateien herunter, um Vorlagen zur Strukturierung Ihrer Daten basierend auf Ihrem Anwendungsfall zu erhalten. Das einzige unterstützte Dateikodierungsformat ist UTF-8. Einige Tabellenkalkulationssoftware werden als Unicode UTF-8 gesichert, was sich von UTF-8 unterscheidet, wenn unerwartete Fehler auftreten. Stellen Sie sicher, dass Sie im UTF-8-Format und nicht im Unicode-UTF-8-Format exportieren.
    
17. Überprüfen Sie nochmals, ob Ihre Datei die Daten korrekt importiert. Wenn Sie Ihre Einstellungen ändern müssen, klicken Sie oben in der Aufgabe auf Zurück.
    

    Tipp: Wenn all Ihre Daten als eine Spalte importiert werden, verwenden Sie das falsche Trennzeichen. Der folgende Screenshot zeigt, wie dies im Aufgabenfenster aussieht.

    

18. Wenn Ihre Daten korrekt sind, wählen Sie Sichern.
19. Schließen Sie die Erstellung Ihres ETL-Workflows ab. Wenn Sie eine Loader-Aufgabe auswählen, legen Sie das Ziel der von Ihnen extrahierten Daten fest. Eine Liste der Optionen finden Sie in den verfügbaren Loader-Aufgaben.
    

Beispieldateien

Im Folgenden finden Sie Beispieldateien für die Strukturierung Ihrer Daten für den Import, abhängig von der Art der Daten, die Sie importieren möchten. Klicken Sie auf einen Dateinamen, um die Beispieldatei herunterzuladen.

• Benutzerdaten
• Umfrageantwortdaten
• Salesforce-Kontaktdaten
• Salesforce-Kontodaten
• Salesforce-Account-Teammitgliedsdaten
• Mitarbeiterdaten

Häufig gestellte Fragen