Datentyp Card

Wertebereich des Datentyps Card

Mithilfe der Eingabekomponente FS_CATALOG können Absatz- oder Verweislisten gepflegt werden. Sie liefert ein Catalog-Objekt zurück. Dieses enthält Card-Objekte. Dabei dient Card als Vermittler zwischen einer vom Redakteur gewählten Vorlage (je nach Konfiguration von FS_CATALOG eine bestimmte, im Projekt vorhandene Absatz- oder Verweisvorlage), den in der gewählten Vorlage definierten Formularfeldern und den vom Redakteur in den Formularfeldern gespeicherten Werten. Daher ist sowohl eine Ausgabe einzelner Werte möglich (siehe 1)), als auch eine Ausgabe basierend auf der Definition des Vorlagensatzes der referenzierten (Absatz- oder Verweis-)Vorlage (siehe 2)).

1) Ausgabe einzelner Formularfelder über die Vorlage selbst

Einerseits kann auf die in FS_CATALOG gespeicherten Daten einzelner Formularfelder zugegriffen werden.

Dazu wird die Methode .getItem (in Bean-Syntax: .item) verwendet. Diese gibt ein Objekt vom Typ FormData zurück. Um an die gespeicherten Werte einer „inneren“ Eingabekomponente zu gelangen, muss zusätzlich der Bezeichner des Formularfelds angegeben werden, z. B.

<ul>
 $CMS_FOR(var, st_catalog)$
   <li>$CMS_VALUE(var.item.BEZEICHNER)$</li>
 $CMS_END_FOR$
</ul>

Dabei ist für st_catalog der Variablenname der FS_CATALOG-Komponente, für BEZEICHNER der Variablenname des betreffenden Formularfelds der Absatz- oder Verweisvorlage anzugeben.

Die Objekte werden standardmäßig sprachabhängig ausgegeben. Daher ist keine sprachabhängige Unterscheidung notwendig.

Bei einer solchen Iteration über die Elemente wie mit $CMS_FOR(...)$ stehen in den abhängigen Absatz- oder Verweisvorlagen die Systemobjekte #card, #index und #fs_catalog nicht zur Verfügung.

2) Ausgabe der "Card" über die referenzierte Vorlage

Andererseits kann für die Ausgabe der in FS_CATALOG vorhandenen Einträge die jeweils hinterlegte bzw. vom Redakteur ausgewählte Absatz- oder Verweisvorlage herangezogen werden. Dazu wird $CMS_VALUE(...)$ verwendet, z. B.

$CMS_VALUE(BEZEICHNER)$

Dabei ist für BEZEICHNER der Variablenname der FS_CATALOG-Komponente anzugeben. Die Ausgabe jedes Elements der Liste hängt dann von der Definition des Vorlagensatzes der gewählten Absatz- oder Verweisvorlage ab.

In der abhängigen Absatz- oder Verweisvorlage stehen die Systemobjekte

• #card (repräsentiert den Eintrag (Absatz oder Verweis) einer FS_CATALOG-Eingabekomponente)
• #index (ermittelt die Nummer des aktuell gerenderten Eintrags)
• #fs_catalog (ermittelt die Anzahl der in der FS_CATALOG-Eingabekomponente enthaltenen Einträge)

zur Verfügung.

Weitere Informationen zum Datentyp Card siehe API-Dokumentation:

de.espirit.firstspirit.client.access.editor.lists.Catalog$Card

Methoden auf Card-Objekten

In der unten angegebenen Tabelle werden alle Methoden aufgelistet, die auf Objekten vom Datentyp Card aufgerufen werden können:

equals(Object)

Übersicht

getClass

Die Methode .getClass() (in Bean-Syntax: .class) liefert die Klasse des aufrufendes Objektes zurück (vgl. java.lang.Class).

Aufruf:

$CMS_VALUE(myString.class)$
$CMS_VALUE(myString.getClass())$

Ausgabe:

java.lang.String

Übersicht

getId

Mit der Methode getId() (in Bean-Syntax: .id) kann die ID des entsprechenden FS_CATALOG-Eintrags ("Card") ermittelt werden. Auf diese ID kann dann beispielsweise in der Generierung zugegriffen werden. Eine solche ID kann folgendermaßen aussehen:

c84c8dae-512a-4142-9068-85208d4072fe

Syntax-Beispiel:

<p>
 $CMS_FOR(var,st_catalog)$ 
 ID: $CMS_VALUE(var.getId())$
</p>

Dabei ist var der Bezeichner für das (Listen-)Objekt, st_catalog der Variablenname der FS_CATALOG-Komponente.

Mit folgender beispielhaften Syntax kann der Text (Inhalt der Eingabekomponente st_text) eines bestimmten Eintrags (hier der FS_CATALOG-Eintrag mit der ID 7644cfe2-b117-4ec7-bc94-bb8f255d1f59) mithilfe der Hilfsmethode find(String) ausgegeben werden:

$CMS_VALUE(st_catalog.find("7644cfe2-b117-4ec7-bc94-bb8f255d1f59").get().item.st_text)$

Übersicht

getItem

Liefert den aktuellen Eintrag als FormData zurück.

Beispiel siehe oben.

Übersicht

getTemplate

Liefert die Vorlage zurück, auf der der aktuelle Eintrag der FS_CATALOG-Komponente basiert.

Übersicht

isCase(Object)

Übersicht

isNull

Die Methode .isNull() (in Bean-Syntax: .isNull) prüft, ob ein Ausdruck bzw. Objekt Null ist, z. B. storeElement.isNull(). Bei Objekten mit komplexen Werten oder Objekten entscheidet das Objekt, wann es null ist. Der Datentyp DomElement enthält beispielsweise immer ein leeres Dokument, ist also nie null. Die Prüfung einer leeren DOM-Editor-Eingabekomponente mit der Methode .isNull() liefert daher den Wert false, während die Prüfung der Komponente auf .isEmpty() den Wert true liefern würde.

Die Methode .isNull() gibt einen booleschen Wert als Ergebnis der Prüfung zurück. true (=wahr) ist die Prüfung, wenn der Ausdruck bzw. das Objekt Null ist und false (=unwahr) wenn nicht.

Übersicht

loadItem(FormData)

Übersicht

print

Übersicht

set(String, Object)

Übersicht

toJSON

Übersicht

toString

Übersicht

type

Übersicht