<Property/>-Tag - Eigenschaften für Formular-Elemente definieren
Das <PROPERTY/>-Tag kann in allen Bereichen der Regeldefinition eingesetzt werden. Abhängig davon in welchem Kontext es verwendet wird, dient es entweder dazu einen Wert oder eine andere Eigenschaft eines Formular(-Elements) zu ermitteln, z. B.:
- „Hole den Wert der Eingabekomponente A.“
- „Ist die Eingabekomponente A fokussiert?“
- „Wurde das Formular in der Inhalte-Verwaltung geöffnet?“
oder eine Aktion für ein bestimmtes Formular(-Element) auszuführen, z. B.:
- „Prüfe, ob der ermittelte Wert den Vorgaben entspricht.“
- „Schreibe den ermittelten Wert in die Eingabekomponente B.“
- „Blende die Eingabekomponente B im Formular ein.“
In einem <PROPERTY/>-Tag müssen zwei Attribute angegeben werden. Über das Attribut „source“ wird ein Formular-Element angegeben und über das Attribut „name“ eine Eigenschaft.
Beispiel: „Sichtbarkeit der Eingabekomponente st_text im Formular“:
<PROPERTY source='st_text' name='VISIBLE'/>
Attribut source
Über das Attribut „source“ kann eine einzelne Komponente oder das gesamte Formular referenziert werden.
Folgende Angaben sind möglich:
- Zugriff auf eine Eingabekomponente <PROPERTY source='name' .../>
Angegeben wird der Name einer Eingabekomponente.
Diese Angabe ermöglicht den Zugriff auf bestimmte Eigenschaften der Eingabekomponente, z. B. auf den Wert, der innerhalb der Eingabekomponente gespeichert ist. - Zugriff auf eine Gestaltungskomponente <PROPERTY source='#form.name'.../>
Angegeben wird das Objekt #form und der Name der Gestaltungskomponente in Punktnotation.
Diese Angabe ermöglicht den Zugriff auf eine Gestaltungskomponente. Dabei handelt es sich um Formularelemente, die keinen Wert aufnehmen, sondern zur Gruppierung von Formularelementen (CMS_GROUP) oder zum Einblenden von Hinweistexten (CMS_LABEL) verwendet werden. - Zugriff auf allgemeine Informationen des Formulars <PROPERTY source='#global'.../>
Angegeben wird das Objekt #global.
Diese Angabe ermöglicht den Zugriff auf allgemeine Informationen des Formulars, beispielsweise den Verwaltungstyp oder die Spracheinstellung in der das Formular aufgerufen wird.
Attribut name
Über das Attribut „name“ wird der Name einer Eigenschaft übergeben. Die folgende Tabelle gibt an, welche Eigenschaft in welchem Kontext verwendet werden kann:
Vorbedingung | Wertermittlung | Handlungs- | Validierung | |
---|---|---|---|---|
Eingabekomponente | ||||
Gestaltungskomponente | ||||
Allgemeine Formularinformationen | ||||
Folgende Eigenschaften sind möglich:
- <PROPERTY ... name='BODY/>:
Liefert den Inhaltsbereich zurück, in dem das Formular geöffnet wurde (nur für Absatzvorlagen). - <PROPERTY ... name='EDITABLE'/>:
Editierbarkeit definieren (nur Eingabekomponenten). - <PROPERTY ... name='ELEMENTTYPE'/>:
Knotentyp abfragen (nur Eingabekomponenten). - <PROPERTY ... name='EMPTY'/>:
Liefert einen booleschen Wert zurück. Eingabekomponente enthält einen Leerwert (true) oder nicht (false). - <PROPERTY ... name='ENTRY'/>:
Liefert die textuelle Version eines selektierten Wertes aus einer Auswahlliste zurück. - <PROPERTY ... name='FOCUS'/>:
Liefert einen booleschen Wert zurück. Eingabekomponente wird fokussiert (true) oder nicht (false). - <PROPERTY ... name='LANG'/>:
Liefert die Projektsprache zurück in der das Formular bearbeitet wird. - <PROPERTY ... name='LENGTH'/>:
Liefert die Länge einer Eingabe innerhalb einer Eingabekomponente. - <PROPERTY ... name='MASTER'/>:
Liefert die Mastersprache des Projekts zurück. - <PROPERTY ... name='SIZE'/>:
Liefert die Anzahl der Elemente einer FS_LIST-Eingabekomponente. - <PROPERTY ... name='STORETYPE'/>:
Liefert den Verwaltungstyp zurück in dem das Formular geöffnet wird. - <PROPERTY ... name='VALID/>:
Gültigkeit definieren (nur Eingabekomponenten). - <PROPERTY ... name='VALUE'/>:
Liefert den Wert einer Eingabekomponente zurück. - <PROPERTY ... name='VISIBLE'/>:
Sichtbarkeit definieren (für Eingabekomponenten und Gestaltungskomponenten). - <PROPERTY ... name='WEB/>:
Liefert einen booleschen Wert zurück. Formular wird im FirstSpirit ContentCreator geöffnet (true) oder nicht (false).