Startseite / Vorlagenentwicklung / Vorlagensyntax / Systemobjekte / #cs

#csVerfügbar ab FirstSpirit-Version 4.0

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.
Synonym zu #global.pageParams.data.size.

Integer

#cs.contentPosition

Liefert den Index der Teilseite in der Mehrfachseite zurück. Die Zählung beginnt mit 0.
Synonym zu #global.pageParams.index.

Integer

#cs.currentRowNumber

Liefert die Nummer des aktuellen Datensatzes in der Teilseite zurück.

Integer

#cs.dataset

Liefert den aktuellen Datensatz einer Mehrfachseite zurück (zum ersten Datensatz einer Mehrfachseite siehe Ausdruck #global.dataset)

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.
Informationen zum Anfordern von URLs über die FirstSpirit-Developer-API siehe ClientUrls anfragen.

String
(Zeichenkette)

#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.
Informationen zum Anfordern von URLs über die FirstSpirit-Developer-API siehe ClientUrls anfragen.

String
(Zeichenkette)

#cs.isEvenContentRow

Ermittelt, ob die Nummer des aktuellen Datensatzes in der Teilseite gerade ist.

Boolean
(Boolescher Wert)

#cs.isFirstContentRow

Ermittelt, ob der aktuelle Datensatz der erste in der Teilseite der Mehrfachseite ist.
Synonym zu #global.pageParams.isFirst.

Boolean
(Boolescher Wert)

#cs.isLastContentRow

Ermittelt, ob der aktuelle Datensatz der letzte in der Teilseite der Mehrfachseite ist.
Synonym zu #global.pageParams.isLast.

Boolean
(Boolescher Wert)

#cs.isOddContentRow

Ermittelt, ob die Nummer des aktuellen Datensatzes in der Teilseite ungerade ist.

Boolean
(Boolescher Wert)

   

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.

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: 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

© 2005 - 2021 e-Spirit AG | Alle Rechte vorbehalten. | FirstSpirit 2021-03 | Datenschutz | Impressum | Kontakt