Code-Aufgabe

Informationen zu Codeaufgaben

Achtung: Der Zugriff auf und die weitere Verwendung dieser Funktion erfordert möglicherweise ein Upgrade Ihrer Lizenz. Kontakt Ihr Qualtrics Benutzerkonto für weitere Informationen.

Mit der Aufgabe können Sie benutzerdefiniertes JavaScript verwenden, um Datenmanipulationen, Formatierungen und Berechnungsvorgänge vor oder nach anderen Aufgaben in einem Workflow durchzuführen. Sie können die Aufgabe beispielsweise verwenden, um die Rückgabeausgabe eines API in ein benutzerfreundlicheres Ergebnis umzuwandeln (z.B. müssen Sie das Ergebnis an Ihren nicht technischen Manager:in kommunizieren). Anschließend können Sie das transformierte Ergebnis in eine E-Mail-Aufgabe die eine E-Mail an Ihren Manager:in sendet.

Achtung: Kundeneigene Quelltextfunktionen werden unverändert bereitgestellt und erfordern Programmierkenntnisse zur Implementierung. Der Qualtrics Support bietet keinerlei Hilfestellung oder Beratung im Zusammenhang mit eigenem Programmcode an. Stattdessen können Sie sich gerne in unserer engagierte Benutzer-Community erkundigen. Wenn Sie mehr über unsere Services für kundenspezifisches Coding erfahren möchten, Kontakt Ihren Qualtrics Benutzerkonto Executive.

Code-Aufgaben einrichten

Navigieren Sie zu eigenständig Workflows Seite oder Workflows Registerkarte einer Umfrage.

---

×

close

Klicken Sie auf Workflow anlegen .

Auswählen Wird gestartet, wenn ein Ereignis empfangen wird.

Wählen Sie das Ereignis aus, mit dem der Workflow beginnt. In der Regel handelt es sich um ein Ereignis, bei dem Umfragen beantwortet werden.

---

×

close

Falls gewünscht, klicken Sie auf das Pluszeichen ( + ) und wählen Sie Bedingung hinzufügen, um Ihrem Workflow Bedingungen hinzuzufügen. Mithilfe von Bedingungen können Sie ermitteln, wann ein Workflow ausgelöst wird. Weitere Informationen zu den Gebäudebedingungen finden Sie auf der verlinkten Seite.

---

×

close

Klicken Sie auf das Pluszeichen ( +) und wählen Sie eine Aufgabe hinzufügen.

---

×

close

Wählen Sie Code Aufgabe.

---

×

close

Geben Sie Ihren JavaScript-Ausdruck in das Feld ein. Weitere Informationen finden Sie im Abschnitt unter. Best Practices für hilfreiche Informationen beim Schreiben Ihres Codes.

---

×

close

TIPP: Der Code-Editor speichert einen Änderungsverlauf, so dass Sie Code-Änderungen durch Drücken von CTRL + Z (PC) oder CMD + Z (Mac) rückgängig machen können. Verwenden Sie SHIFT + CTRL + Y (PC) oder SHIFT + CMD + Y (Mac), um eine Änderung zu wiederholen.

Tipp: Während Sie Ihren Code schreiben, sehen Sie möglicherweise Fehler im Fenster. Diese Fehler prüfen auf Syntaxfehler, nicht auf Ausführungsfehler. Syntaxfehler werden unabhängig von der Spracheinstellung Ihres Benutzerkonto immer auf Englisch angezeigt. Die Ausführung erfolgt erst, wenn die Aufgabe gesichert und der Workflow ausgelöst wurde.

---

×

close

Geben Sie bei Bedarf eine Aufgabe Dies erklärt, was der JavaScript-Code erreichen sollte.

Klicken Sie auf Testcode um den Code in Ihrem lokalen Browser auszuführen.

Tipp: Da sie in einer anderen Umgebung stattfinden, liefert das Testen des Codes möglicherweise nicht genau das gleiche Ergebnis wie die Ausführung im Workflow.

Verwenden Sie die {a} dynamischer Text hinzufügen hinzuzufügendes Menü dynamischer Text in Ihren JavaScript-Ausdruck. Dynamischer text ist nützlich, um Werte aus Ihrem Ereignis abzurufen, z. B. das Abrufen der Umfrage. Dynamischer text wird ausgewertet, bevor Ihr JavaScript-Ausdruck ausgeführt wird.

Wenn Sie Ihren Code löschen und von vorne beginnen müssen, klicken Sie auf Auf Standard zurücksetzen.

Wenn Sie fertig sind, klicken Sie auf Speichern.

