Web-Service

Informationen zu Webdiensten

Manchmal möchten Sie komplexere Funktionen in Ihre Umfrage einbeziehen. Vielleicht möchten Sie die Top-10-Schlagzeilen von einer Nachrichtenwebsite in Ihre Umfrage ziehen oder eine zweite Umfrage automatisieren, die genau zwei Stunden später per E-Mail an die Umfrageteilnehmer einer ersten Umfrage gesendet wird. A Web-Service ermöglicht es Ihnen, dies zu tun, indem Sie Anfragen an eine bestimmte URL stellen.

Web-Service hinzufügen

1. Klicken Sie beim Bearbeiten Ihrer Umfrage in der linken Navigationsleiste auf das Symbol Umfragenverlauf.
   
2. Klicken Sie auf Unterhalb hinzufügen oder Neues Element hier hinzufügen.
   
3. Auswählen Web-Service.
4. In der URL die URL Ihres externen Web-Service ein.
   
   Tipp: Sie können Folgendes verwenden: dynamischer Text um Umfrage an Ihre URL über Abfragezeichenfolgen.
5. Wählen Sie eine Methode für Ihren Web-Service. Weitere Informationen zu den verschiedenen Methoden finden Sie im folgenden Abschnitt.

Methoden

Mit unserer Funktion können Sie aus einer Reihe von Methoden , um Informationen von der von Ihnen angegebenen URL anzufordern.

Wenn Sie unsere API verwenden, Dokumentation zeigt Ihnen, welche Methode Sie verwenden sollen, wie im Screenshot unten angegeben.

Parameter

Derzeit gibt es 3 Arten von Parameter können Sie an Ihre Anforderung anhängen.

1. Abfrageparameter: Anstatt eine Query-String Fügen Sie am Ende Ihrer URL Ihre Abfrageparameter hier ein.
2. Textparameter: Dieser Parameter ist für GET- oder DELETE-Anforderungen nicht verfügbar. Es wird mit zwei Formatierungsoptionen ausgeliefert:
   a) application/x-www-form-urlencoded: Anstatt Ihre Textparameter in den angegebenen Bereich des Web-Service einzugeben, fügen Sie sie als Query-String am Ende der von Ihnen angegebenen URL.
   b) application/json: Geben Sie Ihre Schlüssel in Punktnotation ein. In unserem API werden Sie beispielsweise aufgefordert, einen Header [fromEmail] anzugeben. In der Punktnotation wird dies zu header.fromEmail.
   Achtung: Jeder Schlüssel und Wert in einem JSON sowie jedes Element in einem JSON (einschließlich dynamischer Text) muss doppelte Anführungszeichen enthalten.
3. Benutzerdefinierte Kopfzeile: URL hier einfügen.
   Tipp: Authentifizierungs-URLs sollten dem benutzerdefinierten Header hinzugefügt werden.

Wenn Sie unsere API verwenden, Dokumentation gibt an, welche Art von Parametern enthalten sein sollen. Das folgende Beispiel stellt zu setzende Body-Parameter bereit.

Parameter zu Ihrem Web-Service hinzufügen

1. Wählen Sie eine der drei Fügen Sie einen Parameter hinzu, der an den Webdienst gesendet werden soll. Optionen, die im vorherigen Abschnitt angegeben sind. Im obigen Beispiel werden die Abfrageparameter angegeben.
2. Geben Sie den Namen des Parameters in das Feld Parameter zu Web-Service auf der linken Seite.
3. Geben Sie den entsprechenden Wert des Parameters in das Feld Wert auf der rechten Seite.
4. Klicken Sie auf das Pluszeichen (+) rechts neben dem Parameter, um einen weiteren hinzuzufügen.
5. Klicken Sie auf Übernehmen wenn Sie fertig sind.

Testen Ihrer Parameter

Nachdem Sie Ihre URL eingefügt und Ihre Parameter eingerichtet haben, können Sie Ihre URL testen, um zu sehen, welche Felder Sie abrufen können.

1. Klicken Sie auf URL um zu sehen, welche Informationen Sie aus dem externen Web-Service abrufen können.
   
