Instant-Formulare

Instant-Formulare erlauben das einfache Darstellen von Formularen in Silva-Dokumenten und das Versenden einer Mail mit den Formulareingaben.

Die Minimal-Ausstattung für ein Instant-Formular besteht aus einem Formulator-Formular, welches im ZMI erstellt wird, sowie zwei Silva-Dokumenten. Auf dem ersten Silva-Dokument wird das Formular angezeigt (External Source 'instant_form'), auf dem zweiten werden allfällige Rückmeldungen eingeblendet (External Source 'instant_form_simple_feedback' oder 'instant_form_feedback').

Formulator-Formular

Das Formular, welches angezeigt werden soll, muss im ZMI mit Hilfe von Formulator erstellt werden. Sie können dem Formular einen beliebigen Namen geben. Achtung: Stellen Sie sicher, dass allfällige Umlaute und Sonderzeichen richtig dargestellt werden. Zu diesem Zweck muss auf Settings sowohl 'Encoding of pages the form is in' wie auch 'Encoding of form properties' auf 'UTF-8' gesetzt werden. Zusätzlich darf die Checkbox 'Form properties are unicode' nicht angekreuzt werden.

'External Source'-Elemente

Formular-Element instant_form

Ein Instant-Formular können Sie mit Hilfe der External Source 'instant_form' in ein Silva-Dokument einbinden. Diese External Source kann drei Parameter übernehmen.

ID of the Formulator form [optional]

Mit dem ersten Parameter können Sie die ID des Formulars angeben, das in der Seite angezeigt werden soll. Dabei handelt es sich um ein Formulator-Formular, welches sich im gleichen Verzeichnis befinden muss wie das Dokument, welches das Formular anzeigen soll. Dieser Parameter ist optional. Wird er nicht angegeben, so wird ein Standard-Formular eingeblendet.

ID of the Silva document giving the feedback [zwingend]

Geben Sie hier die ID des Silva-Dokuments an, mit welchem das Feedback dargestellt werden soll. Dieses Dokument enthält sinnvollerweise das 'External Source'-Element instant_form_feedback.
Dieser Parameter ist zwingend.

Label of send button [optional]

Mit diesem Parameter können Sie den Titel der Schaltfläche angeben, mit welchem das Formular abgeschickt wird. Falls dieser Parameter leer ist, wird eine Schaltfläche mit dem Titel 'Ok' angezeigt.

Rückmeldungs-Element instant_form_simple_feedback

Auf 'instant_form' haben Sie angegeben, welche Seite zur Auswertung der Formular-Eingabe aufgerufen werden soll. Damit diese Seite tatsächlich diese Eingaben auswerten kann, muss es z.B. die External Source 'instant_form_simple_feedback' enthalten. Diese External Source wertet die Eingabe aus, erzeugt eine Mail damit und erstellt eine Rückmeldung. (Wenn Sie mehr Verarbeitungsmöglichkeiten brauchen, können Sie statt dessen die External Source 'instant_form_feedback' verwenden, siehe Komplexe Formulare.) Diese External Source hat sechs Parameter:

ID of the Formulator form [optional]

Hier muss die ID des gleichen Formulars eingegeben werden wie im ersten 'External Source'-Element.

Mail address to send the form input. [optional]

Die e-Mail-Adresse, an welche die Formular-Eingabe geschickt werden soll. Wird keine Adresse eingegeben, so wird keine Mail verschickt.

Mail address of the mail sender. [optional]

Die e-Mail-Adresse, die bei der verschickten Mail als Absenderadresse auftaucht.

Text displayed in the mail subject. [optional]

Der Text, der in der Betreff-Zeile der Mail erscheinen soll.

Text displayed in the mail body as prolog. [optional]

Einleitender Text in der verschickten Mail.

Text displayed in the mail body as epilog. [optional]

Abschliessender Text in der verschickten Mail.