...
Jede PIFA-XML-Datei besteht aus genau einem "pifa"-Element mit genau einem "form"-Element. Optional kann auch genau maximal ein "data"-Element enthalten sein. Das "form"-Element samt Nachfahren beschreibt die Struktur des Formulares, wogegen das "data"-Element die erfaßten Formulardaten dokumentiert.
...
Das "form"-Element dient der Definition des Formulares als solches. Diese Angaben dazu werden als Attribute gespeichert. Zudem enthält es (optional) "field"-Elemente zur Definition der einzelnen Formularfelder welche weiter unten erläutert werden. Das "form"-Element unterstützt folgende Attribute:
| Attribut | Werte | Beschreibung |
|---|---|---|
| name | Zeichenkette | Der Name des Formulares, so wie es er im Backend in der linken Navigation ausgegeben wird. |
| table | Zeichenkette | Der Name der Datenbank-Tabelle zur Speicherung der Formulardaten. |
| method | get | post | Anfragemethode beim Absenden des Formulares. |
| timestamp | true | false | Ob beim Speichern von Formulardaten auch ein Zeitstempe Zeitstempel erfaßt werden soll. Siehe Setting "pifa/timestamp". |
FIELD - Struktur der Formularfelder
Für jedes Formulareld Formularfeld wird genau ein "field"-Element definiert. Einige Angaben zum Formularfeld werden als Attribute, andere als Kindelemente definiertnotiert. Das "field"-Element unterstützt folgende Attribute:
| Attribut | Werte | Beschreibung | ||
|---|---|---|---|---|
| rank | Zahl | Die Position des Formularfeldes im Formular.
| ||
| type | inputtext, textarea, inputpassword, inputradio, inputcheckbox, select, selectmulti, datepicker, inputfile, processbar, slider, buttonsubmit, buttonreset, buttonback, matrix, paragraph, inputhidden, fieldset_begin, fieldset_end | Der Typ des Formularfeldes, der auch den Tabentyp Tabellentyp der Datenbank-Spalte bestimmt. | ||
| column | Zeichenkette (erlaubt sind hier die Zeichen a-z, A-Z, 0-9 und _ [Unterstrich]) | Der Name der Datenbank-Spalte zur Speicherung der Formulardaten. | ||
| obligatory | true | false | Ob es sich bei diesem Feld um ein Pflichtfeld handelt oder nicht. |
...
| Element | Werte | Beschreibung | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| label | Zeichenkette | Die Beschriftung des Formularfeldes, so wie sie im Frontend ausgegeben wird.
| ||||||||||||||
| help | Zeichenkette | Der optionale Hilfetext zu einem Formularfeld.
| ||||||||||||||
| error | Zeichenkette | Die optionale Fehlermeldung zu einem Formularfeld.
| ||||||||||||||
| rule | Zeichenkette | Die optionale Validierungsregel zu einem Formularfeld. Hierbei handelt es sich um einen regulären Ausdruck.
| ||||||||||||||
| classes | "class"-Elemente | Mit dem Element "classes", das weitere "class"-Elemente enthält, werden die Namen der CSS-Klassen definiert die für ein Formularfeld ausgegeben werden sollen.
| ||||||||||||||
| options | "option"-Elemente | Mit dem Element "classesoptions", das weitere "classoption"-Elemente enthält, werden die Optionen für Formularfelder der Typen inputradio, select und selectmulti definiert. Deren Wert gibt die Beschriftung an, die im Frontend ausgegeben wird, wogegen deren "value"-Attribut den Wert angibt, der in der Datentabelle gespeichert wird.
Wenn die Optionen higegen aus einer externen Datenquelle bezogen werden sollenWird sollen, wird das "options"-Element mit dem Attribut "source" anstelle von "option"-Elementen notiert. Dieses enthält dann den Namen der Extension-Klasse die zum Bezug der Options verwendet wird.
|