Tippen Sie ganze Begriffe oder beginnen Sie Wörter und enden Sie mit einem Stern * um alle Suchergebnisse vorgeschlagen zu bekommen. Beispiel "Beschr*"
Mit Confiforms erstellen Sie Formulare und Workflows um Daten einfach und strukturiert zu erfassen. Lassen Sie sich per E-Mail über neue Daten informieren und zeigen Sie diese in Reports in verschiedenen Ansichten an: Tabellen, Listen, Karten, Kalender und komplett individualisiert. Alle Daten können sortiert und gefiltert werden.
Auf dieser Seite werden Grundelemente beschrieben, um ein
simlpes
simples 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.
Alle Confiforms-Formulare auf dieser Seite finden Sie auch als Video Anleitung auf dem TU coLAB TUPeerTube Account
expandOption
disable-expand-collapse
navigationTitle
Inhaltsverzeichnis
selector
h1,h2
wrapNavigationText
true
Panel
title
Beispiele zum Kopieren
Children Display
style
h3
Auf dieser Seite finden Sie:
toc
Die Confiforms-Basis Elemente
Confiforms besitzt 3 Klassen an Makros. Obwohl 20 ConfiForms Makros existieren, werden nur 2 benötigt um ein Formular zu definieren und 1 um das Formular anzuzeigen.
Klasse
Beschreibung
Formular-definierende Makros
Diese Makros definieren das Formular und deren Felder. In ConfiForms lauten diese ConfiForms Form Definition und ConfiForms Field Definition.
Formular-konfigurierende Makros für Dateneingabe und Filterung
Diese Makros werden benötigt, um die Ansicht des Formulars zu ermöglichen. Das zuständige Makro für die Ansicht lautet ConfiForms Registration Control (FormView).
Optional kann ConfiForms Field eingebaut werden. Dieses Makro spricht direkt ein definiertes ConfiForms Field Definition an.
Ansicht-konfigurierende Makros für die gespeicherten Daten
Mittels der View Makros können die Daten auf verschiedener Weise angezeigt werden. (Beispielsweise als Tabelle, Kalender, Liste, Karten, usw.)
Wieso sehe ich diese Schaltflächen in meiner Ansicht?
Beide Schaltflächen sind spezielle Tools, die NUR für Administratoren des Formulars sichtbar sind.
Die Schaltfläche mit einem Zahnrad und dem Namen Ihres Formulars bietet eine automatische generierte Administratoransicht Ihrer gespeicherten Daten sowie schnelle Links zur Migrations- und Wiederherstellungs-API und zur Import-API.
Die Schaltfläche + zeigt Ihnen die Metadatenfelder für die Daten, die Sie anzeigen.
Info
Section
Column
Column
Hier können unter View/Edit stored data alle Einträge des Formulars angezeigt werden, spezielle Ansichten können mittels der ConfiForms View Makros ermöglicht werden.
In dieser Ansicht können zusätzlich Daten exportiert und importiert werden
Exportieren der Daten eines Formulars (CSV, XLS, JSON, XML, RAW)
Image Added
Ein simples Formular
Info
Dieses Formular dient zur einfachen Registrierung eines Events mit einem Titel, einer Zeitkomponente und der Möglichkeit Details hinzuzufügen.
Fügen Sie das Makro ConfiForms Form Definition ein. Weisen Sie diesem Formular den Namen standardForm und einen Titel zu.
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
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.
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.
Aktualisieren Sie die Seite.
Info
Die Ergebnisse des Formulars, wie in Schritt 4 gezeigt, können auf einer anderen Seite angezeigt werden.
Dabei müssen Sie zusätzlich zum Formularnamen die Seite angeben, auf der sich das Formular befindet
Lecturetube embed video
width
400
inputlink
https://video.tuwien.ac.at/!v/N6bJlxwDG47
height
200
Registrierungsformular
ConfiForms Form Definition
formName
standardForm
titleTitletext
whenWhendatetime
detailsDetailstextarea
ConfiForms (FormView) Registrations Control
formName
standardForm
type
Embedded
regControlLayout
true
Tabellenansicht des simplen Formulars
ConfiForms TableView
formName
standardForm
Das ConfiForms IFTTT Integration Rules - Makro
Das IFTTT (If This Then That) Makro kann genutzt werden, um Integrationsregeln für das Formular zu definieren.
Beispielsweise können E-Mail-Benachrichtigungen gesendet werden, wenn ein neuer Datensatz generiert wird oder wenn ein bestehender Datensatz sich ändert bzw. gelöscht wird.
Ein anderes Beispiel wäre das Erstellen von neuen Seiten mittels Vorlagen und den im Formular eingegebenen Daten.
Fügen Sie zuerst das Makro ConfiForms Form Definition ein. Weisen Sie diesem Formular den Namen feedbackMail und einen Titel zu.
Fügen Sie danach das Makro ConfiForms Form Field Definition ein.
Parametername
Auswahl/Inhalt
Field Name
messageBody
Field Label
Feedback
Field Type
Textarea
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:
Parametername
Auswahl/Inhalt
ConfiForms Form name
feedbackMail
Rendering form as
Embedded
Message to show after a record been created
Vielen Dank für Ihr Feedback!
Confirmation message to show before form submit
Wollen Sie Ihren Feedback absenden?
Fügen Sie nun das Makro ConfiForms IFTTT Integration Rules ein.
Parametername
Auswahl/Inhalt
Event *
onCreated
Choose Action to perform
Send Email
Subject for email message
Feedback
Recipient
Hier müssen Sie die E-Mail Adresse eingeben, die als Empfänger der Nachrichten gilt.
Um den Inhalt des Feedbacks in Ihren erhaltenen E-Mails zu sehen müssen Sie (wie im Bild rechts) im Makrokörper
Code Block
[entry.messageBody]
eingefügen. Entry bezieht sich dabei auf den Eintrag des Formulars. messageBody ist der Name des ConfiForms Form Field Definition Makros der in Schritt 2 definiert wurde. Mit diesem Aufruf kann nun der ausgefüllte Inhalt des von uns definierten Feldes als E-Mail Nachricht gesendet werden. Aktualisieren Sie die Seite.
Warning
Falls Sie Probleme haben Text in eckigen Klammern zu schreiben, da coLAB diese normalerweise als Link verpackt, schreiben Sie den Text in einem externen Editor oder dergleichen und dann kopieren Sie diesen Text mit den eckigen Klammern und fügen Sie diesen hier ein.
Image Removed
Image Removed
Anwendungsfall Event Anmeldung mit erstellter Unterseite und E-Mail-Benachrichtigung
Info
In diesem Beispiel wird eine Event-Anmeldung dargestellt. Dabei gibt es eine Seite, welches das Formular beinhaltet und Informationen über dieses Event. Das Formular hat ein Feld, um den/die coLAB-Benutzer/in anzugeben und ein zusätzliches Captcha (welches optional ist und rein aus Darstellungszwecken gewählt wurde).
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).
Fügen Sie zuerst das Makro ConfiForms Form Definition ein. Weisen Sie diesem Formular den Namen workshopIPS und einen Titel zu.
Fügen Sie danach das Makro ConfiForms Form Field Definition ein. Hier benötigen Sie 2 davon:
Field Name
Field Label
Field Type
Required?
1
myName
Geben Sie Ihren Namen für die Anmeldung an
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.
Yes
2
verify
Captcha
Captcha
Yes
Um das Formular anzeigen zu können, müssen Sie das Makro ConfiForms (Form View) Registration Control eingefügen. Folgender Parameter wurde gewählt:
Parametername
Auswahl/Inhalt
Rendering form as
Embedded
Fügen Sie nun das erste ConfiForms IFTTT Integration Rules Makro ein.
Parametername
Auswahl/Inhalt
Event *
onCreated
Choose Action to perform
Create Page
Page Title
Code Block
Workshop IBS [entry.myName.fullName]
Labels
workshopIPS
Sobald das Formular abgesendet wird, wird dieses Makro ausgelöst und eine Seite erstellt. Dabei lautet der Präfix der neu erstellten Seite WorkshopIPS und danach wird mit [entry.myName.fullName] auf den Namen des Users verwiesen. Entry bezieht sich dabei auf den Eintrag des Formulars. myName ist das definierte Feld des Typs User. Da es sich dabei um den Typ User handelt, ist es möglich auf weitere Eigenschaften zuzugreifen. Beispielsweise fulllname, dieser beinhaltet den ganzen Namen des Benutzers. Weiterst wird das Stichwort workshopIPS vergeben. Für Interessierte hier ein Link zu welchen Feldern und Eigenschaften mittels ConfiForms zugegriffen werden kann: Accessing field values and properties in ConfiForms
Fügen Sie nun das zweite ConfiForms IFTTT Integration Rules Makro ein.
Parametername
Auswahl/Inhalt
Event *
onCreated
Choose Action to perform
Send Email
Ein neue Event-Anmeldung
Recipients
Hier müssen Sie die E-Mail Adresse eingeben, die als Empfänger der Nachrichten gilt.
Sobald das Formular abgesendet wird, wird dieses Makro ausgelöst und der Inhalt dieses Makros wird als Inhalt einer E-Mail versendet. Das Argument
Code Block
${iftttResult_0.displayTitle}
ist der Titel des erhaltenen Resultats dieses Makros. Sie können diesen Wert einfach kopieren und dadurch den Titel der soeben erstellten Seite in der Mail mitversenden.
Aktualisieren Sie die Seite.
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
Info
Hier werden zwei Validierungsregeln in Zusammenhang mit ConfiForms dargestellt.
Die erste Validierung erlaubt es nur Ziffern einzugeben.
Die zweite Validierung erlaubt es nur Buchstaben einzugeben.
Fügen Sie zuerst das Makro ConfiForms Form Definition ein. Weisen Sie diesem Formular einen Namen und einen Titel zu.
Fügen Sie danach das Makro ConfiForms Form Field Definition ein. Hier benötigen Sie 2 davon:
Field Name
Field Label
Field Type
1
type
Typ
Dropdown (Siehe Bild rechts)
ziffern - Nur Ziffern
buchstabe - Nur Buchstaben
2
value
Wert
Text
Um das Formular anzeigen zu können, müssen Sie das Makro ConfiForms (Form View) Registration Control einfügen. Folgender Parameter wurde gewählt:
Parametername
Auswahl/Inhalt
Rendering form as
Embedded
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)
Field name (or regular expression)
Condition
Message to show when validation rule matches
1
value
Code Block
type:ziffern
Validation rule
Bitte nur Ziffern eingeben
Code Block
^[0-9,;]+$
2
value
Code Block
type:buchstabe
Validation rule
Bitte nur Buchstaben eingeben
Code Block
^[a-zA-Z]*$
Aktualisieren Sie die Seite.
Image RemovedImage Removed
Image RemovedImage Removed
Anwendungsfall: Kalenderansicht mit Datums- und Zeitintervalle und Validierungsregeln
Info
In diesem Beispiel werden Events mit einem Namen und einer Zeitperiode angegeben. Dabei wird zusätzlich mit einer Validierungsregel überprüft, ob in dem ausgewählten Zeitraum bereits ein Event stattfindet. Ist dies der Fall, ist das Absenden des Formulars nicht möglich.
Fügen Sie zuerst das Makro ConfiForms Form Definition ein. Weisen Sie diesem Formular einen Namen und einen Titel zu.
Fügen Sie danach das Makro ConfiForms Form Field Definition ein. Hier benötigen Sie 2 davon:
Field Name
Field Label
Field Type
1
eventTitle
Event Title
Text
2
eventDT
Event Date/Time
DateTime Interval
Um das Formular anzeigen zu können, müssen Sie das Makro ConfiForms (Form View) Registration Control einfügen. Folgender Parameter wurde gewählt:
Parametername
Auswahl/Inhalt
Rendering form as
Embedded
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:
Condition
Message to show when validation rule matches
Code Block
language
sql
(eventDT.startDate:<=[entry.eventDT.endDate] AND eventDT.endDate:>=[entry.eventDT.startDate] AND !id:[entry.id])
Validation Rule (Dataset)
Daten überschneiden sich
Um eine Kalenderansicht auf einer Seite zu erstellen, müssen Sie das Makro ConfiForms CalendarView mit folgenden Parametern einfügen:
Name of the field to use as a grouping field *
ConfiForms Field name to use as calendar event title
eventDT
myevents
Code Block
[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:
1
eventTitle
2
eventDT
Aktualisieren Sie die Seite.
Image Removed
Info
Falls ein Event in diesem Zeitintervall bereits existiert, wird diese Rückmeldung ausgegeben