Versions Compared

Old Version 40

changes.mady.by.user Michaela Dereani

Saved on

compared with

New Version Current

changes.mady.by.user Admin (LP)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt

Confiforms ist ein mächtiges Formular-Tool um einfache und komplexe Standardformulare zu erstellen, Daten strukturiert zu erfassen und diese zu exportieren.

Da die Komplexität und der Umfang in Zusammenhang mit allen ConfiForms-Makros relativ hoch ist, werden hier nur die Grundelemente beschrieben

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 simples Formular zu erstellen.

Weitere Anwendungsfälle werden unten aufgelistet.

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.


Easy Heading Macro
headingIndent0
expandOptiondisable-expand-collapse
navigationTitleInhaltsverzeichnis
selectorh1,h2
wrapNavigationTexttrue


Panel
titleBeispiele zum Kopieren

Children Display
styleh3

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.

KlasseBeschreibung
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  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?
Image ModifiedImage Modified

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.

  1. Zuerst wird Fügen Sie das Makro ConfiForms Form Definition eingefügtein.
    Diesem Formular wird ein Name und ein Titel zugewiesen.
    Weisen Sie diesem Formular den Namen standardForm und einen Titel zu.

  2. Fügen Sie danach Danach wird das Makro ConfiForms Form Field Definition eingefügtein.
    Dies entspricht einem der Felder, die dieses Formular trägt. Hier werden Fügen Sie 3 dieser Makros eingefügthier ein. Jedes einem der Felder entsprechend.


    		Field NameField LabelField Type
    1titleTitleText
    2whenWhenDatetime
    3detailsDetailsTextarea


  3. Um das Formular anzeigen zu können, muss müssen Sie das Makro ConfiForms (Form View) Registration Control eingefügt werdeneinfügen.
    Hier muss der Name Referenzieren Sie hier den Namen des vorher erstellten Formulars referenziert werden. Dies war standardForm.
    Unter Rendering form as wurde wählen Sie die Option Embedded ausgewählt, 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. In diesem Beispiel wurde eine ConfiForms Table View ausgewählt um Um die Daten in einer tabellarischen Ansicht zu zeigen. Hier muss das Formular wieder referenziert werden, wie bereits , fügen Sie das Makro ConfiForms Table View ein. Referenzieren Sie das Formular wie in Schritt 3.

  5. Aktualisieren Sie die Seite.
Info

Die Ergebnisse des Formulars, wie in Schritt 4 gezeigt, können auf einer anderen Seite angezeigt werden.

Dabei muss müssen Sie zusätzlich zum Formularnamen die Seite angegeben werdenangeben, auf der sich das Formular befindet


Lecturetube embed video
width400
inputlinkhttps://video.tuwien.ac.at/!v/N6bJlxwDG47
height200






Registrierungsformular

ConfiForms Form Definition
formNamestandardForm

titleTitletext

whenWhendatetime

detailsDetailstextarea



ConfiForms (FormView) Registrations Control
formNamestandardForm
typeEmbedded
regControlLayouttrue



Tabellenansicht des simplen Formulars

ConfiForms TableView
formNamestandardForm





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.

Um mehr Details zu diesem Makro zu bekommen, sehen Sie sich diese Seite an: Advanced Integrations with IFTTT macros with ConfiForms

In den folgenden Beispielen wird das Makro u.a. verwendet.

Anwendungsfall: Feedback Formular

Info

In diesem Formular wird ein Feedback-Verfahren dargestellt, bei dem ein Feedback-Text als E-Mail-Inhalt an eine angegebene Adresse gesendet wird.

Zuerst wird das Makro ConfiForms Form Definition eingefügt.
Diesem Formular wird ein Name und ein Titel zugewiesen.

Danach wird das Makro ConfiForms Form Field Definition eingefügt.

ParameternameAuswahl/InhaltField NamemessageBodyField LabelFeedbackField TypeTextarea

Um das Formular anzeigen zu können, muss das Makro ConfiForms (Form View) Registration Control eingefügt werden.
Hier muss der Name des vorher erstellten Formulars referenziert werden, dies war feedbackMail.
Folgende Parameter wurden geändert/ausgefüllt:

ParameternameAuswahl/InhaltConfiForms Form namefeedbackMailRendering form asEmbeddedMessage to show after a record been createdVielen Dank für Ihr Feedback!Confirmation message to show before form submitWollen Sie Ihren Feedback absenden?

Nun wird das ConfiForms IFTTT Integration Rules Makro eingefügt.

ParameternameAuswahl/InhaltEvent *onCreatedChoose Action to performSend EmailSubject for email messageFeedbackRecipientHier 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 muss (wie im Bild rechts) im Makrokörper [entry.messageBody] eingefügt werden.
Entry bezieht sich dabei auf den Eintrag des Formulars.
messageBody ist der Name des ConfiForms Form Field Definition Makro 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.





Weiterführende Informationen und wichtige Tipps


Confiforms Anleitungsvideos auf TU Peertube:


