Aufgabe Daten aus Qualtrics File Service extrahieren

Suite

Customer Experience Employee Experience Strategy & Research

Produkt

Qualtrics

Was finden Sie hier?

Informationen zum Extrahieren von Daten aus dem Qualtrics

Der Qualtrics File Service ist eine sichere und isolierte API, mit der Sie Dateien hochladen können. Verwenden von Workflowskönnen Sie Daten, die Sie im Qualtrics gespeichert haben, zur Verwendung an anderer Stelle in Qualtrics verarbeiten. Sie können beispielsweise Unternehmenskontakte im Qualtrics speichern und sie dann regelmäßig in Ihr Verzeichnis importieren.

Beispiel: Sie können die Aufgabe “Daten aus dem Qualtrics File Service extrahieren” mit anderen Loader-Aufgaben kombinieren, z. B. mit der Aufgabe “Kontakte und Transaktionen zu XMD hinzufügen“.

TIPP: Informationen über allgemeine Grenzen, die für ETL-Workflows übernommen werden, finden Sie unter Workflow-Grenzen. Für alle aufgabenspezifischen Grenzen siehe die Informationen auf dieser Seite.

Verbindung zum Qualtrics herstellen

Der Qualtrics File Service (QFS) ist eine gesicherte API, die es Ihnen ermöglicht, Dateien hochzuladen, die von dieser Automatisierung importiert werden sollen.

Achtung!: Möglicherweise müssen Sie mit Ihrem IT- oder Software-Engineering-Team zusammenarbeiten, um die Integration mit dem Qualtrics File Service vorzunehmen.

Um das QFS zu verwenden, laden Sie eine Datei auf einen HTTPS-Endpunkt hoch, die in einem grauen Kasten (siehe unten) als mehrteilige Formulardaten bereitgestellt wird.

Bild der URL für diese Tabelle, oben nach dem Anlegen der Aufgabe

Wenn die Automatisierung zur Ausführung eingeplant ist, verarbeitet sie alle Dateien, die noch nicht von der Automatisierung verarbeitet wurden, einschließlich neu hochgeladener Dateien.

Um den Qualtrics verwenden zu können, müssen Sie den bereitgestellten HTTPS-Endpunkt aufrufen. Wenn die Datei aus dem System generiert wird, möchten Sie die API und die folgende Beispielimplementierung für Ihr IT- oder Software-Engineering-Team zur Integration in unseren Service.

Beispiel: Dieses Beispiel hat das cURL-Format. Siehe API Supportseite zum Generieren eines API-Token.
Für Mac- und Unix-Benutzer:
curl -X POST -H "X-API-TOKEN: [YOUR API-TOKEN]" \ -F 'file=@/path/to/import/file/txt ' \ qualtrics
Für Windows-Benutzer:
curl -X POST -H "X-API-TOKEN: [YOUR API-TOKEN]" ^ -F "file=@/path/to/import/file/txt " ^ qualtrics

Beispiel: Dies ist ein Anfragebeispiel. Siehe API Supportseite zum Generieren eines API-Token.
POST qualtrics HTTP/1.1 Content-Type: multipart/form-data X-API-TOKEN: [IHRE API-TOKEN] ----------------------------- Content-Disposition: form-data; name="upfile"; filename="txt " Content-Type: text/plain [DATEIDATEN] -----------------------------

Hochgeladene Dateien manuell mit API verwalten

Sie können hochgeladene Dateien auch manuell über die Qualtrics API verwalten. Die folgenden Links erklären, wie man mit der Qualtrics File Service API interagiert:

Manchmal fragen diese API nach einer AutomationId. Qualtrics stellt Ihnen diese Informationen im Format AU_XXXXX zur Verfügung.

Bevor Sie beginnen

Bevor Sie mit der Extraktion von Daten aus dem Qualtrics beginnen, Benutzerkonto Sie Folgendes:

Was möchten Sie mit Ihren Daten tun? Werfen Sie einen Blick auf die verfügbare Loader-Aufgaben für eine Liste von Optionen.
Passen Ihre Dateien zu einem konsistenten Format? Beispielsweise sollten Dateien, die Sie in denselben Workflow importieren möchten, dieselben Kopfzeilen/Spalten/Felder haben, auch wenn sich die Werte unterscheiden.
Beispiel: Sie richten einen Workflow ein, um Kontakte regelmäßig aus dem Qualtrics in XM Directory hochzuladen. Jede Datei enthält Spalten für Firstname, Lastname, E-Mail, Telefon, UniqueID und Standort.

Einrichten einer Aufgabe zum Extrahieren von Daten aus dem Qualtrics

Tipp: Dateien, die von diesem Workflow verarbeitet werden, werden aus dem Qualtrics gelöscht.

Erstellen Sie einen ETL Workflow.

Auswählen Datenquelle (ETL).

hinzufügen einer Extraktoraufgabe zum Etl Workflow

Auswählen Daten aus Qualtrics extrahieren.

