#cs
Das Systemobjekt #cs steht in Tabellenvorlagen zur Verfügung. Tabellenvorlagen können als datenquellen-basierende Absätze in einer Seite der Inhalte-Verwaltung verwendet werden. Bei der Ausgabe des Absatzes in einer Vorschau oder Generierung stellt #cs Informationen zur aktuellen datenquellen-basierenden Teilseite (vgl. auch Mehrfachseiten) und zum aktuellen Datensatz zur Verfügung. Dadurch ist es möglich, u.a. zu ermitteln, ob der aktuelle Datensatz der erste oder letzte der Teilseite ist, wie viele Datensätze dargestellt werden, usw.
Folgende Methoden können auf #cs angewendet werden:
Aufruf | Beschreibung | Rückgabedatentyp |
---|---|---|
#cs.contentLength | Ermittelt, wie viele Datensätze auf der aktuellen Teilseite der Mehrfachseite dargestellt werden. Die Zählung beginnt mit 1. | |
#cs.contentPosition | Liefert den Index der Teilseite in der Mehrfachseite zurück. Die Zählung beginnt mit 0. | |
#cs.currentRowNumber | Liefert die Nummer des aktuellen Datensatzes in der Teilseite zurück. | |
#cs.dataset | Liefert den aktuellen Datensatz einer Mehrfachseite zurück (zum ersten Datensatz einer Mehrfachseite siehe Ausdruck #global.dataset) | |
#cs.dataset.javaClientUrl | Liefert für Mehrfachseiten einen URL zum aktuellen Datensatz zurück. Beim Klick auf den URL wird der FirstSpirit SiteArchitect gestartet, das Projekt geladen und der aktuelle Datensatz zum Bearbeiten geöffnet. | String |
#cs.dataset.webeditUrl | Liefert einen URL zu einer Seitenreferenz zurück, in der ein bestimmter Datensatz aus der Datenquellen-Verwaltung ausgegeben wird (Mehrfachseiten). Beim Klick auf den URL wird der FirstSpirit ContentCreator gestartet, das Projekt geladen und über die Tabellenvorlage, die gewünschte Detailseite zum Bearbeiten des Datensatzes geöffnet. | String |
#cs.isEvenContentRow | Ermittelt, ob die Nummer des aktuellen Datensatzes in der Teilseite gerade ist. | Boolean |
#cs.isFirstContentRow | Ermittelt, ob der aktuelle Datensatz der erste in der Teilseite der Mehrfachseite ist. | Boolean |
#cs.isLastContentRow | Ermittelt, ob der aktuelle Datensatz der letzte in der Teilseite der Mehrfachseite ist. | Boolean |
#cs.isOddContentRow | Ermittelt, ob die Nummer des aktuellen Datensatzes in der Teilseite ungerade ist. | Boolean |
Beispiele zu #cs
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: Numerierte Ausgabe von Datensätzen
$CMS_IF(#cs.isFirstContentRow)$
<table>
$CMS_END_IF$
<tr>
<td>$CMS_VALUE(#cs.currentRowNumber + 1)$/$CMS_VALUE(#cs.contentLength)$</td>
</tr>
$CMS_IF(#cs.isLastContentRow)$
</table>
$CMS_END_IF$
Das Beispiel gibt für eine Teilseite einer Mehrfachseite aus, der wievielte Datensatz von insgesamt wie vielen Datensätzen ausgegeben wird. Zusätzlich wird beim ersten Datensatz auf der Teilseite eine öffnendes table-Tag ausgeben und beim letzten ein schließendes.
Exemplarische Ausgabe:
1/3
2/3
3/3