Widget Fragebogen

Fragebögen aus vynst auf der Website ausfüllen lassen, etwa Anmeldungen, Umfragen, Kündigungen oder Widerrufe, mit Entwürfen, Anhängen und Vorbelegung.

Das Widget zeigt einen Fragebogen aus vynst (inwendo ERP) mit allen Fragen, Seiten und Bedingungen. Die Antworten landen direkt in vynst, wo ihr sie auswertet oder weiterverarbeitet.

<div data-iw-questionnaire
     data-iw-host="verein.iw-erp.de"
     data-iw-questionnaire-id="kuendigung"></div>
<script src="https://verein.iw-erp.de/frontend_assets/backend/iw_erp_web_ui/questionnaire.js" async></script>

Shortcode: [iw-questionnaire host="verein.iw-erp.de" id="kuendigung"]

Optionen

Attribut	Standard	Bedeutung
`data-iw-questionnaire-id`		ID, Token oder Kurzname des Fragebogens
`data-iw-answer-token`	leer	eine angefangene Antwort (Entwurf) fortsetzen
`data-iw-draft`	aus	neue Antworten zuerst als Entwurf speichern
`data-iw-show-draft-button`	aus	Button „Entwurf speichern“ zeigen
`data-iw-auto-save-draft`	aus	Entwürfe beim Tippen automatisch speichern (mit `data-iw-answer-token`)
`data-iw-hide-questionnaire-title`	aus	Zwischenüberschrift „Fragebogen“ ausblenden
`data-iw-hide-participant`	aus	Kontaktdaten nicht abfragen, wenn der Fragebogen sie nicht verlangt
`data-iw-prefill`	leer	Antworten vorauswählen, als JSON `{"Fragetext": "Wert"}`. Der Wert muss eine der Antwortmöglichkeiten sein.
`data-iw-lookups`	leer	Fragen für den IBAN-Abgleich benennen, als JSON `{"iban": "IBAN", "bic": "BIC", "institution": "Name der Bank"}`. Aus der IBAN füllt das Widget BIC und Bank.
`data-iw-session-token`	leer	Sitzung eines angemeldeten Mitglieds; die Antwort gehört dann zu seinem Konto

Texte, die ihr oft anpasst: participant (Überschrift Kontaktdaten), start, send, success.

<div data-iw-questionnaire
     data-iw-host="verein.iw-erp.de"
     data-iw-questionnaire-id="kuendigung"
     data-iw-text-participant="Eure Mitgliedsdaten"
     data-iw-text-send="Kündigung abschicken"
     data-iw-prefill='{"Grund der Kündigung": "Umzug"}'></div>

Fragen nach einem Ticket (Fragetyp Ticket) kann das Widget nicht darstellen. Nutzt dafür die vynst App.

Anhänge

Erlaubt der Fragebogen Anhänge, können Besucher Dateien hochladen. Sie hängen an der Antwort in vynst.

In vynst einrichten

Den Fragebogen öffentlich machen. Ohne Freigabe zeigt das Widget den Text notAllowed.
Eure Website in CORS - HTTP Origins eintragen.

Ereignisse

iw:questionnaire:ready, :page-change, :submit-start, :submitted, :draft-saved, :error und :link.

Fragebögen, die ihr nacheinander im selben Element zeigt, räumt ihr vorher mit IwQuestionnaire.destroy(element) ab und startet sie in einem neuen Element.

API

Das Widget nutzt GET /api/media/questionnaire/{id} und POST /api/media/public/questionnaire_answer, für Entwürfe …/questionnaire_answer_draft. Details unter Medien.