Confiforms

TODO: add auszugsinfo

Da die Komplexität und der Umfang in Zusammenhang mit allen ConfiForms-Makros relativ hoch ist, werden hier nur die Grundelemente beschrieben um ein simples Formular zu erstellen. Weiters werden Anwendungsfälle weiter unten aufgelistetet, die kopiert werden können.

Um mehr Informationen zum Thema ConfiForms zu finden sehen Sie sich diese Seite an. => ConfiForms app for creating forms in Confluence

Für eine Liste an Tutorials , sehen Sie sich diese Seite an. => ConfiForms Tutorials

Auf dieser Seite finden Sie:

Die Confiforms-Basis Elemente

Confiforms besitzt 3 Klassen an Makros. Obwohl 20 ConfiForm 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 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.

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.

Ein simples Formular

Zuerst wird das Makro ConfiForms Form Definition eingefügt.
Diesem Formular wird ein Name zugewiesen und ein Titel.
Danach wird das Makro ConfiForms Form Field Definition eingefügt.
Dies entspricht einem der Felder, die dieses Formular trägt. Hier werden 3 dieser Makros eingefügt. 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, muss das Makro ConfiForms (Form View) Registration Control eingefügt werden.
Hier muss der Name des vorher erstellten Formulars referenziert werden. Dies war standardForm.
Weiters wurde unter Rendering form as die Option Embedded ausgewählt, um die Ansicht auf der Seite als eingebettet zu sehen.
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 die Daten in einer tabellarischen Ansicht zu zeigen. Hier muss das Formular wieder referenziert werden, wie bereits in Schritt 3.
Aktualisieren Sie die Seite.

Die Ergebnisse des Formulars, wie in Schritt 4 gezeigt, können auf einer anderen Seite angezeigt werden. Dabei muss zusätzlich zum Formularnamen die Seite angegeben werden, auf der sich das Formular befindet.

Das simple Formular

Registrierung

Title
When
Details

Tabellenansicht des simplen Formulars

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.

UC1 Feedback Formular

Zuerst wird das Makro ConfiForms Form Definition eingefügt.
Diesem Formular wird ein Name zugewiesen und ein Titel.
Danach wird das Makro ConfiForms Form Field Definition eingefügt.
Hier wird nur eines eingefügt.
Field Name Field Label Field Type
messageBody Feedback Textarea
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.
Weiters wurde unter Rendering form as die Option Embedded ausgewählt, um die Ansicht auf der Seite als eingebettet zu sehen.
Nun wird das ConfiForms IFTTT Integration Rules Makro eingefügt.
Parametername Auswahl/Inhalt
Event * onCreated
Choose Action to perform Send Email
Subject for email message Feedback
Recipient Hier können Sie Ihre E-Mail Adresse eingeben
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.
Aktualisieren Sie die Seite.

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 wieder ein.

Space shortcuts