Qualtrics Outbound Connector

Informationen zum Qualtrics Outbound Connector

Sie können den Ausgangskonnektor von Qualtrics verwenden, um die unten aufgeführten Aufgaben auszuführen.

• Aktualisieren Sie vorhandene Qualtrics-Umfragen mit XM-Discover-Anreicherungen.
• Senden Sie XM Discover-Exportdaten über ein JSON-Ereignis an Qualtrics, um einen Qualtrics-Workflow auszulösen.

Wenden Sie sich an Ihr Qualtrics-Kontenteam, wenn Sie zusätzliche Hilfestellung benötigen.

VOR IHNEN BEGINN

Voraussetzungen:

Bevor Sie einen Job mit dem ausgehenden Qualtrics-Connector konfigurieren, stellen Sie sicher, dass die unten aufgeführten Bedingungen erfüllt sind.

• Datenfelder für XM-Discover-Anreicherungen müssen Teil des Qualtrics-Umfragedatensatzes sein.
  Tipp: Weitere Informationen zum Hinzufügen von Datenfeldern für XM-Discover-Anreicherungen zu Ihren Umfragen finden Sie unter Eingebettete Daten.
• Dokumente in XM Discover müssen ein Datenfeld mit Umfrage-IDs enthalten, wenn Sie den Umfrage-Outbound-Konnektortyp verwenden.

Erforderliche Anmeldeinformationen:

Sie benötigen die folgenden Informationen zu Ihren Qualtrics- und XM-Discover-Konten:

• Ihre Qualtrics-Instanzadresse.
• Ihr Qualtrics-API-Token.
• Ihr XM Discover Export API-Endpunkt.

EINSTELLUNG DER VERBINDUNG

1. Melden Sie sich bei Connectors an.
2. Klicken Sie oben rechts auf der Seite Jobs auf die Schaltfläche Neuer Job.
3. Wechseln Sie auf der Seite Connectors zum Abschnitt SELECT A SOURCE.
4. Klicken Sie auf die Schaltfläche Ausgehend von Qualtrics.

Konfigurieren eines ausgehenden Qualtrics-Connector-Auftrags

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: Qualtrics-Datentyp auswählen
• Schritt 4: Qualtrics-Anmeldedaten angeben
• Schritt 5: Anmeldeinformationen für XM Discover Export einrichten
• Schritt 6: Abfragekonfiguration
• Schritt 7: Umfrage für Konfiguration auswählen (nur für Datentyp SURVEY) -OR- JSON-Ereignisendpunkt angeben (nur für JSON-EVENTdatentyp)
• Schritt 8: Ausgangsabfragekonfiguration
• Schritt 9: Gewünschte Felder Qualtrics zuordnen
• Schritt 10: Filter (optional) und Datensatzlimit angeben
• Schritt 11: Benachrichtigungskonfiguration (optional)
• Schritt 12: Zusätzliche Optionen für Job einrichten
• Schritt 13: Alle Jobeinstellungen bestätigen

Schritt 1: Jobnamen angeben

1. Geben Sie oben links auf der Seite im Feld Jobname einen erkennbaren Jobnamen ein.
   Achtung: Der Name, den Sie in das Feld Jobname eingeben, wird allen Dokumenten hinzugefügt, die über diesen Job als fest programmierter Wert für das Attribut job_name hochgeladen werden.
   Tipp: Sie können den Jobnamen während der Einrichtung über das Feld Auftragsname ändern, das während der Einrichtung oben auf jeder Seite angezeigt wird.
2. Klicken Sie auf Weiter.

Schritt 2: Projekt und Beschreibung angeben

1. Wählen Sie auf der Seite Projekt und Beschreibung angeben ein Projekt aus, aus dem Sie Daten aus dem Dropdown-Menü Projekte hochladen möchten.
   Tipp: Sie haben die Möglichkeit, im Feld Stellenbeschreibung eine Notiz zum Job einzugeben. Die Stellenbeschreibung, die Sie im Feld Stellenbeschreibung eingeben, kann nur in der Liste Konnektoren aufgerufen werden und wird nicht als Teil der Daten für eine Stelle hochgeladen.
2. Klicken Sie auf Weiter.

Schritt 3: Qualtrics-Datentyp auswählen

1. Wählen Sie auf der Seite Qualtrics-Datentyp auswähleneinen der folgenden Datentypen zum Hochladen aus.
   • Umfrage: Wählen Sie diesen Datentyp aus, um vorhandene Qualtrics-Umfragen mit XM-Discover-Anreicherungen zu aktualisieren.
   • JSON-Ereignis: Wählen Sie diesen Datentyp aus, um XM-Discover-Exportdaten über ein JSON-Ereignis an Qualtrics zu senden, um eine xFlow-Automatisierungsaufgabe mithilfe von XM-Discover-Anreicherungen aus einer beliebigen Datenquelle auszulösen.
     Tipp: Weitere Informationen finden Sie unter JSON-Ereignis.
