Tippen Sie ganze Begriffe oder beginnen Sie Wörter und enden Sie mit einem Stern * um alle Suchergebnisse vorgeschlagen zu bekommen. Beispiel "Beschr*"
Confiforms ist ein mächtiges Formular-Tool um einfache 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 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 und ein Titel zugewiesen. 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.
Registrierungsformular
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.
Anwendungsfall: Feedback Formular
- 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.
Parametername Auswahl/Inhalt Field Name messageBody Field Label Feedback Field Type 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.
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? 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 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.- 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 ein.
Anwendungsfall Event Anmeldung mit erstellter Unterseite und E-Mail Benachrichtigung
- 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 Name Field Label Field Type Required? 1 myName Geben Sie Ihren Namen für die Anmeldung an User
(User ist wie das bekannte @ Mentioning 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, muss das Makro ConfiForms (Form View) Registration Control eingefügt werden.
Folgender Parameter wurde gewählt:Parametername Auswahl/Inhalt Rendering form as Embedded Nun wird das erste ConfiForms IFTTT Integration Rules Makro eingefügt.
Parametername Auswahl/Inhalt Event * onCreated Choose Action to perform Create Page Page Title 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
Weiters 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 ConfiFormsUm 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.
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${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.
Das Resultat: Eine erstellte Unterseite mit dem Präfix und dem Namen des Benutzers, der dieses Formular ausgefüllt hat. Weiters die dazu versendete E-Mail an die Empfängeradresse.
Anwendungsfall: ConfiForms-Felder mit Validierungsregeln
- 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 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, muss das Makro ConfiForms (Form View) Registration Control eingefügt werden.
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.
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) Condition Message to show when validation rule matches 1 value type:ziffern Validation rule Bitte nur Ziffern eingeben ^[0-9,;]+$ 2 value type:buchstabe Validation rule Bitte nur Buchstaben eingeben ^[a-zA-Z]*$ - Aktualisieren Sie die Seite.
Anwendungsfall: Kalenderansicht mit Datums- und Zeitintervalle und Validierungsregeln
- 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 Name Field Label Field Type 1 eventTitle Event Title Text 2 eventDT Event Date/Time DateTime Interval Um das Formular anzeigen zu können, muss das Makro ConfiForms (Form View) Registration Control eingefügt werden.
Folgender Parameter wurde gewählt:Parametername Auswahl/Inhalt Rendering form as Embedded 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:Condition Message 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 title eventDT myevents [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:1 eventTitle 2 eventDT - Aktualisieren Sie die Seite.
Falls ein Event in diesem Zeitintervall bereits existiert, wird diese Rückmeldung ausgegeben
Overview
Content Tools
Apps
Tasks