Startseite
Startseite

Startseite / Vorlagenentwicklung / Vorlagensyntax / Systemobjekte / #docGroup

#docGroupVerfügbar ab FirstSpirit-Version 4.0

Das Systemobjekt #docGroup wird im Kontext von Dokumentengruppen verwendet und steuert die Generierung von Dokumenten. Es verweist auf den ("virtuellen") Wurzelknoten einer Dokumentengruppe. Über die Punkt-Notation stellt dieses Systemobjekt verschiedene Methoden bereit, über die beispielsweise ein Inhaltsverzeichnis generiert werden kann.

Wichtig In der Regel kann auf Systemobjekte nur lesend zugegriffen werden. Es gibt jedoch einige Methoden, die Systemobjekte auch modifizieren oder das Systemverhalten beeinflussen können. Hierunter fällt z.B. die Ausgabe der Elemente einer Dokumentengruppe während der Generierung (vgl. #docGroup.pageFirst).

Nachfolgend sind die einzelnen Methodenaufrufe aufgeführt:

Aufruf

Bedeutung

#docGroup.childs

Liefert eine Liste der Kind-Knoten der Dokumentengruppe zurück. Jedes Kind ist wieder vom gleichen Typ wie #docGroup. Die Liste der Kinder enthält zunächst Knoten vom Typ "Seitenreferenz", gefolgt von Knoten des Typs "Menüebene".

#docGroup.depth

Liefert die Tiefe des Knotens in der Dokumentengruppe zurück (z.B. "0" für die oberste Ebene). Zum Vergleich: Knoten der Liste #docGroup.childs haben die Tiefe 1.

#docGroup.isFolder

Ermittelt, ob der Knoten vom Typ "Menüebene" ist (Wert true) oder nicht (Wert false).

#docGroup.isPageRef

Ermittelt, ob der Knoten vom Typ "Seitenreferenz" ist (Wert true) oder nicht (Wert false).

#docGroup.index

Liefert den Index des Knotens in der "childs"-Liste des Vaterknotens zurück.

#docGroup.parent

Liefert den Vaterknoten des Elements zurück. Handelt es sich bei docGroup bereits um den Wurzelknoten, wird null zurückgeliefert.

#docGroup.selected

Liefert den Wert true zurück, wenn der Knoten selber oder ein Kindknoten gerade in die Ausgabe geschrieben wird.

#docGroup.label

Liefert die Überschrift des Knotens zurück. Entspricht bei der Wurzel dem Namen der Dokumentengruppe, bei Menüebenen dem Menünamen und bei Seitenreferenzen dem Sitemap-Namen.

#docGroup.chapter

Liefert die Kapitelnummer zurück, z.B. ein Text in der Form "2.3.1".

#docGroup.section

Liefert die Kapitelnummer zurück, im Gegensatz zu #docGroup.chapter werden allerdings mit #docGroup.section nur Ordner in die Kapitelnummerierung einbezogen.

#docGroup.root

Liefert das virtuelle Wurzelelement zurück (entspricht dem Wert von #docGroup).

#docGroup.pageFirst

Der Wert sollte in der Startvorlage auf true gesetzt werden (über den Ausdruck $CMS_SET(...)$), wenn Seiten vor Ordnern ausgegeben werden sollen. Die Ausgabe innerhalb der Vorlage kann über den Ausdruck $CMS_VALUE(...)$ erfolgen.

  
Wichtig Weitere Informationen zur Arbeit mit Dokumentengruppen sowie Beispiele finden sich im Bereich Dokumentengruppen.

© 2005 - 2015 e-Spirit AG | Alle Rechte vorbehalten. | Letzte Änderung: 2013-12-09