2. Klicken Sie auf Weiter.

Schritt 4: Qualtrics-Anmeldedaten angeben

Auf der Seite Qualtrics-Anmeldeinformationen angeben können Sie einen vorhandenen Satz von Anmeldeinformationen aus dem Dropdown-Menü auswählen oder einen neuen Satz Anmeldeinformationen hinzufügen.

1. Um einen neuen Satz Anmeldeinformationen hinzuzufügen, wählen Sie im Dropdown-Menü mit den Anmeldeinformationen die Option Neu hinzufügen aus, und geben Sie die in der folgenden Tabelle aufgeführten Verbindungsparameter in die entsprechenden Felder ein.
2. Geben Sie den Namen des neuen Anmeldeinformationssatzes in das Feld Verbindungsname ein.
3. Geben Sie das API-Token, das mit Ihrem Qualtrics-Konto verbunden ist, im Feld QUALTRICS OUTBOUND API TOKEN an.
4. Geben Sie die Adresse der Qualtrics-Instanz in das Feld QUALTRICS OUTBOUND DATACENTER ID ein.
5. Sie können festlegen, dass Ihre Anmeldeinformationen nach einem bestimmten Zeitraum ablaufen (optional).
6. Um ein Ablaufdatum für diesen Anmeldeinformationssatz zu definieren und eine Erinnerung für alle Jobbeobachter festzulegen, aktivieren Sie das Kontrollkästchen Ablaufbenachrichtigungen senden. Dadurch wird das Feld Tage vor Ablauf aktiviert.
7. 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.
8. Wählen Sie das Ablaufdatum aus der Kalenderdatumsauswahl aus. Das Ablaufdatum wird dann dem Feld Ablaufdatum hinzugefügt.
9. Klicken Sie auf Weiter.

Schritt 5: Anmeldeinformationen für XM Discover Export einrichten

1. Geben Sie auf der Seite XM Discover Export Credentials einrichten Ihren XM Discover Export API-Endpunkt im Feld HOST an.
2. Klicken Sie auf Weiter.

Schritt 6: Abfragekonfiguration

Auf der Seite Abfragekonfiguration können Sie angeben, welche Daten zum Aktualisieren von Qualtrics-Umfragen (wenn Sie UMFRAGE als Datentyp ausgewählt haben) oder über ein JSON-Ereignis an Qualtrics gesendet werden sollen (wenn Sie JSON EVENT als Datentyp ausgewählt haben).

1. 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 Daten auf Satzebene.
   • Dokumente: Verwenden Sie Daten auf Belegebene.
2. Geben Sie eine Abfrage zum Filtern der Ausgangsdaten im Feld Abfrage eingebenein (optional). Verwenden Sie dieselbe Syntax wie zum Suchen von Daten in Designer.
   Beispiel: Sie können eine oder mehrere Survey-IDs angeben, um nur die ausgewählten Survey-Datensätze mit folgender Syntax zu aktualisieren:surveyid:sv_01
3. Geben Sie im Feld Filternamen eingeben den Namen des Filters aus Ihrem Projekt ein, der auf die ausgehenden Daten angewendet werden soll (optional).
4. Um die Datensätze zu aktualisieren, die seit der letzten Ausführung des Ausgangsjobs angelegt wurden, wählen Sie Standard: Neue Datensätze laden unter Wählen Sie aus, welche Datensätze Sie abrufen möchten. Um die Datensätze zu aktualisieren, die seit der letzten Ausführung des Ausgangsjobs angelegt oder aktualisiert wurden, wählen Sie Neue und aktualisierte Datensätze laden. Um nur die Datensätze zu aktualisieren, die seit der letzten Ausführung des Ausgangsjobs aktualisiert wurden, wählen Sie Aktualisierte Datensätze laden.
   Tipp: Durch das Ausführen oder erneute Ausführen der Kategorisierung wird ein Datensatz im XM Discover-System aktualisiert.
5. 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.
6. 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.
7. 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).
8. 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).
9. Wählen Sie Leere Werte ignorieren, wenn die Verbindung die Aktualisierung eines Umfragedokuments überspringen soll, wenn alle zugehörigen Ausgangswerte leer sind (optional).
10. Klicken Sie auf Weiter.

Schritt 7: Umfrage für Konfiguration auswählen -OR- JSON-Ereignisendpunkt angeben

UMFRAGE FÜR KONFIGURATION AUSWÄHLEN

1. Wählen Sie eine der verfügbaren Qualtrics-Umfragen zum Aktualisieren aus.
   Tipp: Wenn die gesuchte Umfrage nicht angezeigt wird, stellen Sie sicher, dass sie mit dem Konto geteilt wird, das den API-Schlüssel aus der Qualtrics-Umgebung generiert hat.
2. Klicken Sie auf Weiter.

SPEZIFIEREN SIE DAS JSON EVENT ENDPOINT

