JavaScript-Piping

Mit JavaScript-Piping ist es möglich, einen Wert zu pipen, der mit beliebigem JavaScript Ihrer Wahl generiert wird.

Eine spezielle NGSJS-Funktion kann eingerichtet werden, um eine Ausgabe Ihres JavaScript-Codes zurückzugeben. Die Ausgabe kann dann in einem Standardwert gespeichert werden, um sie anzuzeigen und in einem Feld zu speichern.

Die Ausgabe wird nur im Submit-Modus ausgewertet. Wenn Ihre Umfrageantworten übermittelt wurden und Sie sich im Change-Modus oder Resume-Modus befinden, ist der Wert der ursprüngliche Wert, der vor dem Fortsetzen oder Ändern der Antworten gespeichert wurde.

➕Einfaches Beispiel für die Summe von Feldern

Nachfolgend sind die Schritte zum Hinzufügen eines benutzerdefinierten JavaScript aufgeführt, das zwei Felder summiert. Sie können den Code anpassen, um jede gewünschte Ausgabe zum Speichern zu erzielen. Beachten Sie, dass Sie, wenn Sie nur eine Summe benötigen, die vorhandene Numeric Field Typ stattdessen verwenden können Erstellen Sie eine Frage mit 3 Feldern

Sobald für jedes an der Berechnung beteiligte Feld erstellt, setzen Sie in den Antwort-Eigenschaften seinen Pipe-Alias; dieser wird später verwendet, um den aktuellen Wert nachzuschlagen. Im Feld Result öffnen Sie die Antwort-Einstellungen und verwenden im Standard-Textwert die NGSJS-Funktion, um den Wert der beiden anderen Felder abzurufen und das Ergebnis auszugeben.

NGSJS(return pipeContext.getAnswer('VALUEA') + pipeContext.getAnswer('VALUEB'))

👨‍💻️ pipeContext

pipeContext ist ein integriertes Objekt, das Ihnen die folgenden Optionen bietet: Eigenschaften:

• questions: Question[] Liste der Umfragefragen.

• answers: Answer[] Liste der möglichen Antworten über alle Fragen hinweg.

• respondent: Respondent Informationen zum aktuellen Befragten.

• panelists: Panelist[] Zugehörige Panelisten (falls zutreffend).

• respondentAnswers: RespondentAnswer[] Vom Befragten bereitgestellte Antworten.

• pipeDataAttributesValues: PipeDataAttributeValue[] Zusätzliche Pipe-Datenattribute und Werte.

Methoden

getAnswer(id: string): string

Gibt den/die mit einer angegebenen Kennung verknüpften Wert(e) zurück.

• Unterstützt die Suche nach:

  • Answer ID

  • Question ID

  • Reporting-Alias

  • Pipe-Alias

• Verhalten:

  • Wenn die Kennung mit einer textbasierten Antwortübereinstimmt, wird ihr Wert zurückgegeben.

  • Wenn sie mit einer Frageübereinstimmt, werden die ausgewählten Antworten zurückgegeben.

  • Mehrere Werte werden als kommagetrennter String zurückgegeben.

isSelectedAnswer(id: string, value: string): boolean

Prüft, ob eine bestimmte Antwort ausgewählt ist.

• Parameter:

  • id: Frage- oder Antwortkennung

  • value: Zu prüfende Antwortkennung oder zu prüfender Wert

• Verhalten:

  • Wenn id sich auf eine Frage bezieht → prüft, ob die angegebene Antwort ausgewählt ist.

  • Wenn id sich auf eine Antwort bezieht → vergleicht den Wert direkt.

• Gibt zurück:

  • true wenn die Antwort ausgewählt ist oder übereinstimmt

  • false ansonsten