Startseite / Vorlagenentwicklung / Vorlagensyntax / Systemobjekte / #global / Mehrfachseiten

#global und Mehrfachseiten

In der Inhalte-Verwaltung können datenquellen-basierte Absätze angelegt werden. Die Besonderheit von Seiten, die solche Absätze enthalten ist, dass die Menge der Datensätze verteilt werden kann.

In der Struktur-Verwaltung verfügt die zugehörige Seitenreferenz über einen Reiter Daten. In diesem Reiter kann festgelegt werden, wie viele Datensätze in einer Seite und wie viele Seiten maximal erzeugt werden sollen.

Seiten, die durch die Verteilung der Datenmenge erzeugt werden, werden Mehrfachseiten genannt.

Diese Konzept gibt es nicht nur bei datenquellen-basierten Absätzen, sondern auch an anderen Stellen.

Um Informationen von Mehrfachseiten zu ermitteln, gibt es die beiden Methoden:

.multiPageParams() (Allgemein: Informationen aller erzeugten Seiten)
.pageParams() (Allgemein: Informationen einer erzeugten Seite)

Informationen aller Seiten (multiPageParams)

Mit der Methode multiPageParams können Informationen zu allen erzeugten Seiten einer Mehrfachseite abgefragt und weiter verarbeitet werden (z.B. Anzahl der Seiten).

Der Grundaufbau von multiPageParams sieht wie folgt aus:

$CMS_VALUE(#global.multiPageParams[.METHODE])$

In der nachfolgenden Tabelle sind die wichtigsten Aufrufe von multiPageParams aufgeführt:

Aufruf	Bedeutung	Rückgabedatentyp
#global.multiPageParams.pageCount	Liefert die Anzahl aller Seiten zurück.	Integer

Informationen einer Seite (pageParams)

Mit der Methode pageParams können Informationen zur aktuell erzeugten Seite abgerufen werden.

Die allgemeine Syntax von pageParams lautet:

$CMS_VALUE(#global.pageParams[.METHODE])$

Die wichtigsten Aufrufe von pageParams können aus der nachfolgenden Tabelle entnommen werden.

Aufruf	Bedeutung	Rückgabedatentyp
#global.pageParams.index	Liefert die aktuelle Seitenzahl zurück. Die Zählung beginnt mit 0.	Integer
#global.pageParams.isFirst	Ermittelt, ob die aktuelle Seite die erste aller Seiten ist.	Boolean (Boolescher Wert)
#global.pageParams.isLast	Ermittelt, ob die aktuelle Seite die letzte aller Seiten ist.	Boolean (Boolescher Wert)

Datenquellen-basierende Aufrufe

Zusätzlich zu den allgemeinen Methoden, die auf einer Mehrfachseite aufgerufen werden können, gibt es bei datenquellen-basierten Seiten noch weitere Methoden.

Die nachfolgende Liste nennt die wichtigsten:

Aufruf	Bedeutung	Rückgabedatentyp
#global.node.content2Params.query. selectStatement.parameters	Liefert alle Parameter der Abfrage zurück.	Collection<Parameter>
#global.node.content2Params.getSelect(#global.language). parameterValue("BEZEICHNER")	Liefert den Wert eines Abfrageparameters zurück.	String (Zeichenkette)
#global.node.content2Params.query. selectStatement.parameterValue("BEZEICHNER")	Liefert den Default-Wert eines Abfrageparameters zurück.	String (Zeichenkette)
#global.node.content2Params.query. selectStatementAsString	Liefert die verwendete Abfrage der Mehrfachseite zurück.	String (Zeichenkette)
#global.node.content2Params.tableTemplate.id	Liefert die ID, der in der Mehrfachseite verwendeten Tabellenvorlage zurück.	Long
#global.node.content2Params.tableTemplate.templateId	Liefert die Vorlagen-ID, der in der Mehrfachseite verwendeten Tabellenvorlage zurück.	Long
#global.multiPageParams.data	Liefert eine Liste aller Datensätze der Mehrfachseite zurück.	List<Entity>
#global.multiPageParams.data.get(GANZZAHL)	Liefert den angegebenen Datensatz aus der Liste zurück. Als Parameter ist eine Ganzzahl anzugeben. Wird eine Ganzzahl angegeben, die größer oder gleich der Anzahl der Datensätze ist, so führt dies zu einem Fehler: ERROR: Index: 5223, Size: 7...	Entity
#global.multiPageParams.data.size	Anzahl aller Datensätze der Mehrfachseite.	Integer
#global.multiPageParams.entitiesPerPage	Liefert zurück, wie viele Datensätze auf einer Seite dargestellt werden sollen (Einstellung Anzahl der Einträge pro Seite).	Integer
#global.pageParams.data	Liefert alle Datensätze einer Seite als Liste zurück.	List<Entity>
#global.pageParams.data.get(GANZZAHL)	Liefert den angegebenen Datensatz aus der Liste zurück. Als Parameter ist eine Ganzzahl anzugeben. Wird eine Ganzzahl angegeben, die größer oder gleich der Anzahl der Datensätze ist, so führt dies zu einem Fehler: ERROR: Index: 5223, Size: 7...	Entity
#global.pageParams.data.size	Anzahl aller Datensätze einer Seite der Mehrfachseite.	Integer
#global.pageParams.offset	Liefert zurück, wie viele Datensätze vor der aktuellen Seite ausgegeben wurden.	Integer

Beispiele

Nachfolgend werden einige Beispiele zur Verwendung der Anweisung innerhalb von Vorlagen gezeigt. Die Beispiele sollen die konkrete Auswirkung der Anweisung verdeutlichen und eine Hilfe für den Vorlagenentwickler bei der Erstellung eigener Vorlagen sein.

Für die Verwendung innerhalb eines Projekts, müssen die hier gezeigten Beispiele angepasst werden! Beispielsweise müssen Variablennamen auf die spezifischen Variablennamen des Projekts geändert werden, in dem die Anweisung verwendet werden soll.

1. Beispiel: Aufrechnung von Datensätzen anhand der Seitenzahl (Offset)

Offset:$CMS_VALUE(#global.pageParams.offset)$

Das Beispiel errechnet auf der aktuellen Seite, wie viele Einträge auf den vorhergehenden Seiten dargestellt wurden. Die Berechnung ist nur dann sinnvoll, wenn vom Benutzer, die Anzahl der Einträge pro Seite größer als 0 gewählt wurde. 0 würde bedeuten, dass alle Einträge auf einer Seite dargestellt würden.

Exemplarische Ausgabe:

Offset:6

Druckversion | Seitenanfang