1. Geben Sie die JSON-Ereignisendpunkt-URL an, um XM-Discover-Exportdaten über ein JSON-Ereignis an Qualtrics zu senden.
2. Tipp: Weitere Informationen zum Einrichten eines JSON-Ereignisses finden Sie unter JSON-Ereignis.
3. Klicken Sie auf Weiter.

Schritt 8: Ausgangsabfragekonfiguration

1. Wählen Sie das Attribut aus dem XM-Discover-Projekt aus, in dem die Qualtrics-Umfrage-ID gespeichert wird.
   Tipp: Nur Dokumente mit Umfrage-ID, die mit der im vorherigen Schritt ausgewählten Umfrage übereinstimmen, werden aktualisiert.
2. Klicken Sie auf Weiter.

Schritt 9: Gewünschte Felder XM Discover zuordnen

Auf der Seite Gewünschte Felder zu XM Discover zuordnen können Sie XM-Discover-Attribute und Klassifizierungsergebnisse eingebetteten Datenfeldern zuordnen, die in Qualtrics definiert sind.

1. Klicken Sie in das leere Feld für benutzerdefinierte Felder, und wählen Sie das XM-Discover-Feld aus, das Sie einer Umfrage in Qualtrics hinzufügen möchten.
2. Wählen Sie den Datentyp eines entsprechenden eingebetteten Felds, das in XM Engage angelegt wurde, aus dem Dropdown-Menü Datentyp aus.
3. Geben Sie den Namen des eingebetteten Felds in XM Engage, das mit den Werten des ausgewählten XM-Discover-Felds gefüllt werden soll, in das Feld Attributname ein.
4. Klicken Sie auf das Plus-Symbol (+), um weitere benutzerdefinierte Felder hinzuzufügen und sie bei Bedarf eingebetteten Qualtrics-Feldern zuzuordnen.
5. Klicken Sie auf Weiter.

Schritt 10: Filter (optional) und Datensatzlimit angeben

1. Auf der Seite Filter angeben können Sie eine Filterbedingung für einen Job definieren, um nur Datensätze zu laden, die ihn erfüllen (optional).
   Tipp: Weitere Informationen zum Anwenden eines Filters finden Sie unter Connector-Filter.
2. Sie können im Feld Datensatzlimit angeben ein Datensatzlimit angeben. Alternativ können Sie das Datensatzlimit als Standard Alle belassen, wenn Sie möchten, dass alle Datensätze in einem einzigen Push zurückgegeben werden.
   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 Abrufen von 1.000 Datensätzen gestoppt. Wenn Sie sie auf “Täglich” setzen, bedeutet dies, dass sie einmal pro Tag ausgeführt wird und Sie bis zu 1.000 Datensätze für jeden Tag erhalten.
   Tipp: Bei dialogorientierten Daten wird der Grenzwert basierend auf Unterhaltungen und nicht auf Zeilen angewendet.
3. Klicken Sie auf Weiter.

Schritt 11: Benachrichtigungskonfiguration (optional)

1. 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.
   • Es werden keine Datensätze in das Projekt geladen.
   • 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.
     Tipp: Weitere Informationen zu Benachrichtigungskonfigurationseinstellungen finden Sie unter Jobbenachrichtigungen.
2. Klicken Sie auf Weiter.

Schritt 12: Zusätzliche Optionen für Job einrichten

1. 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 Datenabrufe einzurichten.
     Tipp: Verwenden Sie die Option Auftrag erstellen, aber keine Daten abrufen, wenn Sie den Auftrag und seine Einstellungen validieren möchten, bevor die Daten aktualisiert werden. Weitere Informationen über das Einplanen von inkrementellen Läufen finden Sie unter Jobeinplanung.
   • Einmaliges Pull einrichten, um einen einmaligen Daten-Pull durchzuführen.
     Tipp: Sie können die Einplanungseinstellungen später ändern. Weitere Informationen zu einmaligen Läufen finden Sie unter Abrufen von Daten und Jobeinplanung für weitere Informationen zu regelmäßigen Läufen.
2. 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.
3. Klicken Sie auf Weiter.

Schritt 13: Alle Jobeinstellungen bestätigen

1. 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 Daten-Upload ausführen. Um den Daten-Upload auszuführen, wählen Sie Fertigstellen, wenn Sie bereit sind, den Daten-Upload auszuführen. Es wird eine Bestätigungsmeldung angezeigt, die bestätigt, dass der Job erfolgreich übermittelt wurde.
2. Wenn Sie auf Fertig stellen klicken, geschieht Folgendes: Einmalige Pulls werden sofort ausgeführt. Wenn Sie die Option „Job anlegen, aber keine Daten abrufen“ nicht aktiviert haben, werden eingeplante Pulls sofort ausgeführt und dann auf „Ausführung gemäß Zeitplan“ gesetzt.

Weitere Informationen zum Überwachen von Jobs finden Sie unter Jobseitenübersicht.