Startseite
Startseite

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:

  1. .multiPageParams() (Allgemein: Informationen aller erzeugten Seiten)
  2. .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.

Wichtig 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

© 2005 - 2015 e-Spirit AG | Alle Rechte vorbehalten. | Letzte Änderung: 2014-07-21