zum Hauptinhalt springen
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Web-Service


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Webdienste

Manchmal möchten Sie komplexere Funktionen in Ihre Umfrage aufnehmen. Vielleicht möchten Sie die Top-10-Schlagzeilen von einer Nachrichten-Website in Ihre Umfrage ziehen, oder Sie möchten eine zweite Umfrageverteilung automatisieren, die genau 2 Stunden später per E-Mail an die Teilnehmer einer ersten Umfrage gesendet wird. Mit einem Webdienst können Sie genau dies tun, indem Sie Anfragen an eine bestimmte URL stellen.

Tipp: Diese Seite enthält Verweise auf die Qualtrics-API, bei der es sich um eine Funktion handelt, für die eine spezielle Zugriffsberechtigung erforderlich ist. Wenn Sie Zugriff auf diese Funktion erhalten möchten, wenden Sie sich an Ihren Administrator, um weitere Informationen zu erhalten.
Achtung: Das Einrichten eines Webdienstes erfordert häufig fortgeschrittene Programmierkenntnisse. Unser Supportteam hilft zwar gerne bei den Grundlagen der Bereitstellung von Informationen in den Web-Service, aber wir können keine Unterstützung in Bezug auf die Programmieraspekte leisten. Stattdessen können Sie sich gerne in unserer Benutzer-Community erkundigen.

Webdienst hinzufügen

  1. Klicken Sie beim Bearbeiten Ihrer Umfrage in der linken Navigationsleiste auf das Symbol Umfragenverlauf.
    Navigation zum Umfragenverlauf durch Klick auf das Symbol für den Umfragenverlauf in der linken Navigationsleiste
  2. Klicken Sie auf Unterhalb hinzufügen oder Neues Element hier hinzufügen.
    Drucktasten Unten hinzufügen und Neues Element hier hinzufügen; Webdienstoption unter Was möchten Sie hinzufügen? Menü
  3. Wählen Sie Webdienst.
  4. Fügen Sie im Feld URL die URL Ihres externen Webdienstes ein.
    Feld für URL in einem Web-Service gefolgt von der Methode

    Tipp: Sie können dynamischen Text verwenden, um Umfrageinformationen über Abfragezeichenfolgen an Ihre Endpunkt-URL zu übergeben.
  5. Wählen Sie eine Methode für Ihren Web-Service aus. Weitere Informationen zu den verschiedenen Methoden finden Sie im folgenden Abschnitt.

Methoden

Mit unserer Webdienstfunktion können Sie aus einer Reihe von Methoden auswählen, um Informationen von Ihrer angegebenen URL anzufordern.

Methodentyp Aktion Beispiel
GET Der Web-Service navigiert zur URL und ruft Informationen ab. Rufen Sie Informationen über ein Mitglied Ihrer Kontaktliste ab. Weitere Details finden Sie im Aufruf der API zum Abrufen von Kontakten.
POST Navigieren Sie zur URL, und sichern Sie die Informationen dort. Legen Sie eine Bibliotheksnachricht an.
PUT Aktualisieren oder ersetzen Sie vorhandene Informationen. Ändern Sie einen Benutzernamen. Dies ist einer der Dinge, die Sie mit dem Aufruf Benutzer aktualisieren tun können.
PATCH Aktualisieren oder ersetzen Sie vorhandene Informationen. Sehr ähnlich wie PUT. Während unser Web-Service diese Methode anbietet, verwendet unser API keine PATCH-Aufrufe. Ändern Sie die auf Ihrem Server gespeicherten Daten.
LÖSCHEN Entfernen Sie die Informationen. Löschen Sie eine Grafik aus Ihrer Bibliothek.

 

Wenn Sie unsere API-Aufrufe verwenden, erfahren Sie in der Dokumentation, welche Methode verwendet werden soll, wie im Screenshot unten angegeben.

Methode, die neben jedem Aufruf in der API-Dokumentation aufgeführt ist

