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, dass alle Session-Informationen an die URL gehängt werden, so dass 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 Attribut sollte nur für Umstellungen von Live-Seiten verwendet werden, die sich durch den Wegfall der Kommandos ergeben. Prinzipiell sollten Live-Seiten und Webapplikationen insgesamt, 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 einen Context-Pfad mit dem 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 dann 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 dem 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 (Session) können für jedes Browserfenster weitere Windowsessions existieren. Dies ist sinnvoll, wenn die Session über ein Cookie 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, muss dieses Attribut 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 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 die zwei neuen Attribute template und handler ersetzt. Um einen Handler aufzurufen und anschließend ein Template auszuführen, ist die Definition eines Kommandos nicht mehr nötig. Um einen Handler aufzurufen 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ützt. 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 1.3)

Deprecated. Da dieses Attribut von dem Attribut information abhängt, ist auch dieses Attribut veraltet. (Siehe Attribut information).

Wird in Verbindung mit information verwendet, um zu bestimmen, aus welchem Publikationsbereich die URL erzeugt werden soll.

absolute (deprecated ab Version 1.3)

Deprecated. Da dieses Attribut von dem Attribut information abhängt, ist auch dieses Attribut veraltet. (Siehe Attribut information).

Gibt an, ob die URL die durch das Attribut information ermittelt wurde mit absolutem Pfad ausgegeben werden soll.

gui (deprecated ab Version 2.0)

Deprecated. Da dieses Attribut von dem Attribut command abhängt ist auch dieses Attribut veraltet. (Siehe Attribut command). Ein GUI war eine List von Kommandos um Live-Seiten zu realisieren. GUIs wurde durch Webapplikationen ersetzt.

Steuert, ob das aktuelle GUI an die URL angefü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>