Bild dieser Aufgabe in dem Fenster, in dem Sie Aufgaben auswählen

Stellen Sie sicher, dass Ihre Dateien über den hier angezeigten eindeutigen HTTPS-Endpunkt in den Qualtrics hochgeladen werden. Weitere Informationen finden Sie unter Qualtrics.

Wählen Sie eine Dateityp:

CSV (durch Kommas getrennte Werte)
TSV (durch Tabulator getrennte Werte)
Benutzerdefiniertes Trennzeichen: Diese Option ist verfügbar, wenn Sie in Ihrer Datei ein anderes Trennzeichen als Tabulatoren oder Kommas verwenden. Geben Sie das Zeichen ein, das Sie in dem bereitgestellten Feld verwenden. (Beispiel: ; oder | ).

Wählen Sie bei Bedarf Verwenden Sie PGP, um Ihre Dateien zu verschlüsseln. mehr erfahren über diese zusätzlichen Verschlüsselungs- und Datenschutzmöglichkeiten finden Sie unter. PGP.

Entscheiden Sie, ob Sie eine strenge Validierung verwenden möchten, bei der extrahierte Dateien automatisch abgelehnt werden, wenn sie bestimmte Formatierungsprobleme aufweisen. Lesen Sie die Meldung in der Aufgabe, um weitere Informationen darüber zu erhalten, welche Dateien abgelehnt werden. Aktivieren Sie ggf. die Option Fehlformulierte Zeilen überspringen, um Ihre Datei hochzuladen und Zeilen mit Formatierungsproblemen auszuschließen.

ermöglichung einer strengen Validierung und Hochladen einer Stichprobendatei

Unter Stichprobe hochladenFügen Sie eine Stichprobe mit denselben Kopfzeilen wie die Dateien hinzu, die bei jeder Ausführung des Workflow verarbeitet werden. Klicken Sie auf Datei auswählen um die Datei von Ihrem Computer hochzuladen.

Tipp: Wenn Sie möchten, können Sie die Stichprobe in der Aufgabe oder die Dateien in der Abschnitt Beispieldateien. Das einzige unterstützte Dateikodierungsformat ist UTF-8. Einige Tabellenkalkulationssoftware sichert Dateien als Unicode UTF-8, was sich von UTF-8 unterscheidet, wenn Sie unerwartete Fehler erhalten. Stellen Sie sicher, dass Sie im UTF-8 und nicht im UTF-8 exportieren. Siehe CSV& TSV für weitere Schritte zur Fehlerbehebung.

Überprüfen Sie die Felder in der Datei. Die Tabelle zeigt die Spaltenüberschriften (die die einzelnen Felder darstellen) und ihre Werte für die ersten beiden Datenzeilen an.

Tipp: Wenn Sie eine andere Datei hochladen oder andere Änderungen vornehmen möchten, wählen Sie Einrichtung bearbeiten.

Wenn Sie fertig sind, klicken Sie auf Sichern.

Beenden Sie den Aufbau Ihres ETL Workflows. Wenn Sie eine Aufgabe auswählen, entscheiden Sie über das Ziel der extrahierten Daten. Siehe verfügbare Loader-Aufgaben für eine Liste von Optionen.

hinzufügung einer aufgabe für den lader zum etl workflow

Tipp: Um einzuschränken, was weiter geschieht, können Sie auch Folgendes anlegen: Bedingungen basierend auf der Anzahl der importierten Dateien oder Zeilen bevor Sie eine Aufgabe hinzufügen.

FAQs

Welche benutzerdefinierten Trennzeichen kann ich verwenden, um Kontakte mit Workflows in das XM Directory hochzuladen?

Sie haben vielleicht bemerkt, dass die verschiedenen Extraktionsaufgaben benutzerdefinierte Begrenzungszeichen unterstützen. (Zum Beispiel der Qualtrics File Service.) Sie können zwar technisch gesehen beliebige Begrenzungszeichen in diese Aufgaben eingeben, aber nicht alle Begrenzungszeichen werden von XM Directory unterstützt, so dass die Aufgabe möglicherweise fehlschlägt. Wir empfehlen, die folgenden Trennzeichen zu vermeiden:~ & * " _

Viele Seiten dieses Portals wurden mithilfe maschineller Übersetzung aus dem Englischen übersetzt. Obwohl wir bei Qualtrics die bestmögliche maschinelle Übersetzung ausgewählt haben, um ein möglichst gutes Ergebnis zu bieten, ist maschinelle Übersetzung nie perfekt. Der englische Originaltext gilt als offizielle Version. Abweichungen zwischen dem englischen Originaltext und den maschinellen Übersetzungen sind nicht rechtlich bindend.

Hat Ihnen das weitergeholfen?

Das von Ihnen eingereichte Feedback, dient lediglich dazu, diese Seite zu verbessern.

Großartig! Vielen Dank für die Rückmeldung!

Vielen Dank für die Rückmeldung!