Parameter

Derzeit gibt es drei Arten von Parametern, die Sie an Ihre Anforderung anhängen können.

Ein Webdienst mit folgenden Hervorhebungen: Abfrageparameter hinzufügen, Textparameter hinzufügen und Benutzerdefinierten Kopf hinzufügen

  1. Query-Parameter: Anstatt einen Query-String am Ende Ihrer Web-Service-URL hinzuzufügen, platzieren Sie hier Ihre Query-Parameter.
  2. Body-Parameter: Dieser Parameter ist für GET- oder DELETE-Requests nicht verfügbar. Es enthält 2 Formatierungsoptionen:
    a) application/x-www-form-urlencoded: Anstatt Ihre Body-Parameter in den angegebenen Bereich des Web-Service einzugeben, fügen Sie sie als Abfragezeichenfolge am Ende Ihrer angegebenen URL hinzu.
    b) application/json: Geben Sie Ihre Schlüssel in Dot Notation ein. Unser API-Aufruf fordert Sie beispielsweise auf, einen Header[fromEmail] anzugeben. In der Punktnotierung wird dies zu header.fromEmail.

    Achtung: Jeder Schlüssel und Wert in einem JSON-Objekt sowie jedes Element in einem JSON-Array (einschließlich dynamischem Text) müssen doppelte Anführungszeichen enthalten. In einem Hauptparameter müssen jeder Schlüssel und Wert in einem JSON-Objekt sowie jedes Element in einem JSON-Array doppelte Anführungszeichen enthalten.
  3. Benutzerdefinierter Header: Fügen Sie hier URL-Header ein.
    Tipp: Authentifizierungs-URLs sollten dem benutzerdefinierten Header hinzugefügt werden.

Wenn Sie unsere API-Aufrufe verwenden, erfahren Sie in der Dokumentation, welche Art von Parametern enthalten sein sollen. Das folgende Beispiel stellt Parameter für den Textkörper bereit, die festgelegt werden müssen.

In der API-Dokumentation wird ein Pfeil angezeigt, der auf Textparameter hinweist.

Hinzufügen von Parametern zu Ihrem Web-Service

In einem Web-Service ausgefüllte Textparameter

  1. Wählen Sie eine der im vorherigen Abschnitt angegebenen 3 Parameter zum Senden an Webservice hinzufügen aus. Im obigen Beispiel geben wir die Abfrageparameter an.
  2. Geben Sie den Namen des Parameters in das Feld Parameter für Webdienst auf der linken Seite ein.
  3. Geben Sie den entsprechenden Wert des Parameters in das Feld Wert auf der rechten Seite ein.
  4. Klicken Sie auf das Pluszeichen (+) rechts neben dem Parameter, um einen weiteren hinzuzufügen.
  5. Klicken Sie auf Anwenden, wenn Sie fertig sind.

