Url (SP-Tag)

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
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>