Collection (SP-Tag)

Name

<sp:collection> - Erzeugt oder ändert eine Liste

Syntax

<sp:collection name="variable" action="add" value="come back at ${myTime}" index="2" />

Beschreibung

Mit Hilfe von sp:collection können Listen erzeugt und verändert werden. Listen können beliebige Objekte enthalten. Je nach angegebener Aktion können Listenelemente hinzugefügt, ersetzt oder gelöscht werden.

Attribute

Name	Type	Required	Default	ab IES Version
`name`	Attribute	Ja	None	1
`action`	String	Ja außer für query	None	1
`value`	String	Ja, für add und replace	None	1
`object`	Variablename	Ja, für add und replace	None	1
`index`	Expression	Ja, für remove und replace	None	1
`query`	Query	Nein	None	1
`publisher`	String	Nein	auto	1
`locale`	Locale	Nein	None	1
`scope`	Scope	Nein	request	1

name: Name der Liste.

action: xxx.

value: Ein String der mit der Liste verarbeitet werden soll.

object: Ein Objekt das mit der Liste verarbeitet werden soll. Ist object vom Typ QueryInformation, so gilt das gleiche wie beim Attribut query.

index: Listen-Position mit der eine Aktion ausgeführt werden soll.

query: Fügt in die Collection die Ergebnisse der übergebenen Suchabfrage ein. Ist dieses Attibut gesetzt, ist kein action nötig. Die Aktion entspricht einem addAll. Es kann jedoch eine andere Aktion angegeben werden.

publisher: Wird der Collection-Tag in Verbindung mit Suchabfragen verwendet (durch query oder object), ist ein Publikationsbereicht erforderlich, mit der die Suchabfrage ausgeführt werden soll. Mit diesem Attribute können ein oder mehrer Publikationsbereiche angegeben werden (durch Kommata getrennt). Entweder werden die Publikationsbereiche durch ihren Anchor angegeben oder folgende Schlüsselwörter verwentet:

locale: Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

scope: Namensraum, in dem die Variable definiert ist (siehe Abschnitt 3.1.3.1, „Variablen Bereiche (Scopes)“). Für diesen Tag ist der Page- und Request-Scope mögiich (page, request).

Beispiele

Beispiel A

Template Quelltext

xxx

Ausgabe

xxx

Beispiel B