Testen der Parameter

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

  1. Klicken Sie auf Test-URL, um zu sehen, welche Informationen Sie aus dem externen Webdienst abrufen können.
    Drucktaste URL testen neben dem URL-Feld
  2. Wählen Sie alle Felder aus, die Sie in Ihrer Umfrage verwenden oder aufzeichnen möchten. Der Feldname wird auf der linken Seite und ein entsprechender Beispielwert auf der rechten Seite angezeigt.
    Felder auswählen, die über die URL erfasst werden sollen
  3. Klicken Sie auf Eingebettete Daten hinzufügen, um Ihren Daten ausgewählte Felder hinzuzufügen.
    Tipp: Sie können die eingebetteten Datennamen, die mit den Feldern Ihres Webdienstes verknüpft sind, in der Spalte Eingebettete Daten festlegen ändern. Die eingebetteten Datennamen befinden sich links vom Gleichheitszeichen (=), gekennzeichnet durch ein grünes ED -Symbol. Die rechte Seite sollte nicht geändert werden. Die Namen, die Sie auf der linken Seite festlegen, entsprechen den Namen der Felder, wie sie in Ihren Daten angezeigt werden.
  4. Wenn Sie Fire und Forget auswählen, werden die vom Web-Service-Aufruf zurückgegebenen Daten nicht gesichert. Diese Funktion ist nützlich, wenn Sie die zurückgegebenen Daten nicht sichern müssen.
    Option "Feuer" und "Vergessen" über Feldern; unten rechts anwenden

    Tipp: Mit Fire and Forget kann Ihre Umfrage eine Anfrage an einen Webservice stellen, ohne auf eine Antwort zu warten. Das bedeutet, dass Ihre Teilnehmer aufgrund des Webdienstes die vollständige Umfrage ohne Verzögerung abschließen können. Sie können diese Option verwenden, wenn Sie eine Webdienstanforderung haben, deren Verarbeitung einige Zeit in Anspruch nimmt. Wir empfehlen jedoch, diese Funktion nur während des Testens zu verwenden, da sonst eingebettete Daten nicht gespeichert werden können.
  5. Wenn Sie fertig sind, klicken Sie auf Anwenden.

Korrektur von TLS-Fehlern

Ab dem 1. September 2021 schlagen Webserviceanforderungen mit Transport-Layer-Security-Fehlern (TLS-Fehlern) fehl. TLS macht Webanforderungen ü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. Durch das Ignorieren von TLS-Fehlern werden diese Sicherheitsvorteile effektiv eliminiert. Diese Änderung ist ein wichtiger Schritt in unseren kontinuierlichen Bemühungen, die Sicherheit der Qualtrics-Plattform zu verbessern.

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

  • Beheben Sie den TLS-Fehler. Aufgrund der Art der TLS-Fehler kann unser Supportteam keine spezifische Anleitung dazu bereitstellen, aber Ihr Netzwerkadministrator weiß, wie der Fehler behoben werden kann.
  • Ändern Sie die Flow-Element-Webdienstanforderung, die über HTTP und nicht über HTTPS erfolgen soll. 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 HTTP-URL nicht auf die HTTPS-URL umleitet.
    Achtung: Beachten Sie, dass bei diesem Ansatz die Webdienst-Anforderungsdaten unverschlüsselt übertragen werden.

Sie können überprüfen, ob Ihr Web-Service-Element für diese Änderung bereit ist, indem Sie die Testdrucktaste neben dem URL-Feld im Flow-Element verwenden. Beim Anzeigen der Rohdaten im resultierenden Fenster (siehe auch unten) sollte kein Fehler angezeigt werden.

Dialogfenster, das über den Umfragenverlauf geöffnet wird und besagt Felder auswählen, die als eingebettete Daten aufgenommen werden Der Webdienst hat keine Felder zurückgegeben. Klicken Sie hier, um die Rohdaten anzuzeigen. In der linken unteren Ecke des Dialogfensters befindet sich die Drucktaste Rohdaten anzeigen.

Achtung: Wenn Sie das Webservice-Element aktualisieren, um den Fehler zu beheben, müssen Sie auch Ihre Änderungen an der Umfrage veröffentlichen. Wir empfehlen Ihnen, die Fehler so schnell wie möglich zu beheben, um zu vermeiden, dass nach Ablauf der Frist in Bearbeitung befindliche Umfragensitzungen mit der alten Umfrageversion verwendet werden. Wenn Sie den Fehler stattdessen über eine andere Methode beheben (z.B. durch Korrektur der TLS-Konfiguration auf dem Server, auf den Ihr Web-Service-Element abzielt), ist eine Veröffentlichung nicht erforderlich.

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

Solange Sie im Rahmen Ihrer Lizenz Zugriff auf Webdienste haben, können Sie dem Umfragenverlauf eines beliebigen Projekts einen Webdienst hinzufügen. Dazu gehören:

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.