Objekte in Formularen

In Formularen lassen sich CMS-Objekte einblenden. Auf diese Weise können viele Werte, nämlich alle Attribute des Objektes, elegant als Einheit behandelt werden und je nach Speicherort des Objektes auf einfache Weise Daten für die Dauer einer Session, permanent existierende Objekte oder Benutzerobjekte genutzt werden. Sie können auch in einem Formular normale Eingabefelder mit Objektattributen mischen, nur einen Teil von Objektattributen oder Attribute mehrerer, ganz unterschiedlicher Objekte einblenden und dabei bestimmen, ob ein Attribut vom Benutzer geändert werden darf oder nicht (read-only).

Die Einblendung der Attribute

Wenn Sie nichts weiter bei der Einblendung angeben, dann werden alle Attribute in der Reihenfolge der Klassendefinition eingeblendet. Sie können aber durch die Angabe "Attributauswahl" angeben, welche Attribute in welcher Reihenfolge auftreten und ob die Werte nur gelesen oder auch geändert werden können.

Die Attributauswahl besteht aus Einträgen, die durch Leerzeichen oder einen Umbruch getrennt werden. Ein Eintrag kann ein Attributname sein. Damit landet das Attribut in der Liste aller einzublendenden Attribute. Ist die Liste leer, so werden erst mal alle Attribute eingeblendet. Geht einem Eintrag ein "!" vorraus, so wird dieses Attribut nicht verwendet, es wird aus der Liste entfernt. Neben Attributen können auch Attributbereiche angegeben werden wie "a-d" oder zum Entfernen "!a-d". Auch können bei Bereichen der Anfang oder das Ende weggelassen werden, wenn man "von Anfang an" bzw. "bis zum Ende" meint. Die Reihenfolge der Nennungen ist wichtig: Wenn zuerst ein Attribut genannt wird und danach aus der Liste entfernt wird, so ist die letzte Operation - hier das Entfernen - ausschlaggebend. Sie können also zunächst Attribute zur Liste hinzufügen, dann wieder welche entfernen und danach (in anderer Reihenfolge) wieder hinzufügen. Auf diese Weise lassen sich die Einblendungen in der Regel kurz ausdrücken und bleiben meist auch gültig, wenn die Klasse später einmal weitere Attribute bekommt.

Um ein oder mehrere Attribute nur lesbar zu machen, stellen Sie dem Attributnamen oder dem Bereich ein "ro:" voran, also zB. "ro:a-d".

Weitere Regeln

• Wird keine Regel angegeben, so werden alle Attribute eingeblendet (entspricht "*").
• Ist die erste Regel ein Entfernen ("!..."), so wird implizit angenommen, dass von allen Attributen welche entfernet werden sollen. Dh. es wird dann mit "*" (alle Attribute) gestartet. In allen anderen Fällen wird von der leeren Liste ausgegangen.
• Attribute werden immer hinten in der Liste angehängt.
• Ist ein Attribut bereits in der Liste enthalten und wird es nochmals genannt, so ändert es nicht seine Position. Wird bei der Nennung "ro:" mit angegeben, so wird es jedoch als nur lesbar markiert.
• Alle übrigen, noch nicht eingeblendeten Attribute können mit "*" hinzugefügt werden. Sie können danach weitere Regeln angeben, zB. wieder welche entfernen oder als nur lesbar markieren.
• Sie können alle Attribute mit der Regel "ro:*" als nur lesbar einblenden.