2. Wählen Sie alle Felder aus, die Sie in Ihrer Umfrage verwenden oder aufzeichnen möchten. Der Feldname wird auf der linken Seite angezeigt, und ein entsprechender Beispielwert wird auf der rechten Seite angezeigt.
   
3. Klicken Sie auf Eingebettete Daten hinzufügen um ausgewählte Felder zu Ihren Daten hinzuzufügen.
   Tipp: Sie können die eingebettete Daten ändern, die mit den Feldern Ihres Webdienstes verknüpft sind, unter Eingebettete Daten festlegen Spalte. Die eingebettete Daten befinden sich links von den Gleichheitszeichen (=)-Zeichen, gekennzeichnet durch ein grünes ED Symbol. Die rechte Seite sollte nicht geändert werden. Die Namen, die Sie auf der linken Seite festlegen, sind die Namen der Felder, wie sie in Ihren Daten angezeigt werden.
4. Wenn Sie Feuer und Vergessen, Sie sichern keine der vom Web-Service-Aufruf zurückgegebenen Daten. Diese Funktion ist nützlich, wenn Sie die zurückgegebenen Daten nicht sichern müssen.
   
   Tipp: Mit Feuer und Vergessen können Sie in Ihrer Umfrage eine Anfrage an einen Webdienst stellen, ohne auf eine Antwort warten zu müssen. Das bedeutet, dass Ihre Umfrageteilnehmer die vollständige Umfrage aufgrund des Webdiensts ohne Verzögerung abschließen können. Sie können diese Option verwenden, wenn die Verarbeitung einer Webdienstanforderung einige Zeit in Anspruch nimmt. Wir empfehlen jedoch, diese Funktion nur während des Tests zu verwenden, da sie das Speichern eingebettete Daten verhindert.
5. Wenn Sie fertig sind, klicken Sie auf Übernehmen.

Korrektur von TLS

Ab dem 1. September 2021 schlagen Web-Service-Anforderungen mit Transport-Layer-Security-Fehlern (TLS) fehl. TLS macht Web-Requests über HTTPS (im Gegensatz zu Plain HTTP) sicher, verhindert, dass die Anforderungsdaten für Dritte sichtbar sind, und stellt sicher, dass die Anforderung an das richtige Ziel gesendet wird. Das Ignorieren von TLS beseitigt diese vorteile effektiv. Diese Änderung ist ein wichtiger Schritt in unseren kontinuierlichen Bemühungen, die Sicherheit der Qualtrics zu verbessern.

Um jeden TLS zu beheben, müssen Sie einen der folgenden Schritte ausführen:

• Beheben Sie den TLS. Aufgrund der Art der TLS kann unser Support-Team keine spezifische Anleitung dazu bereitstellen, aber Ihr Netzwerkadministrator weiß, wie der Fehler zu beheben ist.
• Ändern Sie die Webdienstanforderung des Flow-Elements so, dass sie über HTTP und nicht über HTTPS erfolgt. Sie können beispielsweise die URL „https://example.com“ in „http://example.com“ ändern. Wenn Sie sich für diesen Ansatz entscheiden, sollten Sie auch sicherstellen, dass die URL nicht zur URL umgeleitet wird.
  Achtung: Beachten Sie, dass diese Vorgehensweise dazu führt, dass die Web-Service-Anforderungsdaten unverschlüsselt übertragen werden.

Sie können überprüfen, ob Ihr Web-Service-Element für diese Änderung bereit ist, indem Sie die Test-Button weiter dem URL im Ablaufelement. Beim Anzeigen der Rohdaten im resultierenden Fenster, auch unten angezeigt, sollte kein Fehler angezeigt werden.

Arten von Projekten, in denen diese Funktion verfügbar ist

Solange Sie im Rahmen Ihrer Lizenz Zugriff auf Webdienste haben, können Sie jedem Umfragenverlauf jeder Art von Projekt einen Webdienst hinzufügen. Dazu gehören:

• Umfrageprojekte
• Engagement
• 360
• Lebenszyklus
• Ad-hoc-Mitarbeiterforschung
• Puls
• XM Solutions
• Conjoints
• MaxDiff