Url (SP-Tag)

Dieser Artikel bedarf einer Überarbeitung. Näheres ist auf der Diskussionsseite angegeben. Hilf bitte mit ihn zu verbessern und entferne anschließend diese Markierung.

Name

<sp:url> - Erzeugt IES-konforme URLs

Syntax

<sp:url uri="mytest/test.spml"/>

Beschreibung

Mit dem URL-Tag werden IES-konforme URLs erzeugt. Der Tag schreibt bei abgeschalteten Cookies die SessionID in die URL und die aktuelle Window-ID zu Verwendung der Window-Session. Bei Verwendung des Handler-Attributes wird auch der Handler als Paramter an die URL gehängt.

Attribute

Name	Type	Required	Default	ab IES Version
uri	Text	Ja oder template	None	2
template	Attribute	Ja oder uri	None	2
handler	Text	Nein	None	2
module	Text	Nein	None	2
context	Text	Nein	None	2
window	Expression	Nein	true	1
command (deprecated ab Version 2.0)	Text	Ja oder uri oder information	None	1
information (deprecated ab Version 1.3)	Text	Ja oder command oder uri	None	1
publisher (deprecated ab Version 2.0)	Text	Nein	true	1
absolute (deprecated ab Version 2.0)	Expression	Nein	true	1
gui (deprecated ab Version 2.0)	Expression	Nein	true	1
locale	Locale	Nein	None	1

uri

Dies kann ein beliebiger Pfad zu einer Seite sein. sp:url sorgt dafür, das alle Session-Informationen an die URL gehängt werden, so das die Session nicht verloren geht.

template

Template aus dem eine URL generiert werden soll. Alle Templates des IES liegen als SPML-Seiten im System. sp:url ermittelt die SPML-Seite des Templates und gibt sie aus. Dieses Attribute sollte nur für Umstellungen von Live-Seiten verwendet werden, die sich durch den Wegfall der Kommandos ergeben. Prinzipiell sollte Live-Seiten und insgesamt Webapplikationen nicht mit Templates, sondern mit SPML-Seite realisiert werden.

handler

Handler der vor dem Aufruf, der mit uri oder template angegebenen Seite, ausgeführt werden soll.

module

SPML-Seiten sind immer Teil einer Webapplikation. Jede Webapplikation besitzt eine Context-Pfad mit der die URL beginnt (Es existert auch ein ROOT-Context-Pfad (/)). Soll die URL einer Seite herausgeschrieben werden, die in einer anderen Webapplikation liegt, so wird mit diesem Attribut die ID dieser Webapplikation angegeben. Somit wird die URL auch richtig erzeugt, wenn sich der Context der Ziel-Webapplikation ändert.

context

SPML-Seiten sind immer Teil einer Webapplikation. Jede Webapplikation besitzt eine Context-Pfad mit der die URL beginnt (Es existert auch ein ROOT-Context-Pfad (/)). Soll die URL einer Seite herausgeschrieben werden, die in einer anderen Webapplikation liegt, so wird mit diesem Attribut der Context-Pfad angegeben. Context-Pfade von Webapplikationen können sich ändern. Damit auch bei solchen Änderungen die URL richtig generiert wird sollte in den meisten Fällen eher das Attribut module verwendet werden.

window

Innerhalb einer Sesssion (Browsersession) können für jedes Browserfenster weitere Windowsessions existieren. Dies ist sinnvoll, wenn die Browsersession über ein Cookies gehalten wird und dennoch unterschiedliche Sessions in einem Browser benötigt werden. Existiert so eine Windowsession wird die ID dieser Session mit an die URL gehangen. Um dies zu verhindern, muß dieses Attribute auf false gesetzt werden.

command (deprecated ab Version 2.0)

Deprecated. Dieses Attribut ist veraltet und wird in zukünftigen Versionen nicht mehr unterstüzt werden. Kommandos wurden in der Version 2.0 abgeschafft zugunsten einer flexibleren Lösung abgeschafft. Ein Kommando bestand aus einem Template mit einem optionalen Handler. Für jede Template-Handler-Kombination musste ein eigenes Kommando angelegt werden. Diese Verbindung wurde aufgebrochen und durch zwei neue Attribute template und handler ersetzt. Um einen Handler aufzurufen und anschließend ein Template auszuführen ist nun die Definition eines Kommandos nicht mehr nötig. Um einen Handler auszurufen und anschließend ein Template auszuführen verwenden sie die beiden Attribute handler und template. Um einen Handler aufzurufen und anschließend eine SPML-Seite auszuführen verwenden sie die Attribute handler und uri.

Existierendes Command. Muss im GUI definiert worden sein.

information (deprecated ab Version 1.3)

Deprecated. Dieses Attribute ist veraltet und wird in zukünftigen Versionen nicht mehr unterstütz werden. sp:url wurde in in früheren Versionen auch dazu verwendet die URL eines generierten Artikels zu ermitteln. Welche URL herausgeschieben werden sollte wurde auch noch über die Attribute publisher und absolute gesteuert. Für diesen Zweck sollte sp:url nicht mehr verwendet werden. Statt dessen sollten die Attribute url, relativeUrl, absoluteUrl und die Methoden url(), relativeUrl() oder absoluteUrl() der Objecte Article, Media und Resource verwendet werden.

Artikel dessen URL geschrieben werden soll.

publisher (deprecated ab Version 2.0)

???.

absolute (deprecated ab Version 2.0)

Gibt an, ob die URL die durch das Attribute information ermittelt wurde mit absolutem Pfad ausgegeben werden soll. Verwenden sie anstelle dieses Attributes die Funktion url(), relativeUrl() oder absoluteUrl() der Artikel-Objekte.

gui (deprecated ab Version 2.0)

Steuert, ob das aktuelle GUI an die URL gefügt werden soll (nur in Verbindung mit command notwendig). Wird ab IES Version 2 nicht mehr ausgewertet, da keine GUIs mehr existieren. Sie werden durch Live-Seiten und Webapplikationen abgelöst.

locale

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

Beispiele

URL ausgeben

Template Quelltext

<a href="<sp:url uri="mytest/test.spml"/>;parameter1=a;parameter2=b">show</a>