Wertebereich des Datentyps Table
In FirstSpirit gibt es die Möglichkeit, Daten in Tabellenform zu erfassen. Solche Daten werden üblicherweise strukturiert in der Auszeichnungssprache XML abgespeichert. Dies ist notwendig, da (zusätzlich zu den Zeilen und Zellen) einige Inhalte besondere Auszeichnungen, Hervorhebungen und Informationen für bestimmte Teile enthalten müssen.
Um so gespeicherte Inhalte ausgeben oder weiterverarbeiten zu können, liefern diese Eingabekomponenten ein Objekt vom Datentyp Table zurück.
Definition über die Standard-Eingabekomponenten
Im Formularbereich einer Seiten- oder Absatzvorlage können unterschiedliche Eingabekomponenten definiert werden. Über diese Formularelemente können dann die eigentlichen redaktionellen Inhalte in die Seite einfügen werden. Die von FirstSpirit unterstützten Standard-Eingabekomponenten liefern unterschiedliche Datentypen zurück.
Die folgenden Standard-Eingabekomponenten liefern ein Objekt vom Datentyp Table zurück:
Auf diesem Objekt lassen sich dann mit Hilfe einer $CMS_VALUE(...)$-Anweisung Methoden anwenden:
$CMS_VALUE(BEZEICHNER.METHODE)$
Unter BEZEICHNER muss der Parameter resultname, der in der Eingabekomponente definiert wurde, angegeben werden.
Methoden auf Table-Objekten
In der unten angegebenen Tabellen werden alle Methoden aufgelistet, die auf Objekten von Datentyp Table aufgerufen werden können:
addColumn(int)
Methodenname |
Rückgabetyp |
Verfügbar seit |
addColumn(int) |
void |
|
Übersicht
addRow(int)
Methodenname |
Rückgabetyp |
Verfügbar seit |
addRow(int) |
void |
|
Übersicht
compareTo(Comparable)
Methodenname |
Rückgabetyp |
Verfügbar seit |
compareTo(Comparable) |
int |
|
Übersicht
deleteColumn(int)
Methodenname |
Rückgabetyp |
Verfügbar seit |
deleteColumn(int) |
void |
|
Übersicht
deleteRow(int)
Methodenname |
Rückgabetyp |
Verfügbar seit |
deleteRow(int) |
void |
|
Übersicht
diff(Element)
Methodenname |
Rückgabetyp |
Verfügbar seit |
diff(Element) |
Element |
|
Übersicht
equals(Object)
Methodenname |
Rückgabetyp |
Verfügbar seit |
equals(Object) |
boolean |
|
Übersicht
getCell(int, int)
Methodenname |
Rückgabetyp |
Verfügbar seit |
getCell(int, int) |
TableCell |
|
Ü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
Methodenname |
Rückgabetyp |
Verfügbar seit |
getClass |
Class |
|
Übersicht
getColumns
Die Methode .getColumns() (in Bean-Syntax: .columns) liefert die Anzahl der Spalten einer Tabelle zurück.
Das Rückgabeobjekt ist eine Ganzzahl (siehe java.lang.Integer).
Methodenname |
Rückgabetyp |
Verfügbar seit |
getColumns |
int |
|
Übersicht
getDom
Methodenname |
Rückgabetyp |
Verfügbar seit |
getDom |
Element |
|
Übersicht
getRows
Die Methode .getRows() (in Bean-Syntax: .rows) liefert die Anzahl der Zeilen einer Tabelle zurück.
Das Rückgabeobjekt ist eine Ganzzahl (siehe java.lang.Integer).
Methodenname |
Rückgabetyp |
Verfügbar seit |
getRows |
int |
|
Übersicht
isCase(Object)
Methodenname |
Rückgabetyp |
Verfügbar seit |
isCase(Object) |
boolean |
|
Übersicht
isEmpty
Die Methode .isEmpty() (in Bean-Syntax: .isEmpty) prüft, ob ein Ausdruck bzw. Objekt leer ist, z.B. storeElement.isEmpty(). Das Ergebnis der semantischen Prüfung hängt vom Ausdruck bzw. Objekt ab, z.B. eine Zeichenkette ist dann leer, wenn sie kein Zeichen enthält. Bei Objekten mit komplexen Werten oder Objekten entscheidet das Objekt wann es leer 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 .isEmpty() gibt einen booleschen Wert als Ergebnis der Prüfung zurück. true (=wahr) ist die Prüfung, wenn der Ausdruck bzw. das Objekt leer ist und false (=unwahr) wenn nicht.
Methodenname |
Rückgabetyp |
Verfügbar seit |
isEmpty |
boolean |
|
Ü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.
Methodenname |
Rückgabetyp |
Verfügbar seit |
isNull |
boolean |
|
Übersicht
print
Methodenname |
Rückgabetyp |
Verfügbar seit |
print |
void |
|
Übersicht
replace(Table)
Methodenname |
Rückgabetyp |
Verfügbar seit |
replace(Table) |
void |
|
Übersicht
set(String, Object)
Methodenname |
Rückgabetyp |
Verfügbar seit |
set(String, Object) |
Object |
|
Übersicht
toJson
Convert to JSON string representtion (only handles Maps, Collections, Arrays, Numbers, and Strings)
Methodenname |
Rückgabetyp |
Verfügbar seit |
toJson |
String |
4.2.14 |
Übersicht
toString
Methodenname |
Rückgabetyp |
Verfügbar seit |
toString |
String |
|
Übersicht
type
Methodenname |
Rückgabetyp |
Verfügbar seit |
type |
String |
|
Übersicht