Feedback Formular Video Anleitung

Lecturetube embed video
width400
inputlinkhttps://video.tuwien.ac.at/!v/Eb8d7Zd0DUI
height200

Event Anmeldung (mit Erstellung einer Unterseite)

Lecturetube embed video
width400
inputlinkhttps://video.tuwien.ac.at/!v/ELuwWOptTeP
height200

Kalender mit Zeitvalidierung

Lecturetube embed video
width400
inputlinkhttps://video.tuwien.ac.at/!v/OY9zXv_5Zf8
height200

Validierungsregeln

Lecturetube embed video
width400
inputlinkhttps://video.tuwien.ac.at/!v/Oe-OWQwgdQI
height200

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, welches weiterhin ein ausgewähltes Stichwort trägt. Zudem wird an den/die Administrator/in eine E-Mail geschickt, welches eine Benachrichtigung per Mail darstellt. In dieser Mail kann ein Inhalt eingefügt werden, beispielsweise der Name der neuen Seite.

Zuerst wird das Makro ConfiForms Form Definition eingefügt.
Diesem Formular wird ein Name und ein Titel zugewiesen.

Danach wird das Makro ConfiForms Form Field Definition eingefügt. Hier benötigen wir 2 davon:

Field NameField LabelField TypeRequired?1myNameGeben 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.

Yes2verifyCaptchaCaptchaYes

Um das Formular anzeigen zu können, muss das Makro ConfiForms (Form View) Registration Control eingefügt werden.
Folgender Parameter wurde gewählt:

ParameternameAuswahl/InhaltRendering form asEmbeddedNun wird das erste ConfiForms IFTTT Integration Rules Makro eingefügt.
ParameternameAuswahl/InhaltEvent *onCreatedChoose Action to performCreate PagePage TitleWorkshop IBS [entry.myName.fullName]LabelsworkshopIPSSobald 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
Tip

Um Seiten basierend auf Vorlagen zu erstellen, sehen Sie sich diese nützliche Seite an: Advanced integrations with IFTTT macros with ConfiForms

Nun wird das zweite ConfiForms IFTTT Integration Rules Makro eingefügt.
ParameternameAuswahl/InhaltEvent *onCreatedChoose Action to performSend EmailEin neue Event-AnmeldungRecipientsHier 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 ${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.

    1. Die erste Validierung erlaubt es nur Ziffern einzugeben.
    2. Die zweite Validierung erlaubt es nur Buchstaben einzugeben.
    Zuerst wird das Makro ConfiForms Form Definition eingefügt.
    Diesem Formular wird ein Name und ein Titel zugewiesen.

    Danach wird das Makro ConfiForms Form Field Definition eingefügt. Hier benötigen wir 2 davon:

    Field NameField LabelField Type1typeTyp

    Dropdown (Siehe Bild rechts)

    • ziffern - Nur Ziffern
    • buchstabe - Nur Buchstaben
    2valueWertText

    Um das Formular anzeigen zu können, muss das Makro ConfiForms (Form View) Registration Control eingefügt werden.
    Folgender Parameter wurde gewählt:

    ParameternameAuswahl/InhaltRendering form asEmbedded

    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.
    Nun werden 2x ConfiForms Field Definition Rules eingefügt 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)ConditionMessage to show when validation rule matches1valuetype:ziffernValidation ruleBitte nur Ziffern eingeben^[0-9,;]+$2valuetype:buchstabeValidation ruleBitte nur Buchstaben eingeben^[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.

    Zuerst wird das Makro ConfiForms Form Definition eingefügt.
    Diesem Formular wird ein Name zugewiesen.

    Danach wird das Makro ConfiForms Form Field Definition eingefügt. Hier benötigen wir 2 davon:

    Field NameField LabelField Type1eventTitleEvent TitleText2eventDTEvent Date/TimeDateTime Interval

    Um das Formular anzeigen zu können, muss das Makro ConfiForms (Form View) Registration Control eingefügt werden.
    Folgender Parameter wurde gewählt:

    ParameternameAuswahl/InhaltRendering form asEmbedded

    Nun muss ein ConfiForms Rules for Field Definition Makro eingefügt werden um sicherzustellen, dass sich die Intervalle nicht überschneiden.
    Folgende Parameter werden ausgewählt:

    ConditionMessage to show when validation rule matches

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

    Validation Rule

    Daten überschneiden sich

    Um eine Kalenderansicht auf einer Seite zu erstellen, muss das Makro ConfiForms CalendarView mit folgenden Parametern eingefügt werden:

    Name of the field to use as a grouping field *

    ConfiForms Field name to use as calendar event titleeventDTmyevents[entry.eventTitle]

    Zusätzlich können im Makrokörper ConfiForms Form Field Makros eingefügt werden. 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:

    1eventTitle2eventDT
  • Aktualisieren Sie die Seite.

    • Image Removed

    Info

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

    Image Removed

    Image Removed

    Weitere Informationen

    ConfiForms app for creating forms in Confluence.

    ConfiForms Tutorials