Ausgangskonnektor für Dateien
Informationen zum Ausgangskonnektor für Dateien
Sie können den Ausgangskonnektor für Dateien verwenden, um angereicherte Daten aus XM Discover zu Compliance- und Datensicherungszwecken zu extrahieren oder in externen Anwendungen darauf zu reagieren.
Sie können Daten auf Satz- und Dokumentebene exportieren, sie auf neue und aktualisierte Datensätze beschränken und auswählen, welche Felder, Anreicherungen und Klassifizierungen exportiert werden sollen. Der Dateiausgangskonnektor sichert Daten auf einem SFTP-Server (Secure File Transfer Protocol).
VOR IHNEN BEGINN
Bevor Sie einen Job mit dem Ausgangskonnektor für Dateien konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:
- Benutzername und Kennwort Ihres SFTP-Kontos.
- Ein PGP/GPG-Schlüssel, wenn Sie von XM Discover gelieferte Dateien verschlüsseln möchten.
Folgende Dateiformate werden unterstützt:
- Textdateien mit Trennzeichen (CSV).
- JavaScript-Object-Notation-Dateien (JSON).
EINSTELLUNG DER VERBINDUNG
Connector-Job für ausgehende Dateien konfigurieren
Nachdem Sie die Verbindung eingerichtet haben, führen Sie die folgenden Schritte aus, um einen Job zu konfigurieren:
- Schritt 1: Jobnamen angeben
- Schritt 2: Projekt und Beschreibung angeben
- Schritt 3: Anmeldeinformationen für einen Qualtrics-SFTP-Ordner angeben
- Schritt 4: Anmeldeinformationen für XM Discover Export einrichten
- Schritt 5: Abfragekonfiguration
- Schritt 6: Dateikonfiguration bereitstellen
- Schritt 7: Gewünschte Felder Qualtrics zuordnen
- Schritt 9: Filter (optional) und Datensatzlimit angeben
- Schritt 10: Benachrichtigungskonfiguration (optional)
- Schritt 11: Zusätzliche Optionen für Job einrichten
- Schritt 12: Alle Jobeinstellungen bestätigen
Schritt 1: Jobnamen angeben
Schritt 2: Projekt und Beschreibung angeben
- Wählen Sie auf der Seite Projekt und Beschreibung angeben ein Projekt aus, aus dem Daten aus dem Dropdown-Menü „Projekte“ extrahiert werden sollen.
Tipp: Das Projekt sollte mit dem Projekt übereinstimmen, das durch den Export-API-Schlüssel identifiziert wurde. Wenn eine Abweichung vorliegt, verwendet der Job das durch den API-Schlüssel identifizierte Projekt.Tipp: Sie haben die Möglichkeit, im Feld Stellenbeschreibung eine Notiz zum Job einzugeben. Die Auftragsbeschreibung, die Sie im Feld Auftragsbeschreibung eingeben, kann nur in der Liste Konnektoren aufgerufen werden und wird nicht als Teil der Daten für einen Auftrag exportiert. - Klicken Sie auf Weiter.
Schritt 3: Anmeldeinformationen für ein Qualtrics-SFTP-Konto angeben
- Auf der Seite Anmeldeinformationen für einen Qualtrics-SFTP-Ordner angeben können Sie einen vorhandenen Satz von Anmeldeinformationen aus dem Dropdown-Menü auswählen oder einen neuen Satz von Anmeldeinformationen hinzufügen. Informationen zum Hinzufügen neuer Anmeldeinformationen finden Sie im Abschnitt Neue SFTP-Anmeldeinformationen hinzufügen.
- Klicken Sie auf Weiter.
Schritt 4: Anmeldeinformationen für XM Discover Export einrichten
Schritt 5: Abfragekonfiguration
Auf der Seite Abfragekonfiguration können Sie die Ebene zum Exportieren von Daten aus XM Discover angeben und auswählen, welche Datensätze Sie abrufen möchten.
- Wählen Sie eine der folgenden Optionen aus dem Dropdown-Menü Wählen Sie die Datenebene aus, um die mit den ausgehenden Daten verknüpfte Datengranularitätsebene auszuwählen:
- Sätze: Verwenden Sie den Export auf Satzebene für detailliertere Informationen und Anreicherungen auf Satzebene wie Themen, Stimmung, Aufwandswerte usw.
- Dokumente: Verwenden Sie den Export auf Dokumentebene, wenn Sie Werte für strukturierte Attribute exportieren möchten, die sich auf ein gesamtes Dokument beziehen.
Achtung: Wenn Sie Anreicherungen auf Satzebene verwenden, setzen Sie die Datenebene auf Sätze.
- Weitere Informationen zu den für die einzelnen Ebenen verfügbaren Anreicherungen finden Sie unter Sofort einsatzbereite Attribute.
- Geben Sie eine Abfrage zum Filtern der Ausgangsdaten im Feld Abfrage eingebenein (optional).
Tipp: Verwenden Sie dieselbe Syntax wie zum Nachschlagen von Daten in Designer. Weitere Informationen zu den unterstützten Suchabfragen finden Sie unter Suchanfragen.Beispiel: Sie können eine oder mehrere Umfrage-IDs angeben, um nur die ausgewählten Umfragendatensätze mit der folgenden Syntax zu aktualisieren: surveyid:sv_01.
- Geben Sie im Feld Filternamen eingeben den Namen des Filters aus Ihrem Projekt ein, der auf die ausgehenden Daten angewendet werden soll (optional).
- Wählen Sie unter Wählen Sie aus, welche Datensätze Sie abrufen möchten, welche Datensätze extrahiert werden sollen:
- Neue Datensätze laden (Standard). Extrahieren Sie nur die Datensätze, die seit der letzten Ausführung des Ausgangsjobs angelegt wurden.
- Laden Sie neue und aktualisierte Datensätze. Extrahieren Sie die Datensätze, die seit der letzten Ausführung des Ausgangsjobs angelegt oder aktualisiert wurden.
- Aktualisierte Datensätze laden. Extrahieren Sie nur die Datensätze, die seit der letzten Ausführung des Ausgangsjobs aktualisiert wurden.
Tipp: Connector-Jobs für ausgehende Dateien, die auf Neue und aktualisierte Datensätze laden oder Aktualisierte Datensätze laden gesetzt sind, können nur für eine wöchentliche oder monatliche Ausführung eingeplant werden.Achtung: Durch die Ausführung oder erneute Ausführung der Kategorisierung wird ein Datensatz im XM-Discover-System aktualisiert.
- Sie können festlegen, welche Klassifizierungsdaten in die Ausgangsdaten aufgenommen werden sollen (optional). Markieren Sie das Ankreuzfeld Alle Modelle, um die Klassifizierungsdaten für alle im Projekt verfügbaren Modelle einzubeziehen. Markieren Sie nicht das Ankreuzfeld Alle Modelle, wenn Sie nur ausgewählte Modelle einbeziehen möchten. Wenn die Option Alle Modelle nicht ausgewählt ist, können Sie bestimmte Modelle auswählen, die in die ausgehenden Daten aus dem Dropdown-Menü aufgenommen werden sollen.
- Wählen Sie eine der folgenden Optionen aus dem Dropdown-Menü Filter durch Anwendung von Modellregeln aus:
- Ignorieren: Basierend auf den ausgewählten Modellen wird kein Filter angewendet.
- Aktuell klassifiziert: Gibt die Sätze/Dokumente zurück, die von den ausgewählten Modellen während des letzten Klassifizierungslaufs klassifiziert wurden.
- Ever Classified: Gibt die Sätze/Dokumente zurück, die von den ausgewählten Modellen zu einem beliebigen Zeitpunkt klassifiziert wurden.
- Aktivieren Sie das Kontrollkästchen Ob Kategorie-IDs (wahr) anstelle von Kategorienamen (falsch) zurückgegeben werden sollen, um Kategorie-IDs anstelle von Kategorienamen zu verwenden (optional).
- Wählen Sie die Filterergebnisse aus, indem Sie eine Filterabfrage mit allen Blattknotenpfaden anwenden, um dem Export-API-Aufruf mehrere Modelle mit dem Parameter “leaf_only flag” hinzuzufügen (optional).
- Klicken Sie auf Weiter.
Schritt 6: Dateikonfiguration bereitstellen
Wählen Sie auf der Seite Dateikonfiguration bereitstellen den Dateityp aus, der für den Datenexport verwendet werden soll, und zeigen Sie dann je nach ausgewähltem Dateityp auf den Speicherort der Dateien, und geben Sie andere Einstellungen an.
- Wählen Sie im Abschnitt Dateikonfiguration den Dateityp aus den folgenden beiden Optionen aus:
- Textdateien mit Trennzeichen (CSV): Wählen Sie diese Option, um Daten mithilfe von Dateien mit Texttrennzeichen (CSV) zu exportieren.
- JavaScript-Object-Notation-Dateien (JSON): Wählen Sie diese Option, um Daten mithilfe von JavaScript-Object-Notation-Dateien (JSON-Dateien) zu exportieren.
- Wenn Sie die Option Textdateien mit Trennzeichen (CSV) auswählen, wenden Sie die Einstellungsoptionen für diesen Dateityp an.
- Dateikodierung: Wählen Sie das Kodierungssystem aus, das in der Datei verwendet werden soll.
- Trennzeichen: Geben Sie das Zeichen an, durch das Dateneinträge in der Datei getrennt werden sollen. Nur ein Zeichen. Wenn Sie eine CSV-Datei verwenden, ist das Trennzeichen ein Komma.
- Umschließungszeichen: Geben Sie das Zeichen an, das jedes Datenfeld in der Datei einschließen soll. Nur ein Zeichen.
- Keine Umschließung: Aktivieren Sie dieses Kontrollkästchen, wenn Umschließungszeichen optional sind.
- Klicken Sie im Abschnitt Dateispeicherort auf Durchsuchen, um auf den Ordner zu verweisen, in dem die Dateien auf dem SFTP-Server gespeichert werden sollen.
- Wählen Sie im Fenster Dateispeicherort auswählen den Ordner aus, in dem die Dateien gespeichert werden sollen.
Tipp: Klicken Sie auf den Namen des Ordners, um ihn auszuwählen, und klicken Sie dann auf das Ordnersymbol, um den Ordner zu öffnen. - Sobald der Ordner, in dem die Dateien gespeichert sind, ausgewählt ist, klicken Sie auf OK.
- Im Abschnitt Namenskonventionen können Sie folgende Optionen auswählen:
- Geben Sie einen Dateinamen für das Präfix an: Wählen Sie diese Option, um ein Präfix anzugeben, das dem generierten Dateinamen hinzugefügt werden soll. Verwenden Sie diese Option, um benutzerdefinierte Namenskonventionen anzuwenden, um besser zu verstehen, welche Dateien einem bestimmten Job oder einer bestimmten Jobausführung entsprechen.
Tipp: Der Wert darf nicht [ ] \ / enthalten und darf höchstens 100 Zeichen enthalten.
- Geben Sie einen Dateinamen für das Suffix an: Wählen Sie diese Option, um ein Postfix anzugeben, das dem generierten Dateinamen hinzugefügt werden soll. Verwenden Sie diese Option, um benutzerdefinierte Namenskonventionen anzuwenden, um besser zu verstehen, welche Dateien einem bestimmten Job oder einer bestimmten Jobausführung entsprechen.
Tipp: Der Wert darf nicht [ ] \ / enthalten und darf höchstens 100 Zeichen enthalten.
- Geben Sie einen Dateinamen für das Präfix an: Wählen Sie diese Option, um ein Präfix anzugeben, das dem generierten Dateinamen hinzugefügt werden soll. Verwenden Sie diese Option, um benutzerdefinierte Namenskonventionen anzuwenden, um besser zu verstehen, welche Dateien einem bestimmten Job oder einer bestimmten Jobausführung entsprechen.
- Sie können von XM Discover gelieferte Dateien verschlüsseln und einen PGP/GPG-Schlüssel für die Verschlüsselung im PGP/GPG-Schlüsselfeld angeben (optional). Aktivieren Sie das Kontrollkästchen Von XM Discover gelieferte Dateien verschlüsseln, um sicherzustellen, dass Daten sicher aus XM Discover übertragen werden, und stellen Sie einen PGP/GPG-Schlüssel für die Verschlüsselung bereit. Entmarkieren Sie alternativ das Ankreuzfeld Von XM Discover gelieferte Dateien verschlüsseln, wenn keine Verschlüsselung erforderlich ist.
- Klicken Sie auf Weiter.
Schritt 7: Gewünschte Felder zu Dateien zuordnen
Auf der Seite Gewünschte Felder zu Dateien zuordnen können Sie auswählen, welche XM-Discover-Attribute und Klassifizierungsergebnisse in den Export einbezogen werden sollen.
- Klicken Sie in das leere Feld für benutzerdefinierte Felder, und wählen Sie das XM-Discover-Feld aus, das Sie in den Export einbeziehen möchten.
- Wählen Sie im Dropdown-Menü Datentyp das Format aus, in dem die Daten exportiert werden sollen.
- Geben Sie im Feld Attributname den Namen des Felds ein, das in der exportierten Datei verwendet werden soll.
- Klicken Sie auf das Plus-Symbol (+ ), um weitere benutzerdefinierte Felder hinzuzufügen und sie bei Bedarf Feldern in der exportierten Datei zuzuordnen.
- Klicken Sie auf Weiter.
Schritt 8: Filter (optional) und Datensatzlimit angeben
- Auf der Seite Filter angeben können Sie eine Filterbedingung für einen Job definieren, um nur Datensätze zu exportieren, die ihn erfüllen (optional).
Tipp: Weitere Informationen zum Anwenden eines Filters finden Sie unter Connector-Filter. - Sie können im Feld Datensatzlimit angeben ein Datensatzlimit angeben. Alternativ können Sie das Datensatzlimit als Standard Alle beibehalten, wenn alle Datensätze in einem einzigen Push exportiert werden sollen.
Tipp: Das Datensatzlimit ist ein Limit pro Ausführung des Auftrags. Wenn Sie den Wert auf 1.000 setzen, wird der Job nach dem von Ihnen festgelegten Zeitplan ausgeführt und nach dem Export von 1.000 Datensätzen gestoppt. Wenn Sie sie auf “Täglich” setzen, bedeutet dies, dass sie einmal täglich ausgeführt wird und bis zu 1.000 Datensätze für jeden Tag exportiert werden.Tipp: Bei dialogorientierten Daten wird der Grenzwert basierend auf Unterhaltungen und nicht auf Zeilen angewendet.
- Klicken Sie auf Weiter.
Schritt 9: Benachrichtigungskonfiguration (optional)
- Auf der Seite Benachrichtigungskonfiguration können Sie die Benachrichtigungen auswählen, die die Beobachter eines Auftrags erhalten sollen, wenn eines der unten aufgeführten Ereignisse eintritt.
- Nullsätze werden exportiert.
- Es werden aufeinanderfolgende fehlende Werte gefunden.
- Eine Jobausführung schlägt fehl.
- Eine Jobausführung ist teilweise erfolgreich.
- Ein Job endet mit einem Timeout.
- Ein Job schlägt fehl.
Tipp: Sie können eine beliebige Kombination von Benachrichtigungen auswählen oder keine Benachrichtigungen auswählen. In diesem Fall erhalten die Überwachungen eines Jobs keine Benachrichtigungen. Weitere Informationen zu den Benachrichtigungskonfigurationseinstellungen finden Sie unter Jobbenachrichtigungen.Tipp: Die Standardzeitüberschreitung für ausgehende Connector-Jobs für Dateien beträgt 48 Stunden.
- Klicken Sie auf Weiter.
Schritt 10: Zusätzliche Optionen für Job einrichten
- Wählen Sie auf der Seite Zusätzliche Optionen für Job einrichten im Abschnitt Historischen/inkrementellen Job einplanen eine der folgenden Optionen:
- Inkrementelle Läufe einplanen, um einen Zeitplan für inkrementelle Datenexporte einzurichten.
Tipp: Connector-Jobs für ausgehende Dateien, die auf Neue und aktualisierte Datensätze laden oder Aktualisierte Datensätze laden gesetzt sind, können nur für eine wöchentliche oder monatliche Ausführung eingeplant werden.Tipp: Verwenden Sie die Option Auftrag erstellen, aber keine Daten abrufen, wenn Sie den Auftrag und seine Einstellungen validieren möchten, bevor die Daten exportiert werden. Weitere Informationen über das Einplanen von inkrementellen Läufen finden Sie unter Jobeinplanung.
- Einmaliges Pull einrichten, um einen einmaligen Datenexport durchzuführen.
Tipp: Sie können die Einplanungseinstellungen später ändern. Weitere Informationen finden Sie unter Abrufen von Daten für einmalige Läufe und Jobeinplanung für regelmäßige Läufe.
- Inkrementelle Läufe einplanen, um einen Zeitplan für inkrementelle Datenexporte einzurichten.
- Im Abschnitt Zusätzliche inkrementelle Daten können Sie angeben, wie viele zusätzliche Daten (in Tagen oder Stunden) während eines inkrementellen Laufs abgerufen werden sollen, um sicherzustellen, dass alle relevanten historischen Daten für die ausgehende Übertragung verfügbar sind (optional).
Tipp: Der Höchstwert für dieses Feld beträgt 30 Tage.
- Klicken Sie auf Weiter.
Schritt 11: Alle Jobeinstellungen bestätigen
- Auf der Seite Alle Jobeinstellungen bestätigen können Sie eine Zusammenfassung aller Einstellungen für einen Job anzeigen und die Einstellungen bei Bedarf bearbeiten, bevor Sie den Datenexport ausführen. Um den Datenexport auszuführen, wählen Sie Fertigstellen, wenn Sie bereit sind, den Datenexport auszuführen. Es wird eine Bestätigungsmeldung angezeigt, die bestätigt, dass der Job erfolgreich übermittelt wurde.
- Wenn Sie auf Fertig stellen klicken, geschieht Folgendes: Einmalige Exporte werden sofort ausgeführt. Wenn Sie die Option „Job anlegen, aber keine Daten abrufen“ nicht aktiviert haben, werden eingeplante Exporte sofort ausgeführt und dann gemäß dem von Ihnen definierten Zeitplan ausgeführt.
Weitere Informationen zum Überwachen von Jobs finden Sie unter Jobseitenübersicht.
Neue SFTP-Anmeldeinformationen hinzufügen
- Wählen Sie Neu hinzufügen.
- Geben Sie den Namen des neuen Anmeldeinformationssatzes in das Feld Verbindungsname ein.
- Geben Sie den SFTP-Benutzernamen in das Feld SFTP-BENUTZERNAME ein.
- Geben Sie das SFTP-Kennwort in das Feld SFTP-KENNWORT ein.
- Geben Sie die SFTP-Serveradresse in das Feld SFTP-HOST ein.
- Geben Sie den SFTP-Port in das Feld SFTP-PORT ein.
Tipp: Der Standardport ist 22.
- Sie können festlegen, dass Ihre Anmeldeinformationen nach einem bestimmten Zeitraum ablaufen (optional). Um ein Ablaufdatum für diese Anmeldeinformationen zu definieren und eine Erinnerung für alle Job-Beobachter festzulegen, markieren Sie das Ankreuzfeld Ablaufbenachrichtigungen senden. Dadurch wird das Feld Tage vor Ablauf aktiviert.
- Geben Sie einen Wert in das Feld Tage vor Ablauf ein, um festzulegen, wie viele Tage vor dem Ablauf die Benachrichtigungen beginnen sollen. Mögliche Werte liegen zwischen 1 und 100 Tagen.
Tipp: Diese Erinnerung wird jedes Mal ausgelöst, wenn der Auftrag ausgeführt wird, sobald das Ablaufdatum kleiner als die im Feld Tage vor Ablauf festgelegte Anzahl von Tagen ist.
- Wählen Sie das Ablaufdatum aus der Kalenderdatumsauswahl aus. Das Ablaufdatum wird dann dem Feld Ablaufdatum hinzugefügt.