#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. | |
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. | |
#global.pageParams.isFirst | Ermittelt, ob die aktuelle Seite die erste aller Seiten ist. | Boolean |
#global.pageParams.isLast | Ermittelt, ob die aktuelle Seite die letzte aller Seiten ist. | Boolean |
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. | Liefert alle Parameter der Abfrage zurück. | |
#global.node.content2Params.getSelect(#global.language). | Liefert den Wert eines Abfrageparameters zurück. | String |
#global.node.content2Params.query. | Liefert den Default-Wert eines Abfrageparameters zurück. | String |
#global.node.content2Params.query. | Liefert die verwendete Abfrage der Mehrfachseite zurück. | String |
#global.node.content2Params.tableTemplate.id | Liefert die ID, der in der Mehrfachseite verwendeten Tabellenvorlage zurück. | |
#global.node.content2Params.tableTemplate.templateId | Liefert die Vorlagen-ID, der in der Mehrfachseite verwendeten Tabellenvorlage zurück. | |
#global.multiPageParams.data | Liefert eine Liste aller Datensätze der Mehrfachseite zurück. | |
#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: | |
#global.multiPageParams.data.size | Anzahl aller Datensätze der Mehrfachseite. | |
#global.multiPageParams.entitiesPerPage | Liefert zurück, wie viele Datensätze auf einer Seite dargestellt werden sollen (Einstellung Anzahl der Einträge pro Seite). | |
#global.pageParams.data | Liefert alle Datensätze einer Seite als Liste zurück. | |
#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: | |
#global.pageParams.data.size | Anzahl aller Datensätze einer Seite der Mehrfachseite. | |
#global.pageParams.offset | Liefert zurück, wie viele Datensätze vor der aktuellen Seite ausgegeben wurden. | |
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