Page History

Auf dieser Seite werden Grundelemente beschrieben um ein simlpes Formular zu erstellen. Außerdem finden Sie hier eine kleine Auswahl an möglichen Anwendungsfällen - die Möglichkeiten in Kombination mit allen ConfiForms-Makros sind aber deutlich umfangreicher.

1. Fügen Sie das Makro ConfiForms Form Definition ein.
   Weisen Sie diesem Formular den Namen standardForm und einen Titel zu.
   
   

2. Fügen Sie danach das Makro ConfiForms Form Field Definition ein.
   Dies entspricht einem der Felder, die dieses Formular trägt. Fügen Sie 3 dieser Makros hier ein. Jedes einem der Felder entsprechend.

   	Field Name	Field Label	Field Type
   1	title	Title	Text
   2	when	When	Datetime
   3	details	Details	Textarea

   
   

3. Um das Formular anzeigen zu können, müssen Sie das Makro ConfiForms (Form View) Registration Control einfügen.
   Referenzieren Sie hier den Namen des vorher erstellten Formulars. Dies war standardForm.
   Unter Rendering form as wählen Sie die Option Embedded, um die Ansicht auf der Seite als eingebettet zu sehen.
   
   
4. Um die Daten zu sehen, kann nun eine der View Makros ausgewählt werden. Um die Daten in einer tabellarischen Ansicht zu zeigen, fügen Sie das Makro ConfiForms Table View ein. Referenzieren Sie das Formular wie in Schritt 3.
   
   
5. Aktualisieren Sie die Seite.

Registrierungsformular

Tabellenansicht des simplen Formulars

Weiterführende Informationen und wichtige Tipps

• ConfiForms app for creating forms in Confluence.
• ConfiForms Tutorials

• Accessing field values and properties - Vertuna WIKI - ConfiForms
• Configuring ConfiForms IFTTT actions and rules - Vertuna WIKI - ConfiForms
• Multiple ways to show your form data in Confluence with ConfiForms - Vertuna WIKI - ConfiForms
• ConfiForms Field Types - Vertuna WIKI - ConfiForms
• Virtual functions - Vertuna WIKI - ConfiForms

Confiforms Anleitungsvideos auf TU Peertube:

Feedback Formular Video Anleitung

Anwendungsfall: Feedback Formular

Fügen Sie danach das Makro ConfiForms Form Field Definition ein.

Um das Formular anzeigen zu können, müssen Sie das Makro ConfiForms (Form View) Registration Control einfügen.
Hier müssen Sie den Namen des vorher erstellten Formulars referenzieren, dies war feedbackMail.
Folgende Parameter wurden geändert/ausgefüllt:

Fügen Sie nun das Makro ConfiForms IFTTT Integration Rules ein.

Um den Inhalt des Feedbacks in Ihren erhaltenen E-Mails zu sehen müssen Sie (wie im Bild rechts) im Makrokörper

[entry.messageBody]

Widget_tupeertube
Link https://tube1.it.tuwien.ac.at/videos/watch/811195bb-f510-4b49-8f0a-6b6efa2b6c6d

Image Removed

Image Removed

Anwendungsfall

Event Anmeldung

(

Nachdem das Formular ausgefüllt und abgesendet wird,

• wird eine Unterseite mit dem Namen des/der Benutzers/in erstellt
• die Unterseite erhält ein Stichwort
• erhält der/die Administrator/in eine E-Mail-Benachrichtigung mit Zusatzinfos (z.B. der Name der neuen Seite).

Sie können im Makro Confiforms Form Definition folgende Parameter dafür einstellen

Track maximum capacity (records number)

Message to show when maximum capacity is reached

Fügen Sie danach das Makro ConfiForms Form Field Definition ein. Hier benötigen Sie 2 davon:

User

(Der Typ User ist wie das bekannte @ Erwähnen eines Benutzers in coLAB.)

Somit kann sich der Benutzer aus der Liste direkt auswählen.

Um das Formular anzeigen zu können, müssen Sie das Makro ConfiForms (Form View) Registration Control eingefügen.
Folgender Parameter wurde gewählt:

mit Erstellung einer Unterseite)

Workshop IBS [entry.myName.fullName]

Sobald das Formular abgesendet wird, wird dieses Makro ausgelöst und der Inhalt dieses Makros wird als Inhalt einer E-Mail versendet.
Das Argument

${iftttResult_0.displayTitle}

Image Removed

Image Removed

Das Resultat: Eine erstellte Unterseite mit dem Präfix und dem Namen des Benutzers, der dieses Formular ausgefüllt hat.
Darunter die versendete E-Mail an die Empfängeradresse.

Image Removed

Image Removed

Anwendungsfall: ConfiForms-Felder mit Validierungsregeln

Fügen Sie danach das Makro ConfiForms Form Field Definition ein. Hier benötigen Sie 2 davon:

Dropdown (Siehe Bild rechts)

• ziffern - Nur Ziffern
• buchstabe - Nur Buchstaben

Um das Formular anzeigen zu können, müssen Sie das Makro ConfiForms (Form View) Registration Control einfügen.
Folgender Parameter wurde gewählt:

Kalender mit Zeitvalidierung

Beide Regeln werden so eingestellt, dass sie das Feld value verfolgen und basierend auf einer Bedingung ausgeführt werden, das heißt basierend auf der Auswahl, die im Feld type getroffen wurde.
Fügen Sie nun 2x ConfiForms Field Definition Rules ein mit folgenden Parametern. (Der Inhalt der Validation rule beruft sich auf das Thema Regulärer Ausdruck, mehr Informationen dazu ConfiForms Regular Expressions)

type:ziffern

^[0-9,;]+$

type:buchstabe

^[a-zA-Z]*$

Image RemovedImage Removed

Image RemovedImage Removed

Anwendungsfall: Kalenderansicht mit Datums- und Zeitintervalle und Validierungsregeln

Fügen Sie danach das Makro ConfiForms Form Field Definition ein. Hier benötigen Sie 2 davon:

Um das Formular anzeigen zu können, müssen Sie das Makro ConfiForms (Form View) Registration Control einfügen.
Folgender Parameter wurde gewählt:

Nun müssen Sie ein ConfiForms Rules for Field Definition Makro einfügen, um sicherzustellen, dass sich die Intervalle nicht überschneiden.
Folgende Parameter werden ausgewählt:

Validierungsregeln

(eventDT.startDate:<=[entry.eventDT.endDate] AND eventDT.endDate:>=[entry.eventDT.startDate] AND !id:[entry.id])

Daten überschneiden sich

Um eine Kalenderansicht auf einer Seite zu erstellen, müssen Sie das Makro ConfiForms CalendarView mit folgenden Parametern einfügen:

ConfiForms Form name *

[entry.eventTitle]

Zusätzlich können Sie im Makrokörper ConfiForms Form Field Makros einfügen. Im Vergleich zu ConfiForms Form Field Definition werden hier keine Formfelder definiert, sondern bestehende werden aufgerufen. Wenn diese eingefügt werden, können die Daten neben der Kalenderansicht angezeigt werden. (Im Beispiel rechts sehen Sie die Daten, die auf den ausgewählten Tag fallen).
Parameter der einzelnen Confiforms Form Field Makros sind nur die Namen der bereits definierten:

Widget_tupeertube
Link https://tube1.it.tuwien.ac.at/videos/watch/2d4e1cdbc89d8e28-946d5425-4df74f6c-96d7-e2bde573c68f

Image Removed

Info
Falls ein Event in diesem Zeitintervall bereits existiert, wird diese Rückmeldung ausgegeben

Image Removed

Image Removed