Die Aufgabe ist häufig mit einer anderen Aufgabe gekoppelt, um die Ausgabe der Aufgabe zu verwenden. Klicken Sie auf das Pluszeichen ( + ), wählen Sie Aufgabe hinzufügen, und wählen Sie die weiter Aufgabe. Siehe diese Seite für eine Übersicht über die Aufgaben.

---

×

close

Tipp: Wenn Sie Ihre nachfolgenden Aufgaben einrichten, ist die Ausgabe der Aufgabe im dynamischer Text der Aufgabe verfügbar.

---

×

close

JavaScript-Ausführungsgrenzen

Beachten Sie beim Schreiben Ihres JavaScript-Codes, der in die Aufgabe aufgenommen werden soll, die folgenden Ausführungsbeschränkungen:

• Maximale Ausführungszeit: 10 Sekunden
• Maximale JavaScript-Länge: 6 KB
• Keine ausgehenden API: Aus Sicherheitsgründen kann die Aufgabe weder ausgehende Anforderungen an andere APIs oder Services stellen noch andere JavaScript-Bibliotheken zur Laufzeit über HTTP-Requests abrufen.

Wenn Ihr JavaScript-Code diese Grenzen überschreitet, schlägt die Aufgabe fehl. Wenn Ihr Workflow fehlschlägt, gehen Sie zu Workflow-Reporting finden Sie weitere Informationen darüber, warum Ihr Workflow fehlgeschlagen ist.

Bewährte Praktiken

Wenn Sie Ihr JavaScript schreiben, befolgen Sie die folgenden Best Practices:

• • Ihr Code sollte folgende Anforderungen erfüllen: ES6 Syntax.
  • Ihr Code wird mit einfachem JavaScript ausgeführt.
  • Ihr Code muss Ihr Ergebnis als JavaScript-Objekt zurückgeben. Wenn das Rückgabeergebnis auf diese Weise formatiert ist, kann das System automatisch ableiten, welche Felder Ihr benutzerdefinierter Code zurückgibt, und einen entsprechenden dynamischer Text für nachfolgende Aufgaben bereitstellen.

    

    Beispiel: In diesem Beispiel werden mehrere Ergebnisse zurückgegeben:

    Funktionscode Aufgabe() {
Rückgabe {
Hallo: "Welt",
foo: "bar",
Status: 200
};
}

    

    Beispiel: In diesem Beispiel wird ein einzelnes Ergebnis zurückgegeben:

    Funktionscode Aufgabe() {
Rückgabe {
Ergebnis: "Hallo Welt",
};
}

  • Je nachdem, welche Art von Informationen Sie erwarten, müssen Sie Ihre Lokatorsyntax möglicherweise in Anführungszeichen setzen. Sie müssen Anführungszeichen hinzufügen, wenn Ihr Lokator in eine Zeichenfolge aufgelöst werden soll. Sie müssen keine Anführungszeichen hinzufügen, wenn es sich um ein Objekt handelt

    

    Beispiel: Für einen Code wie den folgenden wären beispielsweise Anführungszeichen erforderlich:

    Funktionscode Aufgabe() {
let ticketId = "~{ch://OCAC_31HNMUuEpm3Jg/exports.data.key}";
...
}

  • Wenn Sie dynamischer Text für Felder verwenden, die Anführungszeichen enthalten können, sollten Sie Vorlagenliterale (`) anstelle von Anführungszeichen um den dynamischer Text.

Beispiel: Verwendung einer Aufgabe mit einer Aufgabe

In diesem Beispiel wird die Verwendung einer Aufgabe mit einem Aufgabe. Sie können eine Aufgabe mit einer Aufgabe verwenden, um die Umfrage eines Befragte:r in API-freundlichen Code umzuwandeln, und dann die zurückgegebenen Werte verwenden, um einen API durchzuführen. Sie können dann die Ergebnisse des API verwenden und eine andere Aufgabe verwenden, um die zurückgegebenen Werte in eine menschenfreundliche Antwort umzuwandeln.

In diesem Beispiel erstellen wir einen Restaurantfinder in Qualtrics. Wir werden später noch etwas näher auf die Besonderheiten eingehen, aber unten finden Sie eine Übersicht darüber, wie wir das erreichen.

Anlegen eines Restaurant-Finders mit Code-Aufgaben

Erstellen Sie in Ihrer Umfrage die Fragen, die in die Aufgabe einfließen. In unserem Fall handelt es sich um eine Texteingabe, die fragt, wo nach Restaurants gesucht werden soll, und eine Multiple Choice, in der gefragt wird, wie die Ergebnisse sortiert werden sollen.

---

×

close

Navigieren Sie zu Workflows.

Anlegen einen neuen Workflow.

Wählen Sie für das Ereignis des Workflows die Option Umfrage Ereignis und richten das Ereignis so ein, dass es Auslöser wird, wenn eine neue Antwort angelegt wird. Besuchen Sie die verknüpfte Seite, um weitere Informationen zu erhalten.

---

×

close

Klicken Sie auf das Pluszeichen ( + ) und wählen Sie eine Aufgabe hinzufügen.

Wählen Sie die Code Aufgabe.

---

×

close

Für den Code wandeln wir die Antworten des Befragte:r in die Werte um, die für die API erforderlich sind.

---

×

close

Wir verwenden dynamischer Text um die Frage abzurufen, woher die Antworten der Umfrageteilnehmer stammen.

Klicken Sie auf Sichern , um die Aufgabe zu sichern.

Klicken Sie auf das Pluszeichen (+) und fügen Sie eine Aufgabe hinzu.

---

×

close

Wählen Sie die Web-Service Aufgabe wählen Sie Ihre Authentifizierung aus. Siehe diese Seite für weitere Informationen.

---

×

close

Geben Sie die URL, die Sie erreichen möchten.

---

×

close

Hängen Sie Ihre Parameter an mit Abfragezeichenfolgen. Verwenden Sie die dynamischer Text Menü, {a}, um Werte aus Ihrer Umfrage und der vorherigen Aufgabe zu verwenden.

Beispiel: Unsere vollständig erstellte URL lautet

api sort_by=~{ch://OCAC_Zt2TNQYggAb6u89/sort_by}&location=${q://QID1/ChoiceTextEntryValue}

Dieser enthält 2 Parameter: sort_by und location. Für sort_byist der Wert das Ergebnis unserer ersten Aufgabe. Für Ablageort, der Wert ist die Antwort des Befragte:r auf die Texteingabe.

Schließen Sie die Einrichtung der Aufgabe nach Bedarf ab. Siehe Web-Service-Aufgaben wenn Sie Hilfe benötigen.

Tipp: In der Aufgabe können Sie Ihre erwarteten zurückgegebenen Werte testen, um sicherzustellen, dass der API funktioniert.

---

×

close

Legen Sie bei Bedarf benutzerdefinierte JSON an, die in anderen Aufgaben verwendet werden können. In unserem Beispiel legen wir einen „Unternehmen“-Pfad an, der eine Reihe von Unternehmen aus unseren Ergebnisse zurückgibt.

---

×

close

Tipp: Wenn Sie Ihre Aufgabe getestet haben, identifiziert Qualtrics automatisch JSON und fügt sie hier hinzu. Sie können nicht benötigte Elemente löschen, indem Sie auf das Papierkorb klicken.

Klicken Sie auf Speichern.

Klicken Sie auf das Pluszeichen ( + ) und wählen Sie eine Aufgabe hinzufügen.

---

×

close

Wählen Sie die Code Aufgabe.

---

×

close

Nun müssen wir die resultierende JSON aus der Aufgabe in ein lesbares Formular umwandeln. In unserem Fall transformieren wir es in HTML für die Verwendung in einer E-Mail.

---

×

close

Um die resultierende JSON aus der Aufgabe abzurufen, verwenden Sie das Menü dynamischer Text. {a}.

Klicken Sie auf Speichern.

Tipp: Wenn Sie dynamischer Text verwenden, erhalten Sie möglicherweise eine Warnung, da der Bezeichner für dynamischer Text kein gültiges JavaScript ist. Dies wird jedoch vor der Ausführung aufgelöst, da der dynamischer Text vor der Ausführung des Codes durch den Feldwert ersetzt wird.

Klicken Sie auf das Pluszeichen ( + ) und wählen Sie eine Aufgabe hinzufügen.

Auswählen E-Mail.

---

×

close

einrichten E-Mail-Aufgabe. Besuchen Sie die verknüpfte Seite, um weitere Informationen zu erhalten.

Rohr im Ergebnis Ihrer zweiten Aufgabe in den E-Mail-Text. Dies gibt die Ergebnisse der Restaurantsuche zurück.

---

×

close

Beispiel: Im Folgenden sehen Sie, wie der E-Mail-Editor mit den dynamischen Antworten des Befragte:r aussieht, zusammen mit dem Ergebnis der zweiten Aufgabe.

---

×

close

Die resultierende E-Mail gibt die ausgewählten Suchergebnisse Ihres Befragte:r Ergebnisse.

---

×

close