SiteparkWiki - Benutzerbeiträge [de]

Textarea (SP-Tag)

2008-11-12T10:09:11Z

Schramek: /* Attribute */

==Name==
<sp:textarea> - Erzeugt ein mehrzeiliges Textfeld

==Syntax==
<source lang="xml">
<sp:textarea name="variable"/>
</source>

==Beschreibung==
Der Textarea-Tag erzeugt ein HTML-Textarea-Feld (siehe auch <code>[[spt:textarea]]</code>, <code>[[spt:smarteditor]]</code> und <code>[[spt:tinymce]]</code>).

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Intro===

Textarea mit den Dynamischen Attributen cols und rows
<source lang="xml">
Einleitungstext<br>
<sp:textarea name="sp_intro" cols="58" rows="10"/>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Textimage (SP-Tag)

2008-11-12T10:09:08Z

Schramek: /* Attribute */

==Name==
<sp:textimage> - Wandelt einen Text in ein Bild um

==Syntax==
<source lang="xml">
<sp:textimage
name="variable"
scope="page"
text="ein text von ${name}"
width="100"
height="15"
fontname="Arial"
fontsize="12"
fontstyle="bold"
fontcolor="AAAAAA"
background="000000"
gravity="c"
offset="2,5"
/>
</source>

==Beschreibung==
Mit diesem Tag könne aus Texten Bilder generiert werden. Über das <code>text</code>-Attribut wird der Text angegeben, aus dem das Bild erzeugt werden soll. Die Angabe von Höhe und Breite ist optional. Werden Höhe und Breite nicht angegeben, ergibt sich die Abmessung des Bildes aus Textlänge, Schriftgröße etc.

Dieser Tag verhält sich in [[Template-Modus|In-]] und [[Template-Modus|Out-Modus]] unterschiedlich.

;Out-Modus
:Wird <code>sp:textimage</code> im [[Template-Modus|Out-Modus]] betrieben, wird das verkleinerte Bild in einem Verzeichnis ''textimage'' unterhalb des Medien-Verzeichnises des Artikels abgelegt.
;In-Modus
:Wird <code>sp:textimage</code> im [[Template-Modus|In-Modus]] betrieben, wird das verkleinerte Bild in der [[BinDB]] abgelegt.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 2
|-
| <code>text</code>
| [[Text]]
| Ja
| None
| 2
|-
| <code>width</code>
| [[Expression]]
| Nein
| None
| 2
|-
| <code>height</code>
| [[Expression]]
| Nein
| None
| 2
|-
| <code>fontname</code>
| [[Text]]
| Nein
| Arial
| 2
|-
| <code>fontsize</code>
| [[Expression]]
| Nein
| 12
| 2
|-
| <code>fontstyle</code>
| [[Text]]
| Nein
| plain
| 2
|-
| <code>fontcolor</code>
| [[Text]]
| Nein
| 000000
| 2
|-
| <code>background</code>
| [[Text]]
| Nein
| FFFFFF
| 2
|-
| <code>gravity</code>
| [[Text]]
| Nein
| c
| 2
|-
| <code>offset</code>
| [[Text]]
| Nein
| 0,0
| 2
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 2
|-
| <code>scope</code>
| [[Scope]]
| Nein
| request
| 2
|}

;<code>name</code>
:Name der Variable für den Zugriff auf das [[TextImage]]-Objekt.

;<code>text</code>
:Text der als Bild umgewandelt werden soll.

;<code>width</code>
:Breite des Bildes.

;<code>height</code>
:Höhe des Bildes.

;<code>fontName</code>
:Name des zu verwendenden Zeichensatzes - muss unter dem angegebenem Namen auf dem IES-Server verfügbar sein.

;<code>fontSize</code>
:Schriftgröße.

;<code>fontStyle</code>
:Schriftstil. Mögliche Werte sind <code>plain</code>, <code>bold</code> und <code>italic</code>.

;<code>fontColor</code>
:Schriftfarbe.

;<code>background</code>
:Hintergrundfabe.

;<code>gravity</code>
:Ausrichtung der Schrift auf dem Bild.
:;c, center
::Schrift zentrieren
:;n, north
::Am oberen Rand ausrichten
:;ne, northeast
::Am oberen-rechten Rand ausrichten
:;e, east
::Am rechten Rand ausrichten
:;se, southeast
::Am unteren-rechten Rand ausrichten
:;s, south
::Am unteren Rand ausrichten
:;sw, southwest
::Am unteren-linken Rand ausrichten
:;w, west
::Am linken Rand ausrichten
:;nw, northwest
::Am oberen-linken Rand aurichten

;<code>offset</code>
:Der Offset wird mit zwei Kommata getrennten Zahlen angegeben. Der erste Wert gibt den x-offset (vertikale Verschiebung), der zweite den y-offset (horizontale Verschiebung) an.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

;<code>scope</code>
:[[Scope|Gültigkeitsbereich]], in dem die Variable definiert ist. Möglich sind <code>page</code> und <code>request</code>.

==Beispiele==

===Textbild erzeugen===

Template Quelltext
<source lang="xml">
<sp:textimage name="textImage" text="${myLink.systemlink.email}">
url: <sp:print name="textImage.url"/>
</source>

Ausgabe
<source lang="text">
url: /test/test.html.media/textimage/11400032033.png
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Url (SP-Tag)

2008-11-12T10:09:05Z

Schramek: /* Attribute */

{{Überarbeiten}}
==Name==
<sp:url> - Erzeugt IES-konforme URLs

==Syntax==
<source lang="xml">
<sp:url uri="mytest/test.spml"/>
</source>

==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==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>uri</code>
| [[Text]]
| Ja oder <code>template</code>
| None
| 2
|-
| <code>template</code>
| [[Attribute]]
| Ja oder <code>uri</code>
| None
| 2
|-
| <code>handler</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>module</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>context</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>window</code>
| [[Expression]]
| Nein
| true
| 1
|-
| <code>command ([[deprecated#2.0|deprecated]] ab Version 2.0)</code>
| [[Text]]
| Ja oder <code>uri</code> oder <code>information</code>
| None
| 1
|-
| <code>information ([[deprecated#1.3|deprecated]] ab Version 1.3)</code>
| [[Text]]
| Ja oder <code>command</code> oder <code>uri</code>
| None
| 1
|-
| <code>publisher ([[deprecated#2.0|deprecated]] ab Version 2.0)</code>
| [[Text]]
| Nein
| true
| 1
|-
| <code>absolute ([[deprecated#2.0|deprecated]] ab Version 2.0)</code>
| [[Expression]]
| Nein
| true
| 1
|-
| <code>gui ([[deprecated#2.0|deprecated]] ab Version 2.0)</code>
| [[Expression]]
| Nein
| true
| 1
|-
{{sp_common_attributes|attribute=locale|mode=row}}
|}

;<code>uri</code>
: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.

;<code>template</code>
: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 [[Webapplication|Webapplikationen]] nicht mit Templates, sondern mit SPML-Seite realisiert werden.

;<code>handler</code>
:Handler der vor dem Aufruf, der mit <code>uri</code> oder <code>template</code> angegebenen Seite, ausgeführt werden soll.

;<code>module</code>
:SPML-Seiten sind immer Teil einer [[Webapplication|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.

;<code>context</code>
:SPML-Seiten sind immer Teil einer [[Webapplication|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 <code>module</code> verwendet werden.

;<code>window</code>
:Innerhalb einer ([[SPEL#Session_Scope|Session]]) können für jedes Browserfenster weitere [[SPEL#Window_Scope|Windowsessions]] existieren. Dies ist sinnvoll, wenn die Session ü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 <code>false</code> gesetzt werden.

;<code>command</code> ([[deprecated#2.0|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 <code>template</code> und <code>handler</code> 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 aufzurufen und anschließend ein Template auszuführen verwenden sie die beiden Attribute <code>handler</code> und <code>template</code>. Um einen Handler aufzurufen und anschließend eine SPML-Seite auszuführen verwenden sie die Attribute <code>handler</code> und <code>uri</code>.''

:Existierendes Command. Muss im GUI definiert worden sein.

;<code>information</code> ([[deprecated#1.3|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 <code>publisher</code> und <code>absolute</code> gesteuert. Für diesen Zweck sollte sp:url nicht mehr verwendet werden. Statt dessen sollten die Attribute <code>url</code>, <code>relativeUrl</code>, <code>absoluteUrl</code> und die Methoden <code>url()</code>, <code>relativeUrl()</code> oder <code>absoluteUrl()</code> der Objecte [[Article]], [[Media]] und [[Resource]] verwendet werden.

:Artikel dessen URL geschrieben werden soll.

;<code>publisher</code> ([[deprecated#1.3|deprecated]] ab Version 1.3)
:'''''Deprecated.''' Da dieses Attribut von dem Attribut <code>information</code> abhängt ist auch dieses Attribut veraltet. (Siehe Attribut <code>information</code>).

:Wird in Verbindung mit <code>information</code> verwendet, um zu bestimmten von welchem Publikationsbreich die URL erzeugt werden soll.

;<code>absolute</code> ([[deprecated#1.3|deprecated]] ab Version 1.3)
:'''''Deprecated.''' Da dieses Attribut von dem Attribut <code>information</code> abhängt ist auch dieses Attribut veraltet. (Siehe Attribut <code>information</code>).

:Gibt an, ob die URL die durch das Attribute <code>information</code> ermittelt wurde mit absolutem Pfad ausgegeben werden soll.

;<code>gui</code> ([[deprecated#2.0|deprecated]] ab Version 2.0)
:'''''Deprecated.''' Da dieses Attribut von dem Attribut <code>command</code> abhängt ist auch dieses Attribut veraltet. (Siehe Attribut <code>command</code>). Ein GUI war eine List von Kommandos um [[Live-Seiten]] zu realisieren. GUI's wurde durch [[Webappliation|Webapplikationen]] ersetzt.

:Steuert, ob das aktuelle GUI an die URL gefügt werden soll (nur in Verbindung mit <code>command</code> notwendig). Wird ab [[IES]] Version 2 nicht mehr ausgewertet, da keine GUIs mehr existieren. Sie werden durch [[Live-Seiten]] und [[Webapplication|Webapplikationen]] abgelöst.
{{sp_common_attributes|attribute=locale|mode=desc}}

==Beispiele==

===URL ausgeben===

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

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Text (SP-Tag)

2008-11-12T10:08:12Z

Schramek: /* Attribute */

==Name==
<sp:text> - Erzeugt ein einzeiliges Texteingabefeld

==Syntax==
<source lang="xml">
<sp:text name="sp_external_link" value="http://" />
</source>

==Beschreibung==
Der Text-Tag erzeugt ein HTML-Input-Feld (siehe auch [[spt:text]], [[spt:number]] und [[spt:date]]).

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=format|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=format|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Überschrift===

Template Quelltext
<source lang="xml">
Überschrift<br>
<sp:text name="sp_title" size="60"/>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Sort (SP-Tag)

2008-11-12T10:07:51Z

Schramek: /* Attribute */

==Name==
<sp:sort> - Sortiert eine Liste

==Syntax==
<source lang="xml">
<sp:sort name="sortedList" collection="listToSort" keys="lastName, birthday" sequences="desc, asc" types="text, number" locale="en"/>
</source>

==Beschreibung==
Der Sort-Tag sortiert eine Liste nach den angegeben Sortierkriterien (<code>keys</code>). Zu jedem Sortierkriterium kann eine Sortierreihenfolge (<code>sequences</code>) angegben werden, die bestimmt ob auf- oder absteigend sortiert werden soll. Weiter kann für jedes Sortierkriterium ein Sortiertyp (<code>types</code>) angegeben werden, um zu bestimmen, ob Zeichenketten oder Zahlen sortiert werden sollen.

Punkte, Leerzeichen und Bindestriche werden bei der Text-Sortierung nicht berücksichtigt. Für Umlaute und Groß- Kleinbuchstaben gilt folgende Reihenfolge: a, A, ä, Ä, aa, Aa, äa, Äa, ad, Ad, ae, Ae

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>collection</code>
| [[Collection]]
| Ja
| None
| 1
|-
| <code>keys</code>
| kommaseparierte Liste von [[Text|Texten]]
| Nein
| das Element selbst
| 1
|-
| <code>sequences</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>asc</code> für alle Sortierkriterien
| None
| 1
|-
| <code>types</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>text</code> für alle Sortierkriterien
| None
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|}

;<code>name</code>
:Name der sortierten Liste.

;<code>collection</code>
:Name der zu sortierenden Liste.

;<code>keys</code>
:Die Sortierkriterien nach denen die Elemente der Liste sortiert werden sollen. Diese Parameter ist optional. Ist kein Sortierkriterium angegeben, so wird das Element selber für die Sortierung verwendet. Dies ist Beispielsweise der Fall, wenn die Liste nicht aus Elementen sondern aus einfachen Zeichenketten besteht. Die Objekte der Liste haben keine Attribute und es soll nach den Zeichenketten selbst sortiert werden.

;<code>sequences</code>
:Für jedes Sortierkriterium muss eine Sortierreihenfolge festgelegt werden, mit der bestimmt wird ob mit dem Sortierkriterium aufsteigend (<code>desc</code>), absteigend (<code>asc</code>) oder zufällig (<code>random</code>) sortiert wird. Ist kein Sortierkriterium angegeben muss genau eine Sortierreihenfolge angegeben werden.

;<code>types</code>
:Für jedes Sortierkriterium muss ein Sortiertyp festgelegt werden, der bestimmt, wie sortiert wird. Dabei ist eine Sortierung von Zeichenketten (<code>text</code>) oder eine Sortierung von Zahlen (<code>number</code>) möglich. Ist kein Sortierkriterium angegeben muss genau ein Sortiertyp angegeben werden.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

==Beispiele==

===Auf- und absteigende Sortierung===

Template Quelltext
<source lang="xml">
<sp:collection name="names" action="add" value="Dr. Peter Pan"/>
<sp:collection name="names" action="add" value="Karsten Müller"/>
<sp:collection name="names" action="add" value="Gaby Schmidt"/>
<sp:collection name="names" action="add" value="Dr. Hams-Peter Schlau"/>
<sp:collection name="names" action="add" value="Dr. Heinz-Rüdiger Schlauer"/>
<sp:collection name="names" action="add" value="Tina Meier"/>
<sp:collection name="names" action="add" value="Marion Hempel"/>
<sp:collection name="names" action="add" value="Jörg Jürgens"/>
<sp:collection name="names" action="add" value="Adam Apfel"/>
<sp:collection name="names" action="add" value="100-900"/>
<sp:collection name="names" action="add" value="20-30"/>
<sp:collection name="names" action="add" value="-"/>
<sp:collection name="names" action="add" value="-F"/>
<sp:collection name="names" action="add" value="*"/>

Unsortierte Liste:<br>
<sp:loop collection="names" item="it">
<sp:print name="it"/>
</sp:loop>

Liste aufsteigend sortieren:
<sp:sort name="sortedList" collection="names" sequences="desc"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
<br>
Liste absteigend sortieren:
<sp:sort name="sortedList" collection="names"/>
<sp:iterator collection="sortedList" item="it">
<sp:print name="it"/>
</sp:iterator>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
Dr. Peter Pan
Karsten Müller
Gaby Schmidt
Dr. Hams-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Tina Meier
Marion Hempel
Jörg Jürgens
Adam Apfel
100-900
20-30
-
-F
*

Liste aufsteigend sortieren:
Tina Meier
Marion Hempel
Karsten Müller
Jörg Jürgens
Gaby Schmidt
-F
Dr. Peter Pan
Dr. Heinz-Rüdiger Schlauer
Dr. Hams-Peter Schlau
Adam Apfel
20-30
100-900
*
-

Liste absteigend sortieren:
-
*
100-900
20-30
Adam Apfel
Dr. Hams-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Dr. Peter Pan
-F
Gaby Schmidt
Jörg Jürgens
Karsten Müller
Marion Hempel
Tina Meier
</source>

===Zeichenketten und Zahlen sortieren===

Template Quelltext
<source lang="xml">
<sp:collection name="numbers" action="add" value="1092"/>
<sp:collection name="numbers" action="add" value="-64"/>
<sp:collection name="numbers" action="add" value="16"/>
<sp:collection name="numbers" action="add" value="403.56"/>
<sp:collection name="numbers" action="add" value="-1056.0998"/>
<sp:collection name="numbers" action="add" value="59"/>
<sp:collection name="numbers" action="add" value="0.56"/>

Unsortierte Liste:
<sp:iterator collection="numbers" item="it">
<sp:print name="it"/>
</sp:iterator>

Liste als Zeichenkette Sortieren:
<sp:sort name="sortedList" collection="numbers"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>

Liste als Zahlen Sortieren:
<sp:sort name="sortedList" collection="numbers" types="number"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
1092
-64
16
403.56
-1056.0998
59
0.56

Liste als Zeichenkette Sortieren:
0.56
-1056.0998
1092
16
403.56
59
-64

Liste als Zahlen Sortieren:
-1056.0998
-64
0.56
16
59
403.56
1092
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Set (SP-Tag)

2008-11-12T10:07:45Z

Schramek: /* Attribute */

==Name==
<sp:set> - Setzt Variablen

==Syntax==
<source lang="xml">
<sp:set name="variable" value="Her name is ${name}"/>
</source>

==Beschreibung==
Mit dem Set-Tag können eigene Variablen innerhalb eines Templates definiert werden. Mit Hilfe des Attributes [[scope]] kann der Gültigkeitsbereich der Variable bestimmt werden. Mit sp:set können [[Text|Zeichenketten]], [[Expression|Expressions]] oder [[Object|Objekte]] (als Attribut angegeben) für eine Variable gesetzt werden. Bei overwrite gleich false, wird die Variable nur gesetzt wenn sie noch nicht existiert oder leer ist.

Werte können über die Attribute value, expression, condition oder object gesetzte werden. Alternativ ist es auch möglich den Wert im Body des Tags zu setzten. Hierbei wird zunächst der Body ausgeführt und das Ergebnis verwendet

<source lang="xml">
<sp:set name="output">Die Aufgabe mit Ergebnis: <sp:print name="abc"/></sp:set>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>value</code>
| [[Text]]
| Ja, oder expression bzw. condition bzw.object oder im Body des Tags
| None
| 1
|-
| <code>expression</code>
| [[Expression]]
| Ja oder value bzw. object bzw. condition oder im Body des Tags
| None
| 1
|-
| <code>condition</code>
| [[Condition]]
| Ja oder value bzw. object bzw. expresson oder im Body des Tags
| None
| 2
|-
| <code>object</code>
| [[Attribute]]
| Ja oder value bzw. expression bzw. condition oder im Body des Tags
| None
| 1
|-
| <code>default</code>
| [[Text]]
| Nein
| None
| 2.0.2
|-
| <code>overwrite</code>
| [[Condition]]
| Nein
| None
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>scope</code>
| [[Scope]]
| Nein
| request
| 1
|}

;<code>name</code>
:Name der neuen Variable.

;<code>value</code>
:Zu setzender Wert. Dieser wird immer als Zeichenkette ausgewertet.

;<code>expression</code>
:Die [[Expression]] wird ausgewertet und als Wert in die Variable geschrieben.

;<code>condition</code>
:Die [[Condition]] wird ausgewertet und als Bedingung in die Variable geschrieben.

;<code>object</code>
:Evaluiert das Attribut und setzt den evaluierten Wert. Im Gegensatz zu <code>value</code> wird hier das Object gespeichert und nicht der Text.

;<code>default</code>
:Der Text, der verwendet wird, wenn der Inhalt von value, expression und body leer sind.

;<code>overwrite</code>
:Bestimmt, ob eine evtl. vorhandene Variable überschrieben werden soll. true bzw. false.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

;<code>scope</code>
:Gültigketisbereich, in dem die Variable definiert ist. Möglich sind page und request.

==Beispiele==

===Variablen setzten===

Template Quelltext
<source lang="xml">
<sp:set name="a" value="10"/>
<sp:set name="b" value="20"/>

<sp:set name="c" expression="${a} + ${b}"/>

<sp:set name="abc" value="a + b = ${c}"/>

<sp:set name="output">Die Aufgabe mit Ergebnis: <sp:print name="abc"/></sp:set>

<sp:print name="output"/>
</source>

Ausgabe
<source lang="text">
Die Aufgabe mit Ergebnis: a + b = 30
</source>

Conditions beim set-Tag
<source lang="xml">
<sp:set name="even" condition="${myValue}%2 == 0"/>
<sp:if condition="${even}">gerade</sp:if>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Scaleimage (SP-Tag)

2008-11-12T10:07:39Z

Schramek: /* Attribute */

==Name==
<sp:scaleimage> - Verkleinert Bilder

==Syntax==
<source lang="xml">
<sp:scaleimage
name="variable"
scope="page"
object="${myImageLink.link}"
width="40"
height="40"
padding="on"
background="0000FF"
/>
</source>

==Beschreibung==
Bilder die im [[IES]] abgelegt wurden, können mit Hilfe dieses Tags verkleinert werden (z.B. für Thumbnails). Dieser Tag kann sowohl im Eingabe- wie auch im Ausgabemodus verwendet werden. Mit dem object-Attribut wird das zu verkleinernde Bild angegeben. Mit den Attributen width und height wird die Größe des Bildes definiert. Wird nur die Breite oder nur die Höhe angegeben, ergibt sich der Wert aus dem proportionalen Seitenverhältnis des Bildes. Die Daten des klein gerechneten Bildes werden in einem [[ScaleImage]]-Objekt abgelegt, das über den im Attribut <code>name</code> angegebenen Variablennamen erreichbar ist.

Für die Skalierung von Bildern gelten folgende Regeln:
* Ein Bild wird immer proportional verkleinert. Die Seitenverhältnisse des Bildes bleiben stets erhalten.
* Bilder werden nicht vergößert

Die Verkleinerung des Bildes kann in drei unterschiedlichen Modi erfolgen:

;kein Padding (padding="off")
:Mit den Attributen <code>width</code> und <code>height</code> wird die Größe für ein Bild definiert. Das Bild wird so verkleinert, das es komplett in den angegebenen Rahmen passt. Hierbei ist es möglich das entweder die Höhe oder die Breite des verkleinerten Bildes kleiner als der definierte Wert ist. Soll z.B. ein 500x500 Pixel großes Bild auf 100x50 Pixel verkleinert werden, wird das verkleinerte Bild 50x50 Pixel groß sein. Ist die definierte Größe größer als das Original so bleibt das Bild unverändert.

;Padding (padding="on")
:Mit den Attributen <code>width</code> und <code>height</code> wird die Größe für ein Bild definiert. Das Bild wird so verkleinert, das es komplett in den angegebenen Rahmen passt. Hierbei ist es möglich das entweder die Höhe oder die Breite des verkleinerten Bildes kleiner als der definierte Wert ist. In diesem Fall wird das Bild rechts und links, bzw. oben und unten mit einem Padding aufgefüllt. Die Farbe für das Padding wird mit dem Attribut background angegeben. Soll z.B. ein 500x500 Pixel großes Bild auf 100x50 Pixel verkleinert werden, wird das verkleinerte Bild 50x50 Pixel groß sein und erhält link und rechts einen 25 Pixel breiten Balken in der angegebene background-Farbe.Ist die definierte Größe größer als das Original wird das Bild mit der background-Farbe aufgefüllt, so das in jedem Fall die definierte Größe erreicht wird.

;Fit-Padding (padding="fit")
:Mit den Attributen <code>width</code> und <code>height</code> wird die Größe für ein Bild definiert. Dabei wird das Bild soweit verkleinert, bis entweder die Höhe oder die Breite in den Rahmen passt. Dabei ist es möglich, das entweder die linke- und rechte- oder ober- und unter-Seite über den Rahmen herausragen. Die überstehenden Seiten werden Abgeschnitten um die angegebene Größe zu erreichen. Soll z.B. ein 500x500 Pixel großes Bild auf 100x50 Pixel verkleinert werden, wird das verkleinerte Bild 100x100 Pixel groß sein. Anschließend werden noch oben und unten 25 Pixel abgeschnitten um die angegebene größe von 100x50 Pixel zu erreichen. Ist die definierte Größe größer als das Original wird das Bild mit der background-Farbe aufgefüllt, so das in jedem Fall die definierte Größe erreicht wird.

Im Padding und Fit-Padding Modus ist immer sichergestellt, das die angegebene Bildgröße erreicht wird.

Dieser Tag verhält sich im [[Template-Modus|In-]] und im [[Template-Modus|Out-Modus]] unterschiedlich.

;Out-Modus
:Wird <code>sp:scaleimage</code> im [[Template-Modus|Out-Modus]] betrieben, wird das verkleinerte Bild in einem Verzeichnis parallel zu dem Original abgelegt. Der Verzeichnisname besteht aus dem Dateinamen des originalen Bildes mit dem Zusatz ''.scaled'' (z.B. logo.jpg.scaled für ein Bild logo.jpg). Die Bilder werden während des Publizier-Vorgangs berechnet sowie jedes mal, wenn sich das Original geändert hat.

;In-Modus
:Wird sp:scaleimage im [[Template-Modus|In-Modus]] betrieben, liegen die verkleinerten Bild zusammen mit dem Original in der BinDB des [[IES]]. Im In-Modus werden nicht alle angegebenen Bildgrößen berechnet, sondern nur bestimmte Größen, die in der [[BinDB]] definiert sind. In der BinDB sind z.B. die Größen 40,h40,w50,100 definiert. Dies bedeutet folgendes:
:;40
::Bild wird mit einer Höhe und Breite von 40 Pixeln mit <code>padding="off"</code> berechnet
:;h40
::Bild wird mit einer Höhe von 40 Pixel und einer Breite proportional zum Original mit <code>padding="off"</code> berechnet
:;w50
::Bild wird mit einer Breite von 50 Pixel und einer Höhe proportional zum Original mit <code>padding="off"</code> berechnet
:;100
::Bild wird mit einer Höhe und Breite von 100 Pixeln mit <code>padding="off"</code> berechnet

:Wird nun ein Bild von 30x30 Pixel verlangt wird das '''40'''-Bild verwendet. Wird ein 300x300 Pixel Bild verlangt, wird das '''100'''-Bild verwendet. Der Sinn dabei ist, das nicht eine sehr große Anzahl von Bilder berechnet und in der BinDB abgelegt werden soll. Die zurückgegebenen Bilder können auf das verlangte Maß vom Browser skaliert werden. Das Padding kann über CSS-Styles erfolgen.

:Dieses Verhalten der 'Skalierungs-Schritte' kann über das Attribute <code>scaleSteps="false"</code> ausgeschaltet werden. Dieses ist aber nur in Ausnahmefällen empfohlen und kann sich negativ auf die Performanz des Systems auswirken.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 2
|-
| <code>object</code>
| [[Attribute]]
| Nein
| None
| 2
|-
| <code>width</code>
| [[Expression]]
| Ja und / oder <code>height</code>
| None
| 2
|-
| <code>height</code>
| [[Expression]]
| Ja und / oder <code>width</code>
| None
| 2
|-
| <code>padding</code>
| [[Text]]
| Nein
| off (Achtung: anderer Default-Wert als bei [[spt:imp]])
| 2
|-
| <code>background</code>
| [[Text]]
| Nein
| FFFFFF
| 2
|-
| <code>scalesteps</code>
| [[Condition]]
| Nein
| true, wirkt sich nur im In-Modus aus
| 2
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 2
|-
| <code>scope</code>
| [[Scope]]
| Nein
| request
| 2
|}

;<code>name</code>
:Name der Variable für den Zugriff auf das [[ScaleImage]]-Objekt.

;<code>object</code>
:Original-Bild.

;<code>width</code>
:Breite des zu berechnenden Bildes.

;<code>height</code>
:Höhe des zu berechnenden Bildes.

;<code>padding</code>
:Der Wert "on" erzeugt Rahmen zur Auffüllung der Flächen um das Bild Damit ist das resultierende Bild immer so groß wie durch die Auflösung gefordert.

:Der Wert "off" erzeugt keinen Rahmen zur Auffüllung der Flächen um das Bild. Damit ist das resultierende Bild unter Umständen kleiner als die geforderte Auflösung.

:Mit "fit" wird der größt mögliche Ausschnitt aus dem Originalbild bzw. aus dem durch excerpt gewählten Ausschnitt gesucht bei dem das Seitenverhältnis der geforderten Auflösung entspricht. Es wird kein Rahmen erzeugt, sondern das Bild in einer Dimension gegebenenfalls gekürzt.

:Aufgrund von Abwärtskompatibilität wird auch der Wert "yes" (entspricht "on") und "no" (entspricht "off") unterstützt.

;<code>background</code>
:Hintergrundfabe für das Padding.

;<code>scalesteps</code>
:Schalter um das Optimierungsverhalten im In-Modus auszuschalten.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

;<code>scope</code>
:[[Scope|Gültigkeitsbereich]], in dem die Variable definiert ist. Möglich sind <code>page</code> und <code>request</code>.

==Beispiele==

===Bild verkleinern===

Template Quelltext
<source lang="xml">
<sp:scaleimage
name="scaledImage"
object="myImage.systemlink"
width="40"
height="40"
padding="on"
background="AAAAAA"/>
widht: <sp:print name="scaledImage.imageWidht"/>
height: <sp:print name="scaledImage.imageHeight"/>
url: <sp:print name="scaledImage.url"/>
</source>

Ausgabe
<source lang="text">
width: 40
height: 40
url: /test/test.html.media/myimage.jpg.scaled/40x40.pm1.bgAAAAAA.jpg
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Select (SP-Tag)

2008-11-12T10:07:33Z

Schramek: /* Attribute */

==Name==
<sp:select> - Erzeugt eine Selectbox

==Syntax==
<source lang="xml">
<sp:select name="variable">
...
</sp:select>
</source>

==Beschreibung==
Der Select-Tag erzeugt eine HTML-Select-Box. <code>sp:select</code> wird zusammen mit <code>[[sp:option]]</code> verwendet.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
| <code>multiple</code>
| [[Condition]]
| Nein
| None
| 1
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
;<code>multiple</code>
:HTML-Attribut (true, false).
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Select-Box mit eingenen Optionen und einer Collection===

Template Quelltext
<source lang="xml">
<sp:select name="choice">
<sp:option value="sitepark">sitepark</sp:option>
<sp:option value="develop">develop</sp:option>
<sp:loop collection="col" item="i">
<sp:option value="${i.name}"><sp:print name="i.name"/></sp:option>
</sp:loop>
</sp:select>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Radio (SP-Tag)

2008-11-12T10:06:26Z

Schramek: /* Attribute */

{{Überarbeiten}}
==Name==
<sp:radio> - Erzeugt einen Radio-Button

==Syntax==
<source lang="xml">
<sp:radio name="variable" value="Inhalt"/>
</source>

==Beschreibung==
Der Radio-Tag erzeugt eine HTML-Radio-Button.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=checked|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=checked|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Vier Radio-Buttons===

Template Quelltext
<source lang="xml">
<sp:radio name="radio" value="KnopfEins" locale="de" /> nummer 1
<sp:radio name="radio" value="KonpfZwei" locale="de" /> nummer 2
<sp:radio name="radio" value="radioButtonOne" locale="en" /> number 1
<sp:radio name="radio" value="radioButtonTwo" locale="en" /> number 2
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Print (SP-Tag)

2008-11-12T10:06:23Z

Schramek: /* Attribute */

==Name==
<sp:print> - Ausgabe-Tag

==Syntax==
<source lang="xml">
<sp:print name="variable" encoding="html"/>
</source>

==Beschreibung==
Der Print-Tag dient zur Ausgabe von Texten, Expression sowie Daten und Zahlen in beliegem Formaten.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Attribute]]
| Ja oder text bzw. expression
| None
| 1
|-
| <code>text</code>
| [[Text]]
| Ja oder name bzw. expression
| None
| 1
|-
| <code>expression</code>
| [[Expression]]
| Ja oder name bzw. text
| None
| 1
|-
| <code>default</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>encoding</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>encrypt</code>
| [[Text]]
| Nein
| None
| 1
|-
{{sp_common_attributes|attribute=locale|mode=row}}
|-
| <code>dateformat</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>decimalformat</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>arg</code>
| [[Expression]]
| Nein
| None
| 2.0.3
|}

;<code>name</code>
:Attribute das ausgegeben werden soll (Siehe „[[Attribute]]“).

;<code>text</code>
:Alternative zu name (Siehe „[[Text]]“).

;<code>expression</code>
:Alternative zu name (Siehe „[[Expression]]“).

;<code>default</code>
:Auszugebender Default-Wert, wenn das Ergebnis von name bzw. text bzw. expression leer ist.

;<code>encoding</code>
:Encodiert die Auszugebende Zeichenkette mit dem angegebenen Encoding. Es ist möglich eine kommaseparierte Liste von Encodings anzugeben, die nacheinander ausgeführt werden. Gültige Werte sind:

:;none
::kein encoding

:;html
::encoded HTML-Text
:::<code>< zu &lt;</code>
:::<code>> zu &gt;</code>
:::<code>' zu &#039;</code>
:::<code>" zu &#034;</code>
:::<code>& zu &amp;</code>

:;xml
::encoded XML-Text
:::<code>< zu &lt;</code>
:::<code>> zu &gt;</code>
:::<code>' zu &apos;</code>
:::<code>" zu &quot;</code>
:::<code>& zu &amp;</code>

:;script
::encoded für JavaScript, PHP, JSP, o.ä (escaped \n, \r, \r\n, " und ')

:;url
::encoded eine URL (entsprechend dem Charset des Publishers)

:;url; charset=latin1
::encoded eine URL (mit dem übergebenen Charset)

:;entity
::encoded alle Entitäten

:;plain
::encoded <, > und Zeilenenden (\n, \r, \r\n)

:;ascii
::encoded Windows-Sonderzeichen nach ASCII

:;path
::encoded einen Verzeichnisnamen

:;filename
::encoded einen Dateinamen

:;wikitext (ab Version 2.0.3)
::Erzeugt ein Wiki-Text Syntax HTML. Weitere Informationen über Wiki-Text finden sie hier: [http://de.wikipedia.org/wiki/Hilfe:Textgestaltung]

:;base64 (ab Version 2.0.1)
::encoded nach BASE64

:;hex (ab Version 2.0.1)
::encoded nach HEX. Hierbei wird jedes Zeichen in eine Zahl umgewandelt und dessen Hex-Wert ausgegeben

;<code>encrypt</code>
:Encryptet die Auszugebende Zeichenkette mit dem angegebenen Encrypting. Es ist möglich eine kommaseparierte Liste von Encryptins anzugeben, die nacheinander ausgeführt werden. Gültige Werte sind:
:;3des
::Triple DES Crypting Algorithmus
:;unixcrypt
::UNIX-Crypt Algorithmus
:;md5
::MD5 Algorithmus
:;sha
::SHA Algorithmus
{{sp_common_attributes|attribute=locale|mode=desc}}

;<code>dateformat</code>
:Angaben zur [[dateformat|Datumsformatierung]]. Um für die Formatierung die gewünschte Sprache zu erhalten bestehen folgende Möglichkeiten:
:*Die Angabe einer Sprache über das <code>locale</code>-Attribut dieses Tags. Dies hat aber auch Einfluss auf die in <code>name</code> angegebenen Variablen.
:*Übername des Locals des aktiven Publishers. Wird das <code>locale</code>-Attribut nicht verwendet, wird das Locale des aktiven Publishers verwendet. Ist kein Publisher aktiv (in-Modus) oder wurde im Publisher kein Locale angegeben wird das default-Locale des Systems verwendet (im Regelfall de_DE).
:*Angabe eines Locale in der Formatdefinition. In der Formatdefinition kann unabhängig von allen sonst definierten Formaten nur für dieses Format ein Locale angegeben werden. Dazu muß nach der Formatdefinition mit einem Pipe-Zeichen (|) getrennt das Locale angegeben werden: <source lang="text">dd.MM.yyyy HH:mm|en</source>

;<code>decimalformat</code>
:Angaben zur [[decimalformat|Dezimalformatierung]]. Um für die Formatierung die gewünschte Sprache zu erhalten bestehen folgende Möglichkeiten:
:*Die Angabe einer Sprache über das <code>locale</code>-Attribut dieses Tags. Dies hat aber auch Einfluss auf die in <code>name</code> angegebenen Variablen.
:*Übername des Locals des aktiven Publishers. Wird das <code>locale</code>-Attribut nicht verwendet, wird das Locale des aktiven Publishers verwendet. Ist kein Publisher aktiv (in-Modus) oder wurde im Publisher kein Locale angegeben wird das default-Locale des Systems verwendet (im Regelfall de_DE).
:*Angabe eines Locale in der Formatdefinition. In der Formatdefinition kann unabhängig von allen sonst definierten Formaten nur für dieses Format ein Locale angegeben werden. Dazu muß nach der Formatdefinition mit einem Pipe-Zeichen (|) getrennt das Locale angegeben werden: <source lang="text">##.00|en</source> '''Hinweis:''' Bis Version 2.0.2 wurde der Doppelpunkt als Trennzeichen verwendet. Da dateformat diese Funktion ab Version 2.0.3 auch besitzt konnte der Doppelpunkt nicht mehr verwendet werden, da dieser Teil der Format-Definition sein kann. Aus diese Grund wurde der Doppelpunkt als Locale-Trennzeichen als [[deprecated#2.0.3|deprecated]] deklariert.

;<code>arg</code> (ab Version 2.0.3)
:Mit diesem Attribut werden Werte für eine Formatierung im [[StringFormat]] angegeben. Für dieses Attribut gilt der Sonderfall, dass mehrere Werte in einzelnen <code>arg</arg>-Attributen angegenben werden. Es ist also möglich mehere Attribute <code>arg</code> in diesem Tag anzugeben. Diese Formatierung wird durchgeführt, wenn mindestens ein <code>arg</code>-Attribut angegeben wurde. Diese Formatierung wird nach allen anderen Formatierungen (deciamlformat, numberformat), de- und encodings und de- und encrypting durchgeführt. Die ermittelte Zeichenkette wird zusammen mit den übergebenen Argumenten in den <code>arg</code>-Attributen nach den Regeln des [[StringFormat|StringFormats]] formatiert. Zu beachten ist, das die <code>arg</code>-Argumente eine [[Expression]] erwartet. Zahlen können direkt übergeben werden. Zeichenketten müssen ich <code>'</code> gefasst werden
:<source lang="text"><sp:print text="Eine Zahl %d. Ein Wort %s" arg="3" arg="'Wort'"/></source>

==Beispiele==

===Ausgabe einer Variablen===

Template Quelltext

<source lang="xml">
Nicht definierte Variablen liefern: <sp:print name="var"/><br>
Sie können aber einen Default-Wert haben: <sp:print name="var" default="Hallo"/>
</source>

Ausgabe
<source lang="text">
Nicht definierte Variablen liefern:
Sie können aber einen Default-Wert haben: Hallo
</source>

===Ausgabe einer Expression===

Template Quelltext
<source lang="xml">
<sp:set name="x" value="7"/>
<sp:set name="y" value="12"/>
<%--
Auf Variablen greift man mit ${} zu
--%>
Der Print-Tag kann auch rechnen:
(7 + 12) * 2 - 3 = <sp:print expression="(${x} + ${y}) * 2 - 3"/>
</source>

Ausgabe
<source lang="text">
Der Print-Tag kann auch rechnen:
(7 + 12) * 2 - 3 = 35
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Option (SP-Tag)

2008-11-12T10:06:19Z

Schramek: /* Attribute */

==Name==
<sp:option> - erzeugt einen Option-Eintrag innerhalb eines <code>[[sp:select]]</code>-Tags

==Syntax==
<source lang="xml">
<sp:select name="variable">
<sp:option value="value"/>
</sp:select>
</source>

==Beschreibung==
Mit dem Option-Tag können die wählbaren Optionen einer Selectbox ausgegeben werden. Mit dem <code>value</code>-Attribut wird der Wert der Option angegeben. Besitzt das über [[sp:select]] definierte Feld den Wert der Option, wird dieses automatisch selektiert.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
| <code>selected</code>
| [[Condition]]
| Nein
| None
| 1
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}

;<code>value</code>
:Gibt den Wert der Option an.

;<code>disabled</code>
:Gibt an, ob die Option deaktiviert werden soll.

;<code>selected</code>
:Gibt an, ob die Option per default ausgewählt (selected) sein soll. Diese Einstellung gilt nur so lange, bis eine Auswahl durch den Bearbeiter vorgenommen und gespeichert wurde.
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Option für eine Selectbox===

Template Quelltext
<source lang="xml">
<sp:select name="choice">
<sp:option value="sitepark">sitepark</sp:option>
<sp:option value="develop">develop</sp:option>
<sp:loop collection="col" item="i">
<sp:option value="${i.name}"><sp:print name="i.name"/></sp:option>
</sp:loop>
</sp:select>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Map (SP-Tag)

2008-11-12T10:06:15Z

Schramek: /* Attribute */

==Name==
<sp:map> - Erzeugt oder ändert eine Map

==Syntax==
<source lang="xml">
<sp:map name="myMap" action="put|remove|new|clear" key="keyname" value="come back at ${myTime}" />
</source>
<source lang="xml">
<sp:map name="myMap" action="put|remove|new|clear" key="keyname" object="myVariable" />
</source>

==Beschreibung==
Mit dem Map-Tag können [[Map|Maps]] erzeugt und geändert werden. Eine Map ist eine Liste von Schlüssel/Werte-Paaren.Eine Map kann entweder über [[sp:loop]] durchlaufen oder die einzelnen Werte können über den Schlüssel erfragt werden. Der Name des Schlüssels kann, getrennt durch einen Punkt an den Map-Namen angehängt werden um den Wert Bespielsweise mit [[sp:print]] auszugeben.
<source lang="xml">
<sp:print name="myMap.keyname"/>
</source>

Sieht man die Schlüssel einer Map als Attribute eines Objektes, kann sie zur Erzeugung von komplexen Objekten dienen. Da Maps auch Maps enthalten können, sind auch verschachtelte Strukturen möglich. Um verschachtelte Maps zu erzeugen, darf das Attribute name Punkte enthalten. Der Map-Tag erzeugt für jeden mit einem Punkt getrennten Namen eine Map in der Map.
<source lang="xml">
<sp:map name="myMap.mySubMap" key="keyname" value="text"/>
</source>

'''(Ab Version 2.0.3)'''

Werte können über die Attribute value oder object gesetzte werden. Alternativ ist es auch möglich den Wert im Body des Tags zu setzten. Hierbei wird zunächst der Body ausgeführt und das Ergebnis verwendet
<source lang="xml">
<sp:map name="myMap.mySubMap" key="keyname"><sp:print name="var"/></sp:map>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>action</code>
| [[Text]]
| Ja
| None
| 1
|-
| <code>key</code>
| [[Variable]]
| Ja, für put
| None
| 1
|-
| <code>value</code>
| [[Text]]
| Ja oder object oder im Body des Tags, für put
| None
| 1
|-
| <code>object</code>
| [[Attribute]]
| Ja oder value oder im Body des Tags, für put
| None
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>scope</code>
| [[Scope]]
| Nein
| request
| 1
|}

;<code>name</code>
:Name der Map. Ein Punkt trennt die Namen für verschachtelte Maps.

;<code>action</code>
:Aktion, die ausgeführt werden soll. Es existieren die Aktionen put, remove, new und clear.
:;put
::Träg ein neues Schlüssel-Werte-Paar ein die Map ein. Existiert schon ein Eintrag mit dem angegebenen Schlüssel, so wird der alter Wert überschrieben.
:;remove
::Löscht das Schlüssel-Werte-Paar mit dem in key angegebenen Schlüssel aus der Map.
:;new
::Erzeugt eine neue Map
:;clear
::Löscht den Inhalt der Map

;<code>key</code>
:Schlüssel, über den auf die Werte der Map zugegriffen werden soll.

;<code>value</code>
:Kennzeichnet den Wert, der eingefügt, ersetzt oder gelöscht werden soll.

;<code>object</code>
:Kennzeichnet das Objekt, der eingefügt, ersetzt oder gelöscht werden soll.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

;<code>scope</code>
:[[Scope|Namensraum]], in dem die Variable definiert ist. Für diesen Tag ist der Page- und Request-Scope mögiich (<code>page</code>, <code>request</code>).

==Beispiele==

===Einfache Schlüssel/Werte Paare===

Template Quelltext
<source lang="xml">
<sp:map name="frequencies" action="put" key="C" value="261.63"/>
<sp:map name="frequencies" action="put" key="D" value="293.66"/>
<sp:map name="frequencies" action="put" key="E" value="329.63"/>
<sp:map name="frequencies" action="put" key="F" value="349.23"/>
<sp:map name="frequencies" action="put" key="G" value="392.00"/>
<sp:map name="frequencies" action="put" key="A" value="440.00"/>
<sp:map name="frequencies" action="put" key="H" value="493.88"/>

Auf einzelne Werte zugreifen:<br>
Frequenz von D: <sp:print name="frequencies.D"/> Hz

Die Map in einer Schleife durchlaufen<br>
Frequenzen der Tonleiter
<sp:loop collection="frequencies" item="f">
<sp:print name="f.key"/> = <sp:print name="f.value"/> Hz
</sp:loop>
</source>

Ausgabe
<source lang="text">
Auf einzelne Werte zugreifen:
Frequenz von D: 293.66 Hz

Die Map in einer Schleife durchlaufen
Frequenzen der Tonleiter
C = 261.63 Hz
D = 293.66 Hz
E = 329.63 Hz
F = 349.23 Hz
G = 392.00 Hz
A = 440.00 Hz
H = 493.88 Hz
</source>

===Objekte mit einer Map erzeugen===

Template Quelltext
<source lang="xml">
<sp:map name="person" action="put" key="lastname" value="Müller"/>
<sp:map name="person" action="put" key="firstname" value="Max"/>
<sp:map name="person" action="put" key="email" value="max@mueller.de"/>

<sp:map name="person.address" action="put" key="street" value="Meierstr. 11"/>
<sp:map name="person.address" action="put" key="zip" value="12345"/>
<sp:map name="person.address" action="put" key="city" value="Musterstadt"/>

Adresse:
<sp:print name="person.firstname"/> <sp:print name="person.lastname"/> (<sp:print name="person.email"/>)
<sp:print name="person.address.street"/>
<sp:print name="person.address.zip"/> <sp:print name="person.address.city"/>
</source>

Ausgabe
<source lang="text">
Adresse:
Max Müller (max@mueller.de)
Meierstr. 11
12345 Musterstadt
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Login (SP-Tag)

2008-11-12T10:02:14Z

Schramek: /* Attribute */

==Name==
<sp:login> - Anmelden eines IES-Nutzers

==Syntax==
<source lang="xml">
<sp:login login="myname" password="secret" client="clientanchor" scope="application"/>
</source>

==Beschreibung==
Mit dem Login-Tag können Nutzer an den IES angemeldet werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>session</code>
| [[Text]]
| Ja oder <code>login</code>, <code>password</code> und <code>client</code>
| None
| 1
|-
| <code>login</code>
| [[Text]]
| Ja oder <code>session</code>
| None
| 1
|-
| <code>password</code>
| [[Text]]
| Ja oder <code>session</code>
| None
| 1
|-
| <code>client</code>
| [[Anchor]]
| Ja oder <code>session</code>
| None
| 1
|-
| <code>scope</code>
| [[Scope]]
| Nein
| windowSession
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>captcharequired</code>
| [[Boolean]]
| Nein
| false
| 2.0.1
|}

;<code>session</code>
:Verwendet eine aktive Session für die Authentifizierung.

;<code>login</code>
:Nutzer-Login.

;<code>password</code>
:Nutzer-Password.

;<code>client</code>
:[[Anchor]] des Clients.

;<code>scope</code>
:Bereich in dem die erzeugte Verbindung zum IES gespeichert werden soll.
:;windowSession
::Verbindung wird nur für ein Browser-Fenster/Browser-Tab verwendet (siehe [[SPEL#Window Scope|Window Scope]]).
:;browserSession
::Verbindung gilt für die komplette Browser-Instanz (siehe [[SPEL#Session Scope|Session Scope]]).
:;application
::Verbindung glit für das gesamte IES-Modul (Web-Applikation). Bei Verwendung von sp:login in Live-Seiten ist dieser Scope zu empfehlen, wenn immer der gleiche Nutzer verwendet wird (siehe [[SPEL#Application Scope|Application Scope]]).

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

;<code>captcharequired</code>
:Dieses Attribut wird verwendet um eine Session zu erzeugen, die Handler-Aufrufe nur zusammen mit der Eingabe eine Captchas ermöglicht. Dadurch können Live-Applikationen (z.B. Anmeldung zu einem Newsletter) vor maschinellen Zugriffen geschützt werden.

==Beispiele==

===Nutzer Anmelden===

Template Quelltext
<source lang="xml">
<sp:login login="myname" password="secret" client="clientanchor" scope="application"/>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Linktree (SP-Tag)

2008-11-12T10:02:09Z

Schramek: /* Attribute */

==Name==
<sp:linktree> — erzeugt Baumstrukturen aus Verlinkungen

==Syntax==
<source lang="xml">
<sp:linktree name="sp_sitemap" attributes="sp_headline, sp_teaser" parentlink="sp_parent.link" rootElement="${!{myroot}}" />
</source>

==Beschreibung==
Der <code>linktree</code>-Tag kann zur Definition einer [[Baum|Baumstruktur]] verwendet werden, die sich aus der Verlinkung von Artikeln über z.B. [[Link#Systemlink|Systemlinks]] ergibt. Dieser Tag kann nur im <code>in</code>-Modus betrieben werden, da er nur zur Definition des Baumes dient. Anhand der Definition wird im Server der Baum aufgebaut und bei Änderungen der einzelnen Artikel aktuell gehalten. Ein Anwendungsfall für <code>sp:linktree</code> sind Sitemaps. Für die Ausgabe wird der Baum als Liste von [[ElementNode]]-Objekten mit <code>[[sp:loop]]</code> ausgegeben. Die in dem Baum enthaltenen Artikel enthalten nicht den vollständigen Datensatz sondern nur die in <code>attributes</code> definierten Felder. Artikel, die diesen Tag verwenden, werden auch nur aktuallisiert, wenn sich Felder von Artikeln des Baums ändern, die in <code>attributes</code> definiert wurden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>rootElement</code>
| [[ID]]
| Nein
| ID des Artikels
| 1
|-
| <code>attributes</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>parentlink</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>localelink</code>
| [[Condition]]
| Nein
| false
| 1
|-
| <code>sortkeys</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>sortsequences</code>
| [[Text]]
| Nein
| asc
| 1
|-
| <code>sorttypes</code>
| [[Text]]
| Nein
| text
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|}

;<code>name</code>
:Name der Variable für das LinkTree-Objekt.

;<code>rootElement</code>
:Das Root-Element des Baums. Ist kein Root-Element angegeben wird der dazugehörige Artikel als Root-Element verwendet.

;<code>attributes</code>
:Eine Kommasepariete Liste von Attributen, die der Artikel enthalten und auf dessen Änderungen er reagieren soll.

;<code>parentlink</code>
:Name des Links, der auf einen, in der zu erstellenden Struktur, übergeordneten Artikel verweist.

;<code>localelink</code>
:Mit diesem Attribut kann angegeben werden, ob ein Linktree Sprachabhängig aufgebaut werden soll. Wird localelink auf <code>true</code> gesetzt, wird die Sprache des Publikationsbereichs für den Tree verwendet. Die Parentlinks, die den Baum ergeben müssen dann mit einer Sprache definiert werden.

;<code>sortkeys</code>
:Attribute des Artikels, nach denen der Baum sortiert werden soll. Jede Ebene des Baums wird für sich sortiert.

;<code>sortsequences</code>
:Für jedes Sortierkriterium muss eine Sortierreihenfolge festgelegt werden, mit der bestimmt wird, ob mit dem Sortierkriterium aufsteigend (<code>desc</code>), absteigend (<code>asc</code>) oder zufällig (<code>random</code>) sortiert wird.

;<code>sorttypes</code>
:Für jedes Sortierkriterium kann ein Sortiertyp festgelegt werden, der bestimmt, wie sortiert wird. Dabei ist eine Sortierung von Zeichenketten (text) oder eine Sortierung von Zahlen (number) möglich.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.

==Beispiele==

===Navigationsbaum===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<sp:linktree
name="linktree"
attributes="sp_title"
parentlink="linktree_parent.navlink"
rootElement="${!{linktree.root}.id}"
sortkeys="name"/>
</sp:io>

<sp:io type="out">

<sp:collection
name="treelist"
object="linktree"
action="addAll"/>

<%-- Ausgabe des Baums mit sp:loop als unordered-list --%>
<ul>
<sp:loop collection="treelist" item="line">

<sp:if name="lastLevel" gt="${line.level}">
<sp:set name="i" expression="${lastLevel} - ${line.level}"/>
<sp:for index="j" from="1" to="${i}">
</ul></li>
</sp:for>
</sp:if>
<sp:set name="lastLevel" value="${line.level}"/>

<li>
<sp:print name="line.title"/><br>

<sp:if condition="${line.hasNodes} == false"></li></sp:if>
<sp:if condition="${line.hasNodes} == true"><ul></sp:if>

</sp:loop>

<sp:for index="j" from="0" condition="${lastLevel} > 0 && ${j} < ${lastLevel}">
</ul></li>
</sp:for>

</ul>
</sp:io>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Livetree (SP-Tag)

2008-11-12T10:02:05Z

Schramek: /* Attribute */

==Name==
<sp:livetree> - Mit diesem Tag lassen sich Bäume erzeugen, verändern und in ihnen suchen.

==Syntax==
<source lang="xml">
<sp:livetree name="tree"
name="livetree"
parentlink="myparent"
rootElement="${!{myroot}}"
node="node"
sortkeys="created, name"
sortsequences="desc, asc"
sorttypes="date, text"
action="${action}"/>
</source>

==Beschreibung==
Der Livetree-Tag dient zur Ausgabe und Steuerung von Bäumen, die sich durch Verknüpfungen von Artikeln über [[spt:link|Links]] ergeben. Im Gegensatz zu <code>sp:linktree</code>, der die Baumstruktur zwischenspeichert, werden bei <code>sp:livetree</code> bei jedem Aufruf alle Verknüpfungen, mit dem im <code>parentlink</code> angegebenen Namen, gesucht und der Baum daraus erstellt.

Mit <code>rootElement</code> wird der Startpunkt des Baumes definiert. Alle Artikel, die über <code>parentlink</code> mit dem <code>rootElement</code> verknüpft sind bilden die erste Unterebene. Alle Artikel die mit den Artikel dieser Unterebene verknüpft sind bilden die zweite Unterebene und so weiter. Es werden nur Aritkel in dem Baum aufgenommen, die in dem Publisher <code>publisher</code> publiziert sind. Mit Hilfe von <code>sortkeys</code>, <code>sortsequences</code> und <code>sorttypes</code> können die Elemente des Baumes sortiert werden.

Im Initialzustand ist der Baum geschlossen. Das bedeutet das <code>sp:livetree</code> nur das <code>rootElement</code> zurückliefert. Erst durch die Angabe von einem <code>node</code> und der Aktion <code>open</code> wird der Baum geöffnet. Liegt node in einer tieferen Ebene werden alle Elemente geöffnet, die zu <code>node</code> führen. <code>node</code> ist ein Variablenname dessen Wert eine [[ID]] sein muß. Solange für <code>node</code> der gleiche Variablenname verwendet wird, bleiben die geöffneten Elemente offen, auch wenn <code>sp:livetree</code> erneut aufgerufen wird.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>action</code>
| [[Text]]
| Nein
| flip
| 1
|-
| <code>node</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>rootElement</code>
| [[ID]]
| Ja
| None
| 1
|-
| <code>publisher</code>
| [[ID]]
| Ja
| None
| 1
|-
| <code>parentlink</code>
| [[Text]]
| Ja
| None
| 1
|-
| <code>sortkeys</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>sortsequences</code>
| [[Text]]
| Nein
| <code>asc</code> für alle Sortierkriterien
| 1
|-
| <code>sorttypes</code>
| [[Text]]
| Nein
| <code>text</code> für alle Sortierkriterien
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|}

;<code>name</code>
:Name der Variable für die [[Collection]], die den Baum in Form von [[ElementNode|ElementNodes]] enthält.

;<code>action</code>
:Das Kommando, das auf das Element in <code>node</code> angewendet werden soll.
:;flip
::Offenen Node schliessen / Geschlossenen Node öffnen.
:;open
::Node öffnen.
:;close
::Node schliessen.
:;expand
::Node und den gesamten Pfad öffnen.
:;none
::Es wird keine Aktion ausgeführt.

;<code>node</code>
:Der Name der Variablen, Element dessen Wert eine Element-ID des Elementes sein muß, auf die sich <code>action</code> bezieht. Solange der gleiche Variablenname verwendet wird, bleiben die geöffneten Elemente offen, auch wenn <code>sp:livetree</code> erneut aufgerufen wird (innerhalb einer Session).

;<code>rootElement</code>
:Das Root-Element des Baumes.

;<code>parentlink</code>
:Name des Links, der auf einen, in der zu erstellenden Struktur, übergeordneten Artikel verweist.

;<code>publisher</code>
:[[ID]] des Publishers, in dem die Artikel des Baumes publiziert sein müssen.

;<code>sortkeys</code>
:Attribute des Artikels, nach denen der Baum sortiert werden soll. Jede Ebene des Baums wird für sich sortiert.

;<code>sortsequences</code>
:Für jedes Sortierkriterium muss eine Sortierreihenfolge festgelegt werden, mit der bestimmt wird ob mit dem Sortierkriterium aufsteigend (<code>desc</code>), absteigend (<code>asc</code>) oder zufällig (<code>random</code>) sortiert wird.

;<code>sorttypes</code>
:Für jedes Sortierkriterium kann ein Sortiertyp festgelegt werden, der bestimmt, wie sortiert wird. Dabei ist eine Sortierung von Zeichenketten (<code>text</code>) oder eine Sortierung von Zahlen (<code>number</code>) möglich.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

==Beispiele==

===Livetree mit Parameterübergabe===

<code>sp:livetree</code> verwendet zwei Parameter. Zum einen myNode, welches den Artikel angibt, auf die die Aktion angewendet werden soll. Zum anderen myAction in der die auszuführende Aktion steht. Nach der Aktion wird der Baum ausgegeben.

Template Quelltext
<source lang="xml">
<sp:livetree
name="myTree"
rootElement="${!{linktree.root}}"
node="myNode"
action="${action}"/>
parentlink="linktree_parent.navlink"
publisher="${!{publisherAnchor}}"
sortkeys="name"

Artikel-Baum:<br>
<sp:loop collection="myTree" item="it">
<sp:for index="i" from="0" to="${it.level}">.</sp:for> <sp:print name="it.name"/>
</sp:loop>
</source>

Ausgabe
<source lang="text">
. Root Artikel
.. Sub Artikel 1
... Sub-Sub Artikel 1
.. Sub ARtikel 2
... Sub-Sub Artikel 2
.... Sub-Sub-Sub Artikel 1
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Include (SP-Tag)

2008-11-12T10:01:26Z

Schramek: /* Attribute */

==Name==
<sp:include> - Includiert ein anderes Template

==Syntax==
<source lang="xml">
<sp:include anchor="anchor.example"/>
</source>

==Beschreibung==
Mit dem Include Tag ist es möglich innerhalb eines Templates andere bereits erstellte Templates oder SPML-Seiten von [[Webapplication|Webapplikationen]] einzubinden. Es kann über das <code>template</code>-Attribut entweder der [[Anchor]] oder eine Variable mit einer [[ID|Template-ID]] angegeben werden. Zu includende SPML-Seiten werdne über das <code>uri</code>-Attribut angegeben. <code>sp:include</code> wird durch die Ausgabe des eingebundenen Templates oder der SPML-Seite ersetzt.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>template</code>
| [[Variable]]
| Ja oder anchor oder uri
| None
| 1
|-
| <code>anchor</code>
| [[Anchor]]
| Ja oder template oder uri
| None
| 1
|-
| <code>uri</code>
| [[Text]]
| Ja oder template oder anchor
| None
| 1
|-
| <code>context</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>module</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>mode</code>
| [[Text]]
| Nein
| None
| 1
|}

;<code>template</code>
:Zu includendes Template (Variable mit einer Template-ID).

;<code>anchor</code>
:Anchor-Name des zu includenden Templates.

;<code>uri</code>
:URI einer Seite die includiert werden soll. Dieser muß in der gleichen [[Webapplication|Webapplikation]] liegen. Weiter kann mit dem <code>context</code>-Attribute oder dem </code>module</code>-Attribute eine andere [[Webapplication|Webapplikation]] angegeben werden, dessen Seite includiert werden soll.

;<code>context</code>
:SPML-Seiten sind immer Teil einer [[Webapplication|Webapplikation]]. Die mit dem Attribut <code>uri</code> angegebenen SPML-Seite bezieht sich immer auf die aktuelle Webapplikation. Soll eine Seite einer anderen Webapplikation eingebunden werden, so wird mit diesem Attribut der Context der Webapplikation angegeben. Da sich der Context einer Webapplikation ändern kann ist in den meisten Fällen die Verwendung des Attributes <code>module</code> zu empfehlen, da hier die ID der Webapplikation angegeben wird.

;<code>module</code>
:SPML-Seiten sind immer Teil einer [[Webapplication|Webapplikation]]. Die mit dem Attribut <code>uri</code> angegebenen SPML-Seite bezieht sich immer auf die aktuelle Webapplikation. Soll eine Seite einer anderen Webapplikation eingebunden werden, so wird mit diesem Attribut die ID der Webapplikation angegeben. Dieses Attribut ist dem Attribut <code>context</code> vorzuziehen, da sich der Context einer Webapplikation ändern kann.

;<code>mode</code>
:Mit diesem Attribut kann angegeben werden, in welchem Modus die includete SPML-Seite oder das includete Template ausgeführt werden soll.
:;in
::Führt das Template oder die SPML-Seite im [[Template-Modus|In-Modus]] aus.
:;out
::Führt das Template oder die SPML-Seite im [[Template-Modus|Out-Modus]] aus.

==Beispiele==

===Einfügen von Templates===

Template Quelltext
<source lang="xml">
<html>
<head>
<title>Template Include</title>
</head>
<body>
<sp:include anchor="html.header"/>
<sp:include template="currentTemplate"/>
<sp:include anchor="html.footer"/>
</body>
</html>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Filter (SP-Tag)

2008-11-12T10:00:58Z

Schramek: /* Attribute */

==Name==
<sp:filter> - Filtert Elemente aus einer Liste.

==Syntax==
<source lang="xml">
<sp:filter name="filteredList" collection="listToFilter" attribute="name" filter="*Example*" ic="true" mode="simple"/>
</source>

==Beschreibung==
Mit diesem Tag können Listen gefiltert werden. Listen-Elemete werden nach bestimmten Kriterien aus der Liste entfernt. Es gibt drei Arten von Filtern: Einen einfachen Wildcard-Filter, der * und ? unterstützt, weiter gibt es für komplexe Anforderungen einen Filter aus regulären Ausrücken sowie einen Bereichsfilter.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>collection</code>
| [[Collection]]
| Ja
| None
| 1
|-
| <code>attribute</code>
| [[Text]]
| Nein
| das Element selbst
| 1
|-
| <code>filter</code>
| [[Text]] / [[Regular-Expression]]
| Nein
| None
| 1
|-
| <code>ic</code>
| [[Condition]]
| Nein
| <code>false</code>
| 1
|-
| <code>invert</code>
| [[Condition]]
| Nein
| <code>false</code>
| 1
|-
| <code>mode</code>
| [[Text]]
| Nein
| <code>simple</code>
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>from</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>to</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>type</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>format</code>
| [[Text]]
| Nein
| None
| 1
|}

;<code>name</code>
:Name der gefilterten Liste.

;<code>collection</code>
:Name der zu filternden Liste.

;<code>attribute</code>
:Attribut, auf das der Filter angewendet werden soll.

;<code>filter</code>
:Die Filterdefinition für die Filtertypen Wildcard und regulärer Ausdruck. Der mit dem Attribut <code>mode</code> angegebene Modus wird verwendet. Ohne Angabe eines Modus wird <code>simple</code> verwendet.

;<code>ic</code>
:Wird Ignore-Case auf <code>true</code> gesetzt, so wird Groß- und Kleinschreibung nicht berücksichtigt. Dieses Attribut gilt nur für die Filtertypen Wildcard und regulärer Ausdruck.

;<code>invert</code>
:Invertiet die Logik des Filters. Alle Elemnt die normalerweise herausgefiltert würde, bilden die Filterergebnis.

;<code>mode</code>
:Auswahl des Filter-Mechanismus.
:;simple (Wildcard-Filter)
::Der Filter kann die Wildcards * für beliebige Zeichen und ? für ein beliebiges Zeichen enthalten. So würde eine wie folgt gefilterte Liste nur Elemente enthalten die mit a beginnen.
::<source lang="text">
a*
</source>
:;regex (Reguläre Ausdrücke)
::Für komplexe Filter stehen [[Regular-Expression|Reguläre Ausdrücke]] (POSIX) zur Verfügung. So würde im regex-Filtermode eine mit
::<source lang="text">
[a-dA-D].*
</source>
gefilterte Liste nur Elemente enthalten, die mit dem Buchstaben A, a, B, b, C, c, d oder D beginnen.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachiger Variablen.

;<code>from</code>
:Der Wert für den Beginn eines Bereiches, z.B. "Aa" oder "100". Ob der Wert als Text, Zahl oder Datum interpretiert wird, kann mit dem Attribut type angegeben werden.

;<code>to</code>
:Der Wert für das Ende eines Bereiches, z.B. "Zz" oder "999". Ob der Wert als Text, Zahl oder Datum interpretiert wird, kann mit dem Attribut <code>type</code> angegeben werden.

;<code>type</code>
:Der Typ für die <code>from</code> und <code>to</code> Attribute: <code>number</code>, <code>text</code>, <code>date</code>.
:;number
::Das Elemet oder Attribut wird als Zahl interpretiert. Es wird nicht herausgefiltert, wenn es innerhalb des Zahlenbereiches liegt, der mit <code>from</code> und <code>to</code> definiert wurde.
:;text
::Das Elemet oder Attribut wird als Text interpretiert. Es wird nicht herausgefiltert, wenn der Text mit den Zeichen beginnt, die in dem mit <code>from</code> und <code>to</code> definierten Bereich liegen.
:;date
::Das Elemet oder Attribut wird als Datum interpretiert. Es wird nicht herausgefiltert, wenn es innerhalb des Datumbereiches liegt, der mit <code>from</code> und <code>to</code> definiert wurde.

;<code>format</code>
:Das Format des Datums, wenn die <code>from</code> und <code>to</code> Werte als Datum interpretiert werden sollen.

==Beispiele==

===Filtern einer Liste===

Template Quelltext
<source lang="xml">
<%-- zu filternde Liste erzeugen --%>
<sp:list name="names" action="add" value="Christian"/>
<sp:list name="names" action="add" value="Karsten"/>
<sp:list name="names" action="add" value="Gaby"/>
<sp:list name="names" action="add" value="Markus"/>
<sp:list name="names" action="add" value="Tina"/>
<sp:list name="names" action="add" value="Marion"/>
<sp:list name="names" action="add" value="Jörg"/>

<%-- Einfacher Filter --%>
Liste filtern (Filter ?ar* - simple-mode):<br>
<sp:filter name="filteredList" collection="names" filter="?ar*" mode="simple"/>
<sp:loop collection="filteredList" item="it">
<sp:print name="it"/><br>
</sp:loop>

<br>

<%-- Filter mit regulärem Ausdruck --%>
Liste filtern (Filter [a-lA-L].* - regex-mode):<br>
<sp:filter name="filteredList" collection="names" filter="[a-lA-L].*" mode="regex"/>
<sp:loop collection="filteredList" item="it">
<sp:print name="it"/><br>
</sp:loop>
</source>

Ausgabe
<source lang="text">
Liste filtern (Filter ?ar* - simple-mode):
Karsten
Markus
Marion

Liste filtern (Filter [a-lA-L].* - regex-mode):
Christian
Karsten
Gaby
Jörg
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

For (SP-Tag)

2008-11-12T10:00:55Z

Schramek: /* Attribute */

==Name==
<sp:for> - For-Schleife

==Syntax==
<source lang="xml">
<sp:for index="counter" from="0" to="10"/>
</source>

==Beschreibung==
Mit Hilfe des For-Tag kann eine Schleife definiert werden. <code>from</code> gibt den Startwert des Indexes an. Bei jedem Schleifendurchlauf wird <code>index</code> um den Wert <code>step</code> erhöht (bzw vermindert, wenn <code>step</code> negativ ist). Die Schleife wird solange durchlaufen bis <code>to</code> den Wert <code>index</code> erreicht hat. Alternativ zu to kann auch <code>condition</code> angegeben werden. In diesem Fall wird die Schleife solange durchlaufen, bis <code>condition</code> <code>false</code> ergibt.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>index</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>from</code>
| [[Expression]]
| Ja
| None
| 1
|-
| <code>to</code>
| [[Expression]]
| Ja oder <code>condition</code>
| None
| 1
|-
| <code>condition</code>
| [[Condition]]
| Ja oder <code>to</code>
| None
| 1
|-
| <code>step</code>
| [[Expression]]
| Nein
| 1
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|}

;<code>index</code>
:Name der Variable, die den aktuellen Zählerstand enthält.

;<code>from</code>
:Startwert des Zählers.

;<code>to</code>
:Endwert des Zählers.

;<code>condition</code>
:Die For-Schleife wird solange durchlaufen, bis die Bedingung <code>false</code> ergibt.

;<code>step</code>
:Schrittweite, in der gezählt werden soll. <code>step</code> kann für einen Rückwärtszähler negativ sein.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.

==Beispiele==

===Einfache from/to Schleife===

Template Quelltext
<source lang="xml">
<sp:for index="i" from="1" to="3">
index: <sp:print name="i"/><br>
</sp:for>
</source>

Ausgabe
<source lang="text">
index: 1
index: 2
index: 3
</source>

===Schleife mit Bedingung===

Template Quelltext
<source lang="xml">
<sp:set name="start" value="10"/>
<sp:set name="end" value="4"/>
<sp:set name="step" value="-1"/>
<sp:for index="i" from="${start}" condition="${i} >= (${end} + 1)" step="${step}">
index: <sp:print name="i"/><br>
</sp:for>
</source>

Ausgabe
<source lang="text">
index: 10
index: 9
index: 8
index: 7
index: 6
index: 5
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Form (SP-Tag)

2008-11-12T10:00:53Z

Schramek: /* Attribute */

==Name==
<sp:form> - Erzeugt ein HTML-Form-Tag

==Syntax==
<source lang="xml">
<sp:form command="command" enctype="multipart/form-data" method="post">
...
</sp:form>
</source>

==Beschreibung==
Erzeugt eine HTML-Form. Diese Tag wird benötigt, um Eingabe-Maken zu erstellen, mit denen Daten des Servers bearbeitet werden sollen.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
|-
| <code>uri</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>template</code>
| [[Attribute]]
| Nein
| None
| 2
|-
| <code>handler</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>module</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>context</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>nameencoding</code>
| [[Text]]
| Nein
| <code>hex</code>, wenn Formular an eine PHP-Seite gesendet wird
| 1
|-
| <code>enctype</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>method</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>id</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>name</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>command ([[deprecated#2.0|deprecated]] ab Version 2.0)</code>
| [[Text]]
| Nein
| None
| 1
|-
{{sp_common_attributes|attribute=locale|mode=row}}

|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}

;<code>uri</code>
:Dies kann ein beliebiger Pfad zu einer Seite sein. sp:form sorgt dafür, das alle Session-Informationen mitgesendet werden, so das die Session nicht verloren geht. Wird bei SPML-Seiten weder das Attribut <code>uri</code> noch <code>template</code> angegeben, so wird die aktuelle URL angesprochen.

;<code>template</code>
:Template, an das das Formular gesendet werden soll. 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 [[Webapplication|Webapplikationen]] nicht mit Templates, sondern mit SPML-Seite realisiert werden.

;<code>handler</code>
:Handler, an das das Formular gesendet werden soll. Handler werden vor der, mit <code>uri</code> oder <code>template</code> angegebenen Seite, ausgeführt.

;<code>module</code>
:SPML-Seiten sind immer Teil einer [[Webapplication|Webapplikation]]. Jede Webapplikation besitzt eine Context-Pfad mit der die URL beginnt (Es existert auch ein ROOT-Context-Pfad (/)). Soll das Formular an eine Seite gesendet werden, die in einer anderen Webapplikation liegt, so wird mit diesem Attribut die ID dieser Webapplikation angegeben.

;<code>context</code>
:SPML-Seiten sind immer Teil einer [[Webapplication|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 <code>module</code> verwendet werden.

;<code>nameencoding</code>
:Die innerhalb von sp:form liegenden Input-Tags ([[sp:text]], [[spt:text]], [[sp:checkbox]], ...) erhalten vom IES generierte Feldnamen die unter Umständen (wenn sie z.B. innerhalb von [[sp:iterator]] liegen) Sonderzeichen wie eckige Klammern (<code>[</code>, <code>]</code>) enthalten könne. Beim Aufbau von [[Live-Seite|Live-Seiten]], die in PHP eingebettet sind, wird das Formular an PHP-Seiten gesendet. Da Request-Parameternamen mit Sonderzeichen von PHP nicht richtig ausgewertet werden, ist es mit diesem Attribut möglich die Formularfeldnamen zu encoden, damit keine Sonderzeichen mehr enthalten sind. Vom IES unterstüzte Encodings für Feldnamen sind:
:;hex
::Wandelt jedes Zeichen des Feldnamens in den entsprechenden Hex-Wert um. Beispiel: Aus <code>sp_body</code> wird <code>hex:73705f626f6479</code>

;<code>command</code> ([[deprecated#2.0|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 <code>template</code> und <code>handler</code> 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 <code>handler</code> und <code>template</code>. Um einen Handler aufzurufen und anschließend eine SPML-Seite auszuführen verwenden sie die Attribute <code>handler</code> und <code>uri</code>.''

:Existierendes Command. Muss im GUI definiert worden sein.

;<code>enctype</code>
:Bestimmt den Typ der zu übertragenden Daten:
:;text/plain
::text/plain ist die default Einstellung.
:;multipart/form-data
::Für Datei uploads muss multipart/form-data angegeben werden.

;<code>method</code>
:Bestimmt die Übertragungsmethode: get oder post. Bei get werden die Parameter offen über die aufzurufende URL übermittelt, bei post verborgen im HTTP-Protokoll. Für Datei-uploads ist post Pflicht.
{{sp_common_attributes|attribute=locale|mode=desc}}

;<code>id</code>
:Optionale id für den erzeugten HTML-Form-Tag. Wird dieses Attribut nicht gesetzt wird automatisch eine ID generiert

;<code>name</code>
:Optionaler Name für das erzeugte Formular.
{{sp_input_attributes|attribute=dynamics|mode=desc}}.

==Beispiele==

===Neuen Artikel anlegen===

Template Quelltext
<source lang="xml">
<sp:form uri="mytest/test.spml" handler="com.sitepark.ies.control.jsp.handler.InformationHandler" method="post">

<input type="hidden" name="SYS_INFE_action" value="create"/>
<input type="hidden" name="SYS_INFE_parent" value="<sp:print name="${parentPool}"/>"/>
<input type="hidden" name="SYS_INFE_articleType" value="resource"/>

Name<br>
<input type="text" name="SYS_INFE_name"/><br>
<br>

Titel<br>
<sp:text name="sp_title"/><br>
Text<br>
<sp:textarea name="sp_body"/><br>

<input type="submit" value=" submit ">

</sp:form>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Hidden (SP-Tag)

2008-11-12T10:00:52Z

Schramek: /* Attribute */

==Name==
<sp:hidden> - Erzeugt ein Hidden-Feld

==Syntax==
<source lang="xml">
<sp:hidden name="variablenName" value="element.id"/>
</source>

==Beschreibung==
Der Hidden-Tag erzeugt ein HTML-Hidden-Feld.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Ein Hidden-Feld===

Template Quelltext
<source lang="xml">
<sp:hidden name="car" value="Audi" />
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

CalendarSheet (SP-Tag)

2008-11-12T09:59:30Z

Schramek: /* Attribute */

==Name==
<sp:calendarsheet> - CalendarSheet-Tag zur Verwaltung eines [[CalendarSheet]]-Objektes

==Syntax==
<source lang="xml">
<sp:calendarsheet name="variable" action="new" from="" to=""/>
</source>

==Beschreibung==
Dieser Tag legt ein [[CalendarSheet]]-Objekt an und liefert Funktionen zum Befüllen. Ein [[CalendarSheet]] ist ein Object, welches [[Daten|Date] für einen bestimmten Zeitraum sammeln und nach Tagen gruppieren kann. Dies erlaubt die einfache und effiziente Auswertung aller Termine, die in den definierten Zeitraum fallen.

Ein praktisches Beispiel ist z.B. die Jahres oder Monatsansicht eines Kalenders. Eine Suchabfrage kann alle Termine innerhalb des gewünschten Monats ermitteln. Über CalendarSheet-Tag wird dann für diesen Zeitraum ein entsprechendes Objekt angelegt. In einer Schleife über alle Treffer der Suchabfrage können diese in das [[CalendarSheet]] übertragen werden. Die Auswertung des [[CalendarSheets|CalendarSheet]] erfolgt dann einfach über eine Loop über alle Tage des genannten Zeitraums. Es braucht nicht jeder Tag über eine einzelne Suchabfrage ausgewertet werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Attribute]]
| Ja
| None
| 2
|-
| <code>action</code>
| [[Text]]
| Ja
| None
| 2
|-
| <code>value</code>
| [[Text]]
| Ja oder object bzw. date
| None
| 2
|-
| <code>object</code>
| [[Object]]
| Ja oder value bzw. date
| None
| 2
|-
| <code>date</code>
| [[Date]]
| Ja oder object bzw. value
| None
| 2
|-
| <code>from</code>
| [[Date]]
| Ja
| None
| 2
|-
| <code>to</code>
| [[Date]]
| Ja
| None
| 2
|-
| <code>scope</code>
| [[Text]]
| Nein
| None
| 2
|}

;<code>name</code>
:Name über den das [[CalendarSheet]] angesprochen werden kann.

;<code>action</code>
:Aktion, die ausgeführt werden soll. Es existieren die Aktionen <code>add</code>, <code>clear</code> und <code>new</code>.

;<code>value</code>
:Zu setzendes [[CalendarInformation]]-Objekt. Dieser wird immer als Zeichenkette ausgewertet.

;<code>object</code>
:Evaluiert das Attribut und setzt das entsprechende [[CalendarInformation]]-Objekt. Im Gegensatz zu <code>value</code> wird hier das Objekt gespeichert und nicht der Text.

;<code>date</code>
:Zu setzender Wert. Hiermit kann direkt ein einzelnes [[Date|Datum]] angegeben werden.

;<code>from</code>
:Über diesen Parameter wird der zeitliche Rahmen des CalendarSheets festgelegt.

;<code>to</code>
:Über diesen Parameter wird der zeitliche Rahmen des CalendarSheets festgelegt.

;<code>scope</code>
:[[Scope|Namensraum]], in dem die Variable definiert ist. Für diesen Tag ist der Page- und Request-Scope möglich (<code>page</code>, <code>request</code>).

==Beispiele==

CalendarSheet aufbauen
<source lang="xml">
<%-- Übertragung aller Ergebnisse in das CalendarSheet --%>
<sp:calendarsheet name="_cal" action="new" from="${_from}" to="${_to}"/>
<sp:loop collection="_result" item="it">
<sp:calendarsheet name="_cal" action="add" object="it.sp_date"/>
</sp:loop>
</source>

CalendarSheet ausgeben
<source lang="text">
<sp:loop collection="_cal.entries.keys" item="day">
<sp:sort name="_events" collection="_cal.entries(${day.reference})" keys="name" sequences="asc" types="text"/>
<sp:loop collection="_events" item="it">
<tt><sp:print name="it.date"/></tt> <sp:print name="it.name"/><br>
</sp:loop>
</sp:loop>
</source>

<noinclude>
[[Category:SP-Tags]]
</noinclude>

Checkbox (SP-Tag)

2008-11-12T09:59:26Z

Schramek: /* Attribute */

==Name==
<sp:checkbox> - erzeugt eine Checkbox

==Syntax==
<source lang="xml">
<sp:checkbox name="variable" value="Inhalt"/>
</source>

==Beschreibung==
Der Checkbox-Tag erzeugt eine HTML-Checkbox.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=checked|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
;<code>value</code>
:Setzt einen zu übertragenen Wert dieser Checkbox
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=checked|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Checkboxen mit Label===

Template Quelltext
<source lang="xml">
Wählen Sie aus<br>
<sp:checkbox name="check_food" value="Wurst"/> <label for="<sp:print name="system.tag"/>">Wurst</label><br>
<sp:checkbox name="check_food" value="Käse"/> <label for="<sp:print name="system.tag"/>">Käse</label><br>
<sp:checkbox name="check_food" value="Milch"/> <label for="<sp:print name="system.tag"/>">Milch</label><br>
</source>
Mit <code><sp:print name="system.tag"/></code> wird die interne id des vorangegangenen SP-Tags ermittelt und ausgegeben.

===Checkboxen mit dynamischem Attribut "id" und Label===

Template Quelltext
<source lang="xml">
Wählen Sie aus<br>
<table>
<tr>
<td><label for="wurst">Wurst</label></td>
<td><sp:checkbox name="check_food" value="Wurst" id="wurst"/></td>
</tr>
<tr>
<td><label for="kaese">Käse</label></td>
<td><sp:checkbox name="check_food" value="Käse" id="kaese"/></td>
</tr>
<tr>
<td><label for="milch">Milch</label></td>
<td><sp:checkbox name="check_food" value="Milch" id="milch"/></td>
</tr>
</table>
</source>
Für den Fall, dass ein Label vor dem zugehörigen SP-Tag ausgegeben werden soll, kann für die Checkbox eine eigene id vergeben werden. Zu beachten ist hierbei jedoch, dass die id innerhalb eines HTML-Seite eindeutig sein muss. Bei Iterates sollte daher noch ein Zähler in die id einbezogen werden.

<noinclude>
[[Category:SP-Tags]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Condition (SP-Tag)

2008-11-12T09:59:04Z

Schramek: /* Attribute */

==Name==
<sp:condition>, <sp:if>, <sp:elseif>, <sp:else> - Bedingungen prüfen

==Syntax==
<source lang="php">
<sp:if condition="${a} > ${b}">
...
</sp:if>

<sp:condition>
<sp:if condition="${a} <= 0">
...
</sp:if>
<sp:elseif condition="${a} > 0 && ${a} < 10">
...
</sp:elseif>
<sp:elseif condition="${a} >= 10 && ${a} < 100">
...
</sp:elseif>
<sp:else>
...
</sp:else>
</sp:condition>
</source>

==Beschreibung==
Die vier Tags ermöglichen es verschiedene Bedingungen abzufragen. Einfache Abfragen können direkt mit <code><sp:if></code> erstellt werden. Werden else- bzw. elseif-Bedingungen in einer Abfrage benötigt, muss die gesamte Abfrage-Struktur mit <code>sp:condition</code> umschlossen werden. Zu beachten ist hier, dass zwischen <code><sp:condition></code> und <code><sp:if></code> kein Text stehen darf. Das gleiche gilt für <code></sp:if></code> und <code><sp:elseif></code>, <code></sp:elseif></code> und <code><sp:elseif></code>, <code></sp:elseif></code> und <code><sp:else></code> sowie <code></sp:else></code> und <code></sp:condition></code>.

Es bestehen zwei Möglichkeiten zur Abfrage einer Bedingung. Zum einen können Sie mit dem <code>name</code>-Attribut in Verbindung mit <code>gt</code>, <code>gte</code>, <code>lt</code>, usw. die zu prüfende Bedingung angegeben. Zum anderen können Sie für komplexe Abfragen mit dem <code>condition</code>-Attribut komplexe Bedingungen zu formulieren. Innerhalb dieses Attributes können Ausdrücke beispielsweise wie folgt angegeben werden.

<source lang="xml">
<sp:if condition="(${a} > ${b}) && ((${a} + 3) / 10 < ${b})}">
..
</sp:if>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja oder <code>condition</code>
| None
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>isNull</code>
| [[Condition]]
| Nein
| None
| 1
|-
| <code>ic</code>
| [[Condition]]
| Nein
| false
| 1
|-
| <code>contains</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>match</code>
| [[Regular-Expression]]
| Nein
| None
| 1
|-
| <code>eq</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>neq</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>gt</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>gte</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>lt</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>lte</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>condition</code>
| [[Condition]]
| Nein
| None
| 1
|}

;<code>name</code>
:Variablenname eines Objektes das verglichen werden soll.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachiger Variablen.

;<code>isNull</code>
:Die Bedingung ist erfüllt, wenn die Variable in <code>name</code> leer oder nicht vorhanden ist und <code>isNull</code> den Wert <code>true</code> hat. Wenn <code>isNull</code> den Wert <code>false</code> hat, ist die Bedingungen erfüllt, wenn die die Variable in <code>name</code> nicht leer ist.

;<code>ic</code>
:Die Auswertung soll "ignore case" durchgeführt werden. Bezieht sich auf <code>eq</code>, <code>neq</code>, <code>gt</code>, <code>gte</code>, <code>lt</code>, <code>lte</code>, und <code>contains</code>.

;<code>contains</code>
:Zeichenkette, die in der Variablen enthalten sein soll.

;<code>match</code>
:Regulärer Ausdruck, der in der Variablen enthalten sein soll.

;<code>eq</code>
:Die Bedingung ist erfüllt, wenn die Variable in <code>name</code> gleich der Variable in <code>eq</code> ist.

;<code>neq</code>
:Die Bedingung ist erfüllt, wenn die Variable in <code>name</code> ungleich der Variable in <code>neq</code> ist.

;<code>gt</code>
:Die Bedingung ist erfüllt, wenn die Variable in <code>name</code> grösser als der Variable in <code>gt</code> ist.

;<code>gte</code>
:Die Bedingung ist erfüllt, wenn die Variable in <code>name</code> grösser oder gleich der Variable in <code>gte</code> ist.

;<code>lt</code>
:Die Bedingung ist erfüllt, wenn die Variable in <code>name</code> kleiner als in der Variable in <code>lte</code> ist.

;<code>lte</code>
:Die Bedingung ist erfüllt, wenn die Variable in <code>name</code> kleiner oder gleich der Variable in <code>lte</code> ist.

;<code>condition</code>
:Es wird eine [[Condition]] erwartet, die den Wert <code>true</code> oder <code>false</code> zurückliefert.

==Beispiele==

===isNull Prüfung===

Template Quelltext
<source lang="xml">
<sp:set name="foo" value="bar"/>
<sp:if name="foo"> foo ist definiert!
</sp:if>

<%-- kein Inhalt ist gleichbedeutend mit 'nicht definiert' --%>

<sp:set name="foo" value=""/>

<sp:if name="foo" isNull="true">
foo ist nicht definiert!
</sp:if>
</source>

Ausgabe
<source lang="text">
foo ist definiert!
foo ist nicht definiert!
</source>

===Einfache if Bedingung===

Template Quelltext
<source lang="xml">
<sp:set name="foo" value="bar"/>
<sp:if name="foo" eq="bar">
foo hat den Wert <sp:print name="foo"/>
</sp:if>
</source>

Ausgabe
<source lang="text">
foo hat den Wert bar
</source>

===Einfache if-elseif-else Bedingung===

Template Quelltext
<source lang="xml">
<%--
Bei der Verwendung von if-elseif-else Konstrukten müssen die
einzelnen Tags in einem <sp:condition> zusammengefasst werden.
--%>
<sp:condition>
<sp:if name="foo" eq="foo">
Ich bin im if-Zweig
</sp:if>
<sp:elseif name="foo" eq="barx">
Ich bin im ersten ifelse-Zweig
</sp:elseif>
<sp:elseif name="foo" eq="bar">
Ich bin im zweiten elseif-Zweig
</sp:elseif>
<sp:elseif condition="!isNull(${foo})">
Ich bin im dritten elseif-Zweig
</sp:elseif>
<sp:else>
Ich bin im else-Zweig
</sp:else>
</sp:condition>
</source>

Ausgabe
<source lang="text">
Ich bin im zweiten elseif-Zweig
</source>

===Abfrage mit condition===

Template Quelltext
<source lang="xml">
<sp:if condition="${foo} == 'bar'">
${foo} == 'bar' liefert true
</sp:if>

<sp:set name="x" value="5"/>
<sp:set name="y" value="10"/>

<sp:if condition="(${x} + ${y}) == 15">
Die Summe von x und y ist 15
</sp:if>

<sp:if condition="${x} > 2 && ${x} < 20">
x ist größer als 2 und kleiner als 20
</sp:if>
</source>

Ausgabe
<source lang="text">
${foo} == 'bar' liefert true
Die Summe von x und y ist 15
x ist größer als 2 und kleiner als 20
</source>

===Prüfe Boolean===

Template Quelltext
<source lang="xml">
<sp:set name="boolean" value="true"/>
<sp:if condition="${boolean} == true">
1: boolean ist wahr.
</sp:if>
<sp:if condition="${boolean} == 'true'">
2: boolean ist wahr.
</sp:if>
<sp:if condition="${boolean} == 1">
3: boolean ist wahr.
</sp:if>
</source>

Ausgabe
<source lang="text">
2: boolean ist wahr.
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Collection (SP-Tag)

2008-11-12T09:58:57Z

Schramek: /* Attribute */

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

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

==Beschreibung==
Mit Hilfe von <code>sp:collection</code> 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.

Listen können erzeugt werden, indem die einzelnen Einträge über die <code>action</code> <code>add</code>, bzw. <code>addAll</code> hinzugefügt werden. Listen können aber auch über Suchabfragen mit dem Attribut <code>query</code> oder den Attribut <code>object</code> (wenn ein [[QueryInformation]]-Objekt übergeben wird) erzeugt werden.

'''(Ab Version 2.0.3)'''

Werte können über die Attribute value oder object gesetzte werden. Alternativ ist es auch möglich den Wert im Body des Tags zu setzten. Hierbei wird zunächst der Body ausgeführt und das Ergebnis verwendet

<source lang="xml">
<sp:collection name="family" action="add"><sp:print name="father"/></sp:collection>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>action</code>
| [[Text]]
| Ja außer für query
| None
| 1
|-
| <code>value</code>
| [[Text]]
| Ja oder object oder im Body des Tags, für add und replace
| None
| 1
|-
| <code>object</code>
| [[Attribute]]
| Ja oder value oder im Body des Tags, für add und replace
| None
| 1
|-
| <code>index</code>
| [[Expression]]
| Ja, für remove und replace
| None
| 1
|-
| <code>query</code>
| [[SPQL|Query]]
| Nein
| None
| 1
|-
| <code>publisher</code>
| [[Text]]
| Nein
| auto
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>scope</code>
| [[Scope]]
| Nein
| request
| 1
|}

;<code>name</code>
:Name der Liste.

;<code>action</code>
:Aktion, die ausgeführt werden soll. Es existieren die Aktionen <code>add</code>, <code>addAll</code>, <code>remove</code>, <code>clear</code>, <code>new</code>, <code>replace</code>, <code>removeFirst</code>, <code>removeLast</code> und <code>unique</code>.
:;add
::Fügt ein Element an das Ende der Liste. Ist ein <code>index</code> angegeben, so wird das Element an dieser Position eingefügt. Das ursprüngliche Elemente und alle nachfolgenden Elemente werden eine Position weiter geschoben.
:;addAll
::Mit dieser Aktion können mehrere Elemente der Liste hinzugefügt werden. Dazu muß <code>object</code> vom Typ [[Collection]] sein.
:;remove
::Löscht ein Element aus der Liste. Ist <code>index</code> angegeben, wird das Element an der Index-Position gelöscht und alle nachfolgenden Elemente rutschen eine Position nach oben. Ist <code>object</code> bzw. <code>value</code> angegeben, wird das Element in der Liste gesucht und gelöscht.
:;clear
::Löscht alle Elemente aus der Liste.
:;new
::Erzeugt eine neue leere Liste.
:;replace
::Ersetzt ein Element der Liste. <code>index</code> gibt hierbei die Position des Elements an, das durch <code>object</code> bzw. <code>value</code> ersetzt werden soll.
:;removeFirst
::Löscht das erste Element der Liste.
:;removeLast
::Löscht das letzte Element der Liste.
:;unique
::Entfernt alle mehrfach vorkommenden Elemente aus der Liste.

;<code>value</code>
:Ein [[Text]], der mit der Liste verarbeitet werden soll.

;<code>object</code>
:Ein [[Object|Objekt]] das mit der Liste verarbeitet werden soll. Ist <code>object</code> vom Typ [[QueryInformation]], so gilt das gleiche wie beim Attribut <code>query</code>.

;<code>index</code>
:Listen-Position mit der eine Aktion ausgeführt werden soll.

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

;<code>publisher</code>
:Wird der Collection-Tag in Verbindung mit Suchabfragen verwendet (durch <code>query</code> oder <code>object</code>), ist ein Publikationsbereich erforderlich, mit der die Suchabfrage ausgeführt werden soll. Mit diesem Attribute können ein oder mehrere Publikationsbereiche angegeben werden (durch Kommata getrennt). Entweder werden die Publikationsbereiche durch ihren Anchor angegeben, oder folgende Schlüsselwörter verwendet:
:;current
::Der aktuelle Publikationsbereich. Dieser steht im <code>out</code>- und <code>preview</code>-Modus zur Verfügung.
:;ignore
::Ignoriert die Publikationsbereiche und liefert die Treffer unabhängig davon, ob sie publiziert sind oder nicht.
:;all
::Alle Publikationsbereiche des Mandanten.
:;auto
::Entspricht im <code>out</code>- und <code>preview</code>-Modus dem Schlüsselwort <code>current</code> und im <code>in</code>-Modus <code>ignore</code>.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

;<code>scope</code>
:[[Scope|Namensraum]], in dem die Variable definiert ist. Für diesen Tag ist der Page- und Request-Scope möglich (<code>page</code>, <code>request</code>).

==Beispiele==

===Eine Liste von Strings erstellen===

Template Quelltext
<source lang="xml">
<sp:collection name="myList" action="add" value="peter"/>
<sp:collection name="myList" action="add" value="paul"/>
<sp:collection name="myList" action="add" value="mary"/>
</source>

===Zwei Listen zu einer Liste vereinen===

Template Quelltext
<source lang="xml">
<sp:collection name="family" action="add" value="father"/>
<sp:collection name="family" action="add" value="mother"/>
<sp:collection name="family" action="add" value="sister"/>
<sp:collection name="family" action="add" value="brother"/>

<sp:collection name="friends" action="add" value="girl friend"/>
<sp:collection name="friends" action="add" value="boy friend"/>

<sp:collection name="nice_people" action="addAll" object="family"/>
<sp:collection name="nice_people" action="addAll" object="friends"/>
</source>

===Suchabfrage ausführen===

Template Quelltext
<source lang="xml">
<sp:collection name="queryResult" query="infolevel = 'content'"/>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Text (SPT-Tag)

2008-11-12T09:57:26Z

Schramek: /* Attribute */

==Name==
<spt:text> - einzeiliges Textfeld, das Versionierung unterstützt

==Syntax==
<source lang="xml">
<spt:text name="Variablenname" size="20"/>
</source>

==Beschreibung==
Der <code><spt:text></code>-Tag erzeugt ein Textfeld, das die Darstellung von Versionsunterschieden in InfoSite5 unterstützt. Werden im Untermenüpunkt ''Bearbeitung'' ältere Versionen der Information ausgewählt, so erscheinen die mit der ausgewählten Version vorgenommenen inhaltlichen Änderungen des Textfeldes.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=format|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>size</code>
| [[Number]]
| Nein
| 20
| 1
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=format|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>size</code>
:'size'-Wert des generierten input-Tags.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Einfache Ein- und Ausgabe eines Textfeldes===

Template Quelltext
<source lang="xml">
<sp:io type="in">
Überschrift:<br>
<spt:text name="sp_headline" size="25"/>
</sp:io>

<sp:io type="out">
<h1><sp:print name="sp_headline"/></h1>
</sp:io>

</source>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Textarea (SPT-Tag)

2008-11-12T09:57:21Z

Schramek: /* Attribute */

==Name==
<spt:textarea> - Erzeugt ein mehrzeiliges Textfeld, das Versionierung unterstützt

==Syntax==
<source lang="xml">
<spt:textarea name="Variablenname" rows="60" cols="5">
</source>

==Beschreibung==
Der <code>spt:textarea</code>-Tag erzeugt ein Textarea, das die Versionierung für Informationen in InfoSite unterstützt. Werden im Untermenüpunkt Bearbeitung ältere Versionen der Information ausgewählt, so erscheinen die mit der ausgewählten Version vorgenommenen inhaltlichen Änderungen der Textarea.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Einfache Textarea===

Textarea mit den dynamischen Attributen cols und rows
<source lang="xml">
<sp:io type="in">
Textabschnitt:<br>
<spt:textarea name="sp_text" cols="20" rows="5"/>
</sp:io>

<sp:io type="out">
<sp:print name="sp_text"/>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Tinymce (SPT-Tag)

2008-11-12T09:57:17Z

Schramek: /* Attribute */

==Name==
<spt:tinymce> - Integriert einen Editor

==Syntax==
<source lang="xml">
<spt:tinymce name="variable" theme="simple"/>
</source>

==Beschreibung==
Mit dem tinymce-Tag wird ein externer WYSIWYG-Editor ins CMS eingebunden. "<b>W</b>hat <b>Y</b>ou <b>S</b>ee <b>I</b>s <b>W</b>hat <b>Y</b>ou <b>G</b>et" steht für eine Übernahme des geschriebenen Textes auf der Website, so wie ihn der Redakteur bei der Eingabe sieht. So kann der Redakteur z.B. Tabellen ohne HTML-Kenntnisse in seine Artikel einfügen. Die Ausgabe hängt aber nicht nur vom Editor, sondern auch von den Einstellungen des Browsers und auch von installierten Systemschriften ab.

Der Editor tinymce ist ein Open-Source Produkt der Firma [http://tinymce.moxiecode.com Moxiecode]. Der Editor kann im Rahmen des CMS "so wie er ist" genutzt werden. Der Editor ist kein Produkt der Sitepark GmbH und kann daher auch nicht direkt supported werden. Bug-Meldungen und Erweiterungswünsche werden von Sitepark an den Hersteller weitergeleitet.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>rows</code>
| [[Number]]
| Nein
| 15
| 1
|-
| <code>cols</code>
| [[Number]]
| Nein
| 80
| 1
|-
| <code>theme</code>
| [[Text]]
| Nein
| default
| 1
|-
| <code>pools</code> (experimentell)
| [[Anchor]]-List oder [[ID]]-List
| Nein
| aktueller Informationspool
| 1
|-
| <code>buttons</code>
| [[Text]]
| Nein
| default
| 1
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>rows</code>
:Höhe des Eingabefeldes in Zeilen.

;<code>cols</code>
:Breite des Eingabefeldes in Spalten.

;<code>theme</code>
:Konfigurationstypen, die den Funktionsumfang für den Editor beschreiben. Mögliche Themes sind:
:;simple
:;default
:;advanced

;<code>buttons</code>
:Konfigurationseinstellung, die den Funktionsumfang für den Editor beschreibt. Mögliche Werte sind:
:;minimum

;<code>pools</code>
:Kommaseparierte Liste von [[Anchor|Anchors]] von Artikelpools oder von [[ID|IDs]] von Artikelpools; die Elemente der Pools werden dem Redakteur in einem Linkdialog innerhalb des Editors zur Auswahl angeboten. Diese Funktion ist derzeit noch im Versuchsstadium und wird daher nicht offiziell unterstützt.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===WYSIWYG-Editor nutzen und Inhalt ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<sp:print name="sp_body"/>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Updown (SPT-Tag)

2008-11-12T09:57:13Z

Schramek: /* Attribute */

==Name==
<spt:updown> - Zahlenfeld, das per Klick auf- und abwärts gezählt werden kann

==Syntax==
<source lang="xml">
<spt:updown name="Variablenname" value="10"/>
</source>

==Beschreibung==
Der Updown-Tag erzeugt ein Auswahlfeld, welches dem Redakteur ermöglicht aus einem festgelegten Bereich (Standard ist 1-10, unendlich) einen bestimmten Wert zu definieren. So wird z.B. eine bestimmte Anzahl von Ergebnissen pro Seite anzeigt.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
| <code>from</code>
| [[Number]]
| Nein
| 1
| 1
|-
| <code>to</code>
| [[Number]]
| Nein
| MAX_INT
| 1
|-
| <code>value</code>
| [[Number]]
| Nein
| 10
| 1
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
;<code>from</code>
:Startwert des Bereichs (Minimalwert).

;<code>to</code>
:Endwert des Bereichs (Maximalwert, es folgt 'unendlich').

;<code>value</code>
:Default-Wert (Vorgabewert).
{{sp_input_attributes|attribute=locale|mode=desc}}

==Beispiele==

===spt:updown mit sprachspezifischem Auswahlfeld===

Template Quelltext
<source lang="xml">
<spt:updown name="limit" value="10" from="5" to="20" locale="de_AT"/>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
</noinclude>

Imp (SPT-Tag)

2008-11-12T09:56:12Z

Schramek: /* Attribute */

==Name==
<spt:imp> - Erzeugt ein <img src="...">-Tag für klein gerechnete sowie aus Texten generierte Bilder

==Syntax==
<source lang="xml">
<spt:imp image="variable" width="50" height="50"/>
</source>

==Beschreibung==
Mit dem <code>imp</code>-Tag können kleinere Versionen eines Bildes in eine HTML-Seite eingebunden werden. Desweiteren ist es mit diesem Tag möglich aus einem Text eine Grafik zu erzeugen. Der Tag erzeugt ein <img src=".." ..> HTML-Tag.

Funktionen des Tags:
* skalieren aller Bilder "on demand" (Vorschaubild/Detailbild/Download werden von einer Bilddatei generiert), um Bildverwaltung und vor allem manuelle Bildbearbeitung zu vermeiden
* Active Caching für alle Auflösungen und Formate
* automatisches Erzeugen von Textgrafiken aus im CMS eingegebenen Texten für Headlines in der Unternehmensschrift
* dynamische Berechnung der HTML-Attribute width und height
* Spam-Schutz durch codierte E-Mail-Adressen mit Bildausgabe der Klartextadresse

<code>spt:imp</code> verwendet <code>[[sp:scaleimage]]</code> und <code>[[sp:textimage]]</code>, vereinigt dessen Funktionen und erzeugt im Unterschied zu den beiden Tags einen img-HTML-Tag.

Dieser Tag verhält sich im [[Template-Modus|In-]] und im [[Template-Modus|Out-Modus]] unterschiedlich.

;Out-Modus
:Im Out-Modus wird das Bild erzeugt und über den <img src="..."> eingebunden
;In-Modus
:Im In-Modus werden nicht alle verlangten Bildgrößen berechnet. Aus Optimierungsgründen wird nur ein Satz von Bildgrößen verwendet (in der [[BinDB]] konfigurierbar). Die pixelgenaue Verkleinerung übernimmt dann der Browser. Das Padding wird über CSS-Styles realisiert (siehe auch <code>[[sp:scaleimage]]</code>).

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>image</code>
| [[Attribute]]
| Ja
| None
| 1
|-
| <code>width</code>
| [[Number]]
| Nein
| 100
| 1
|-
| <code>height</code>
| [[Number]]
| Nein
| 100
| 1
|-
| <code>resolution</code> ([[deprecated]] ab Version 1.3)
| [[Text]]
| Nein
| None
| 1
|-
| <code>format</code>
| [[Text]]
| Nein
| png
| 1
|-
| <code>background</code>
| [[Number]]
| Nein
| FFFFFF
| 1
|-
| <code>urlonly</code> ([[deprecated]] ab Version 2.0)
| [[Condition]]
| Nein
| false
| 1
|}

zusätzliche Attribute für Thumbnails
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>padding</code>
| [[Text]]
| Nein
| on (Achtung: anderer <code>default</code>-Wert als bei [[sp:scaleimage]])
| 1
|-
| <code>paddingcolor</code> ([[deprecated]] ab Version 2.0)
| [[Number]]
| Nein
| FFFFFF
| 1

|-
| <code>excerpt</code> ([[deprecated]] ab Version 2.0)
| [[Number]]
| Nein
| None
| 1
|-
| <code>manipulate</code> ([[deprecated]] ab Version 2.0)
| [[Text]]
| Nein
| None
| 1
|}

zusätzliche Attribute für Texte
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>text</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>fontname</code>
| [[Text]]
| Nein
| Arial
| 2
|-
| <code>fontcolor</code>
| [[Text]]
| Nein
| 000000
| 2
|-
| <code>fontsize</code>
| [[Number]]
| Nein
| 12
| 2
|-
| <code>fontweight</code>
| [[Text]]
| Nein
| plain
| 2
|-
| <code>color</code> ([[deprecated]] ab Version 2.0)
| [[Text]]
| Nein
| 000000
| 1
|-
| <code>font</code> ([[deprecated]] ab Version 2.0)
| [[Text]]
| Nein
| None
| 1
|-
| <code>font-size</code> ([[deprecated]] ab Version 2.0)
| [[Number]]
| Nein
| None
| 1
|-
| <code>font-weight</code> ([[deprecated]] ab Version 2.0)
| [[Text]]
| Nein
| None
| 1
|-
| <code>gravity</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>offset</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>transform</code> ([[deprecated]] ab Version 2.1)
| [[Text]]
| Nein
| None
| 2
|-
| <code>text-transform</code> ([[deprecated]] ab Version 2.0)
| [[Text]]
| Nein
| None
| 1
|}

;<code>image</code>
:Bild-Object, das mit dem <code>spt:imp</code>-Tag verarbeitet werde soll.

;<code>width</code>
:Die gewünschte Bildbreite z.b. 100. Die Höhe wird unter Beibehaltung der Seiten-Verhältnisse des Originalbildes oder des gewählten Ausschnittes berechnet. Bei gesetzter Breite ist daher die Option <code>padding</code> zwingend auf <code>no</code> gesetzt

;<code>height</code>
:Die gewünschte Bildhöhe z.b. 100. Die Breite wird unter Beibehaltung der Seiten-Verhältnisse des Originalbildes oder des gewählten Ausschnittes berechnet. Bei gesetzter Höhe ist daher die Option <code>padding</code> zwingend auf <code>no</code> gesetzt.

;<code>resolution</code> ([[deprecated]] ab Version 1.3)
: '''''Deprecated.''' Das Attribut ist veraltet, es sollten die Attribute <code>width</code> und <code>height</code> verwendet werden.''

:Die gewünschte Bildgröße z.b. 100x100. Es gelten die Regeln wie für <code>width</code> und <code>height</code>.

;<code>format</code>
:Die Formate <code>png</code> und <code>jpeg</code> können für Thumbnails verwendet werden.

;<code>background</code>
:Die Farbe des Hintergrunds kann durch Hexadezimalwerte gesetzt werden (z.B. e3a383). Für Thumbnails wird hiermit die Farbe des <code>padding</code>-Rahmens bestimmt. Für Textbilder wird hiermit die Hindergrundfarbe des Bildes gesetzt.

;<code>urlonly</code> ([[deprecated]] ab Version 2.0)
: '''''Deprecated.''' Das Attribut ist veraltet, und sollte nicht mehr verwendet werden. Wird nur die URL benötigt oder weiterer Metadaten des berechneten Bildes sollte der Tag [[sp:scaleimage]] für Thumbnails oder [[sp:textimage]] für Texte verwendet werden.''

:schreibt nur die URL ohne <img>-Tag heraus.

'''zusätzliche Attribute für Thumbnails'''

;<code>padding</code>
:Der Wert "<code>on</code>" erzeugt Rahmen zur Auffüllung der Flächen um das Bild. Damit ist das resultierende Bild immer so groß wie durch die Auflösung gefordert. <code>padding=on</code> ist als Standardwert gesetzt, solange es nicht durch andere Optionen ausgeschlossen ist.

:Der Wert "<code>off</code>" erzeugt keinen Rahmen zur Auffüllung der Flächen um das Bild. Damit ist das resultierende Bild unter Umständen kleiner als die geforderte Auflösung.

:Mit "<code>fit</code>" wird der größte mögliche Ausschnitt aus dem Originalbild, bzw. aus dem durch <code>excerpt</code> gewählten Ausschnitt gesucht, bei dem das Seitenverhältnis der geforderten Auflösung entspricht. Es wird kein Rahmen erzeugt, sondern das Bild in einer Dimension gegebenenfalls gekürzt.

:Aufgrund von Abwärtskompatibilität wird auch der Wert "<code>yes</code>" (entspricht "<code>on</code>") und "<code>no</code>" (entspricht "<code>off</code>") unterstützt.

;<code>paddingcolor</code> ([[deprecated]] ab Version 2.0)
:'''''Deprecated.''' Dieses Attribut ist veraltet. Es sollte das Attribut <code>background</code> verwendet werden.''
:Mit <code>paddingcolor</code> kann durch Hexadezimalwerte oder X-Window-Namen die Farbe des Rahmen bzw. des Hintergrundes, die bei <code>padding=yes</code> verwendet wird, angegeben werden. <code>transparent</code> ist das Default.

;<code>excerpt</code> ([[deprecated]] ab Version 2.0)
:'''''Deprecated.''' Dieses Attribut wird nicht mehr unterstützt.''

:Diese Option schneidet einen Ausschnitt eines größeren Bildes aus. Die ersten beiden Zahlen geben die linke obere Ecke des Ausschnittes an, die letzteren beiden die untere rechte Ecke. Mögliche Werte sind x0,y0,x1,y1 z.B. 100,100,300,200. Dieser Ausschnitt wird entsprechend der Option <code>resolution</code> noch verkleinert oder vergrößert. Hierbei wird gegebenenfalls ein Rand erzeugt, sprich die Option <code>padding=yes</code> ist automatisch gesetzt, falls nicht <code>padding=fit</code> gesetzt ist.

:Alle 4 Zahlen können auch negativ sein. In diesem Fall wird der Wert als Differenz zum hinteren oder unteren Rand des Bildes berechnet. Also bedeutet -10% dasselbe wie 90% und -100 bei einem 300 Pixel breiten (oder hohen) Bild dasselbe wie 200. Ist x0 > x1 so wird das Bild an der x-Achse gespiegelt.

:Ist y0 > y1 so wird das Bild an der y-Achse gespiegelt. Mit Angabe der Werte x0,y0 z.B. 100,50 wird der Ausschnitt in der exakten Größe der mittels <code>resolution</code> geforderten Auflösung gewählt. Es ist dann keine Verkleinerung oder Vergrößerung mehr notwendig und man erhält einen 1:1 Ausschnitt des Orignals. Hierbei ist immer <code>padding=no</code> gesetzt.

:Mit den Variablen <code>north</code>, <code>west</code>, <code>east</code> oder <code>south</code> wird ein in der jeweiligen Himmelsrichtung gelegener Ausschnitt in der mittels <code>resolution</code> geforderten Auflösung gewählt. Also wird mit <code>excerpt=south</code> ein Ausschnitt auf der Mitte der Bildbreite ganz unten gewählt, mit <code>excerpt=east</code> dagegen ein Ausschnitt aus der Mitte der Bildhöhe ganz rechts. Es ist dann keine Verkleinerung oder Vergrößerung mehr notwendig und man erhält einen 1:1 Ausschnitt des Orignals. Hierbei is immer <code>padding=no</code> gesetzt.

:Mit <code>northwest</code>, <code>northeast</code>, <code>southwest</code> oder <code>southeast</code> wird ein in der jeweiligen Himmelsrichtung gelegener Ausschnitt in der mittels <code>resolution</code> geforderten Auflösung gewählt. Also wird mit <code>excerpt=southeast</code> die äusserste untere, rechte Ecke des Originalbildes gewählt, mit <code>excerpt=northwest</code> dagegen die obere, linke Ecke. Es ist dann keine Verkleinerung oder Vergrößerung mehr notwendig und man erhält einen 1:1 Ausschnitt des Orignals. Hierbei is immer <code>padding=no</code> gesetzt.

;<code>manipulate</code> ([[deprecated]] ab Version 2.0)
: '''''Deprecated.''' Dieses Attribut wird nicht mehr unterstützt.''

:Erzeugt verschiedene Effekte wie weichzeichnen oder schärfen über <code>sharp1, sharp2, sharp3, sharp4, laplace1, laplace2, box, lowpass, neon, emboss</code> und <code>bw</code>

'''zusätzliche Attribute für Texte'''

;<code>text</code>
:Der auszugebende Text in URL-encodeter Form.

;<code>fontname</code>
:Der Font (z.B. Arial)

;<code>fontcolor</code>
:Die Farbe der Schrift. Beispielsweise <code>AA00DD</code> oder <code>ff77ff</code>

;<code>fontsize</code>
:Punkt-Größe des zu verwendenden Fonts (z.b.: 12)

;<code>fontweight</code>
:Die Dicke (Wichtung) des angegeben Fonts (z.b.: bold, 200 oder 900).

;<code>color</code> ([[deprecated]] ab Version 2.0)
: '''''Deprecated.''' Dieses Attribut ist veraltet ist sollte das Attribut <code>fontcolor</code> verwendet werden.''

:Die Farbe der Schrift. Beispielsweise AA00DD oder ff77ff

;<code>font</code> ([[deprecated]] ab Version 2.0)
: '''''Deprecated.''' Dieses Attribut ist veraltet ist sollte das Attribut <code>fontname</code> verwendet werden.''

:Der Font (z.B. Arial)

;<code>fontSize</code> ([[deprecated]] ab Version 2.0)
: '''''Deprecated.''' Dieses Attribut ist veraltet ist sollte das Attribut <code>fontsize</code> verwendet werden.''

:Punkt-Größe des zu verwendenden Fonts (z.b.: 12)

;<code>font-weight</code> ([[deprecated]] ab Version 2.0)
: '''''Deprecated.''' Dieses Attribut ist veraltet ist sollte das Attribut <code>fontweight</code> verwendet werden.''

:Die Dicke (Wichtung) des angegebenen Fonts (z.b.: bold, 200 oder 900).

;<code>gravity</code>
:Mit den Werten n, w, e, s, nw, ne, sw, se oder Center, North, South, NorthEast etc. kann die gewünschte Position des Textes im umgebenen Rahmen ausgerichtet werden. West ist der Standardwert. Das heisst alle Texte werden links auf mittlerer Höhe angefangen.

;<code>offset</code>
:Der Anfangspunkt des auszugebenden Textes von der Seite, die über die Option <code>gravity</code> angegeben ist, aus gesehen. Ohne Angabe von <code>gravity</code> ist dies normalerweise die linke Seite mittig (z.b.: 3,10 )

;<code>transform</code> ([[deprecated]] ab Version 2.1)
: '''''Deprecated.''' Dieses Attribut ist veraltet. Umwandlung von Texten sollten über das Attribute und Methoden des [[String]]-Objektes durchgeführt werden

:Manipulation des Textes, bevor der Bild Berechnet wird. Mögliche Werte sind
:* <code>uppercase</code> - Alle Zeichen in Großbuchstaben umwandeln
:* <code>lowercase</code> - Alle Zeichen in Kleinbuchstaben umwandeln

;<code>text-transform</code> ([[deprecated]] ab Version 2.0)
: '''''Deprecated.''' Dieses Attribut ist veraltet. Umwandlung von Texten sollten über das Attribute und Methoden des [[String]]-Objektes durchgeführt werden''

:Manipulation des Textes, bevor der Bild Berechnet wird. Mögliche Werte sind
:* <code>uppercase</code> - Alle Zeichen in Großbuchstaben umwandeln
:* <code>lowercase</code> - Alle Zeichen in Kleinbuchstaben umwandeln

==Beispiele==

===einfache Bildausgabe, 100x100===

Template Quelltext
<source lang="xml">
<spt:imp image="variable"
width="100"
height="100"/>
</source>

===Bild mit padding===

Template Quelltext
<source lang="xml">
<spt:imp image="variable"
width="50"
height="50"
paddding="fit"
background="transparent"
format="jpg"/>
</source>
===Ausgabeverhalten mit verschiedenen <code>padding</code>-Angaben===
[[Bild:spt_imp_padding.jpg]]
<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Link (SPT-Tag)

2008-11-12T09:55:48Z

Schramek: /* Attribute */

{{Überarbeiten}}
==Name==
<spt:link> - Erzeugt Links auf Informationen und bindet Bildmedien ein.

==Syntax==
<source lang="xml">
<spt:link name = "variable"
type = "navlink"
pools = "!{gui.informations}"
hidden = "false"
locale = "de"
size = "50"
value = ""
width = ""
height = ""
showTree = "true"
/>
</source>

==Beschreibung==
Der Tag <code>spt:link</code> löst den veralteten Tag <code>spt:systemlink</code> ab.

Mit dem <code>spt:link-Tag</code> kann ein Link auf andere Informationen des Systems gesetzt werden. Mit diesem Tag lassen sich weiterhin Bildmedien in einen Artikel einbinden.

Dieser Link erzeugt ein <code>readonly</code>-Textfeld, indem der Name des verknüpften [[Article|Artikels]], [[Resource]] oder [[Media|Mediums]] angezeigt wird und einen Button. Bei Klick auf den Button öffnet sich ein Auswahldialog über den der zu verknüpfende Artikel ausgewählt werden kann. Es ist möglich bei Änderungen des Links per JavaScript darauf zu reagieren. Dazu ist mit der JavaScript-Funktion <code>setLinkChangeHandler(fieldname, f)</code> ein Handler zu definieren, der aufgerufen werden soll, wenn sich der Link ändert. Mit <code>fieldname</code> muß der vollständige Name des Feldes angegeben werden (z.B. <code>mylist[0].mysublist[2].mylink</code>). <code>f</code> ist die Javascript-Funktion, die aufgerufen werden soll. Sie wird mit zwei Parametern aufgerufen:

;<code>fieldname</code>
:Variablename des Feldes dessen Link geändert wurde.
;<code>fieldvalue</code>
:ID des Links der gesetzt wurde oder "", wenn der Link gelöst wurde.

<source lang="xml">
<script language="javascript">
function linkChanged(fieldname, fieldvalue) {
alert("link changed: fieldname=" + fieldname + ",fieldvalue=" + fieldvalue);
}
</script>
...
<spt:iterator name="mylist" item="it">
<spt:iterator name="mysublist" item="jt">
...
<spt:link name="mylink" type="link"/>
<script language="javascript">
setLinkChangeHandler("<sp:print name="jt.field"/>.mylink", linkChanged);
</script>
</spt:iterator>
</spt:iterator>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| nein
| 1
|-
| <code>type</code>
| [[Link|Linktyp]]
| Nein
| link
| 1
|-
| <code>pools</code>
| [[Anchor]]-List oder [[ID]]-List
| Nein
| aktueller Informationspool
| 1
|-
| <code>hidden</code>
| [[Condition]]
| Nein
| false
| 1
|-
| <code>locale</code>
| [[Text]]
| Nein
| default
| 1
|-
| <code>size</code>
| [[Number]]
| Nein
| 50
| 1
|-
| <code>value</code>
| [[Text]]
| Nein
| kein
| 1
|-
| <code>width</code>
| [[Number]]
| Nein
| Wert des Mediums
| 1
|-
| <code>height</code>
| [[Number]]
| Nein
| Wert des Mediums
| 1
|-
| <code>showTree</code>
| [[Text]]
| Nein
| true
| 1
|}

;<code>name</code>
:Name der Variablen, unter der der Systemlink in die Datenbank geschrieben wird.

;<code>type</code>
:Typ der Verlinkung
:;systemlink
::bei Änderung des verlinkten Artikels wird der verlinkende Artikel neu publiziert.
:;navlink
::bei Änderung des verlinkenden Artikels wird der verlinkte neu publiziert.
:;resultlink
::wird auf eine Suchabfrage verlinkt wird bei Änderung der Suchabfrage der verlinkende Artikel neu publiziert.
:;link
::es erfolgt keine Aktualisierung in irgendeine Richtung.
:;image
::'image' erzeugt einen Linktype 'systemlink'
::es wird bei Verwendung im Ausgabebereich eines Templates ein <a href=...>-Tag generiert. Die Auswahl, die dem Redakteur zur Verfügung gestellt wird, ist von dieser Einstellung abhängig. Ist 'type=image' gesetzt, kann der Redakteur ein Bildmedium auswählen, mit dem ein <img ...>-Tag generiert wird.

;<code>pools</code>
:Kommaseparierte Liste von [[Anchor|Anchors]] von Artikelpools oder von [[ID|IDs]] von Artikelpools; die Elemente der Pools werden dem Redakteur zur Auswahl angeboten.

;<code>hidden</code>
:Macht das Feld unsichtbar.

;<code>locale</code>
:Diese Attribut bestimmt die Mehrsprachigkeit der Variablen.

;<code>size</code>
:HTML-size Wert des von <code>spt:link</code> erzeugten Eingabefeldes.

;<code>value</code>
:Vorgabefeld für das erzeugte Eingabefeld.

;<code>width</code>
:Bei <code>type="image"</code> kann durch dieses Attribut der 'width'-Wert des generierten <code><img ...></code>-Tags gesetzt werden.

;<code>height</code>
:Bei <code>type="image"</code> kann durch dieses Attribut der 'height'-Wert des generierten <code><img ...></code>-Tags gesetzt werden.

;<code>showTree</code>
:wenn <code>false</code>, werden nur die im Attribut <code>pools</code> übergebenen Einsprungpunkte in der Baumansicht angezeigt (ohne Aufklappmöglichkeit und ohne Kinder)

==Beispiele==

===Verschiedene Links===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:link type="navlink" name="sp_parent" pools="!{information.pool}" size="60"/><br>
<spt:link name="imglink" type="image" size="20" pools="!{media},!{infra}" linklabel="Thumbnail wählen"/>
</sp:io>

<sp:io type="out">
<a href="<sp:print name='sp_parent.navlink.url'/>">
<img src="<sp:print name='imglink.link.url'/>" height="50" width="80"/>
</a>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Number (SPT-Tag)

2008-11-12T09:55:46Z

Schramek: /* Attribute */

==Name==
<spt:number> - Zahleneingabe mit Prüfung auf Gültigkeit

==Syntax==
<source lang="xml">
<spt:number name="variable" size="20"/>
</source>

==Beschreibung==
Mit dem <code>sp:number</code>-Tag können Zahleneingaben im Template auf ihre Gültigkeit überprüft werden. Fliesskommazahlen können wahlweise mit Komma oder Punkt eingegeben werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>size</code>
| [[Number]]
| Nein
| 20
| 1
|-
| <code>align</code>
| [[Text]]
| Nein
| left
| 1
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>size</code>
:'size'-Wert des generierten input-Tags.
;<code>align</code>
:Ausrichtung des Inhalts für das erzeugte Eingabefeld.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Eine kleine Visitenkarte===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<h3>Identity Card</h3>

Name, Vorname:<br>
<sp:text name="personal_name"/><br>

Telefon:<br>
<spt:number name="phone_local" size="5" value="030"/>/
<spt:number name="phone_personal" size="5" align="right"/>
</sp:io>

<sp:io type="out">
<h3>Identity Card</h3>

Name, Vorname:
<sp:print name="personal_name"/><br>
Telefon:
<sp:print name="phone_local"/>/
<sp:print name="phone_personal"/>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Smarteditor (SPT-Tag)

2008-11-12T09:55:18Z

Schramek: /* Attribute */

==Name==
<spt:smarteditor> - Integriert den WYSIWYG-SmartEditor ins CMS

==Syntax==
<source lang="xml">
<spt:smarteditor name="variable" options="language=de;config=standard;"/>
</source>

==Beschreibung==
Mit dem Smarteditor-Tag wird der WYSIWYG-Editor SmartEditor ins CMS eingebunden. Siehe auch [[spt:tinymce]].

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>textlabel</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>rows</code>
| [[Number]]
| Nein
| 5
| 1
|-
| <code>cols</code>
| [[Number]]
| Nein
| 50
| 1
|-
| <code>value</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>options</code>
| [[Text]]
| Nein
| language=de;config=standard;
| 1
|-
| <code>hide</code>
| [[Condition]]
| Nein
| false
| 1
|}

;<code>name</code>
:Bestimmt den Namen des Eingabefeldes.

;<code>textlabel</code>
:Beschriftung des Smarteditorfeldes, oberhalb.

;<code>rows</code>
:Höhe des Eingabefeldes in Zeilen.

;<code>cols</code>
:Breite des Eingabefeldes in Spalten.

;<code>value</code>
:Vorgegebener Inhalt des Feldes.

;<code>options</code>
:Optionen, die beim Aufruf des Smarteditors an diesen übergeben werden.

;<code>hide</code>
:Ist 'hide="false"' gesetzt, so wird ein Textarea generiert, das den vom SmartEditor erzeugten Quellcode aufnimmt. Ist 'hide="true"' gesetzt, so erscheint lediglich die Schaltfläche, über die sich der SmartEditor starten lässt. Standardwert ist 'true'.

==Beispiele==

===Smarteditor aufrufen und den Inhalt ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:smarteditor name="spt_smarteditor" rows="20" cols="100" value="" options="" hide="false"/>
</sp:io>

<sp:io type="out">
<sp:print name="spt_smarteditor"/>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Escapeemail (SPT-Tag)

2008-11-12T09:54:47Z

Schramek: /* Attribute */

==Name==
<spt:escapeemail> ([[deprecated#2.0|deprecated]] ab Version 2.0) - ersetzt Email-Adressen durch Bilder

==Syntax==
<source lang="xml">
<spt:escapeemail name="sp_contact" encoding="html"/>
</source>

==Beschreibung==
'''''Deprecated.''' Dieser Tag ist ab der IES-Version 2 veraltet. Der Tag wurde nach [[spt:email2img]] umbenannt und seine Funktionsweise leicht verändert. <code>spt:escapeemail</code> erwartete <code>name</code>-Attribute in dem die zu ersetzenden Email-Adressen stehen. Der Tag ersetzt die Email-Addressen durch Bilder und schreibt das Ergebnis direkt in die Seite. Der Tag [[spt:email2img]] verwendet das Attribute <code>name</code> als Variablenname in dem der ersetzte Text gespeichert wird. Das Attribute <code>object</code> übernimmt die Aufgabe des Attributes <code>name</code> vom spt:escapeemail. Der ersetzt Text wird somit bei [[spt:email2img]] nicht direkt in die Seite geschrieben, sondern in eine Variablen abgelegt. Alle übrigen Attribute behalten ihre Bedeutung.''

''Um <code>spt:escapeemail</code> auf <code>spt:email2img</code> umzustellen muß der Tag wiefolgt geändert werden.''

''aus''
<spt:escapeemail name="sp_contact"/>
''wird''
<spt:email2img name="imgtext" object="sp_contact"/><sp:print name="imgtext"/>

Ersetzt Email-Adressen durch Bilder. Diesem Tag kann mit dem Attribut <code>name</code> ein Text übergeben werden, der nach Email-Adressen durchsucht wird. Aus dem, in diesem Text enthaltenen Email-Adressen werden Bilder generiert. Die Email-Adressen werden durch die Bilder mit HTML-<img>-Tags ausgetauscht. Zusätzlich werden Email-Adressen, die mit einem mailto://-Link eingegeben wurden mit einem angegebenen Formular verlinkt.

==Hinweis==
Dieser Tag ist Bestandteil des Moduls "Proaktiver Spamschutz" und muss über dieses freigeschaltet werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>object</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>alt</code>
| [[Text]]
| Nein
| geschützte E-Mail-Adresse als Grafik
| 1
|-
| <code>title</code>
| [[Text]]
| Nein
| E-Mail-Adresse - zum Kontaktformular bitte klicken ...
| 1
|-
| <code>color</code>
| [[Text]]
| Nein
| 000000
| 1
|-
| <code>bgcolor</code>
| [[Text]]
| Nein
| FFFFFF
| 1
|-
| <code>font</code>
| [[Text]]
| Nein
| Arial
| 1
|-
| <code>fontsize</code>
| [[Number]]
| Nein
| 12
| 1
|-
| <code>fontweight</code>
| [[Text]]
| Nein
| plain
| 1
|-
| <code>form</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>onclick</code>
| [[Text]]
| Nein
| Ja, wenn <code>popupwidth</code> und <code>popupheight</code> angegeben sind:<br/>
window.name='sp';window.open(
this.href,
'${popupwidth}x${popupheight}',
'width=${popupwidth},height=${popupheight},scrollbars=yes');
return false;
| 1
|-
| <code>popupwidth</code>
| [[Number]]
| Nein
| None
| 1
|-
| <code>popupheight</code>
| [[Number]]
| Nein
| None
| 1
|}

;<code>name</code>
:Variable, in der der ersetzte Text abgelegt wird.

;<code>object</code>
:Objekt das den zu ersetzenden Text enhält.

;<code>alt</code>
:Alternativtext der in die <code>alt</code>-Attribute der <code><img></code>-Tags eingetragen wird.

;<code>title</code>
:Alternativtext der in die <code>title</code>-Attribute der <code><img></code>-Tags eingetragen wird.

;<code>color</code>
:Schriftfarbe, die für den Email-Text in dem generierten Bild verwendet werden soll.

;<code>bgcolor</code>
:Hintergrundfarbe, die für den Email-Text in dem generierten Bild verwendet werden soll.

;<code>font</code>
:Schriftart, die für den Email-Text in dem generierten Bild verwendet werden soll. In der Standardinstallalation enthaltene Fonts sind:
:*Arial
:*Lucida
:*Verdana
:*Futura

;<code>fontsize</code>
:Schriftgrösse, die für den Email-Text in dem generierten Bild verwendet werden soll.

;<code>fontweight</code>
:Schriftstyle, die für den Email-Text in dem generierten Bild verwendet werden soll. Mögliche Werte sind:
:*plain
:*bold
:*italic

;<code>form</code>
:Artikel, der das Kontaktformular bereitstellt.

;<code>onclick</code>
:JavaScript-Funktion nach dem Klick auf eine Email-Adresse ausgeführt werden soll.

;<code>popupwidth</code>
:Breite des Popup-Fensters für das Kontaktformular.

;<code>popupheight</code>
:Breite des Popup-Fensters für das Kontaktformular.

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Email2img (SPT-Tag)

2008-11-12T09:54:45Z

Schramek: /* Attribute */

==Name==
<spt:email2img> (ab Version 2.0) - Ersetzt E-Mail-Adressen durch Bilder<br/>

==Syntax==
<source lang="xml">
<spt:email2img name="imgtext" object="sp_contact"/>
</source>

==Beschreibung==
Ersetzt E-Mail-Adressen durch Bilder. Diesem Tag kann mit dem Attribut <code>object</code> ein Text übergeben werden, der nach E-Mail-Adressen durchsucht wird. Aus dem, in diesem Text enthaltenen E-Mail-Adressen werden Bilder generiert. Die E-Mail-Adressen werden durch die Bilder mit HTML-<code><img></code>-Tags ausgetauscht. Zusätzlich werden E-Mail-Adressen, die mit einem mailto://-Link eingegeben wurden mit einem angegebenen Formular verlinkt.

Der Tag basiert auf Funktionen des Tags <code>[[sp:textimage]]</code>.

==Hinweis==
Dieser Tag ist Bestandteil des Moduls "Proaktiver Spamschutz" und muss über dieses freigeschaltet werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 2
|-
| <code>object</code>
| [[Attribute]]
| Ja
| None
| 2
|-
| <code>alt</code>
| [[Text]]
| Nein
| geschützte E-Mail-Adresse als Grafik
| 2
|-
| <code>title</code>
| [[Text]]
| Nein
| E-Mail-Adresse - zum Kontaktformular bitte klicken ...
| 2
|-
| <code>color</code>
| [[Text]]
| Nein
| 000000
| 2
|-
| <code>linkcolor</code>
| [[Text]]
| Nein
| Wert von <code>color</code>
| 2
|-
| <code>bgcolor</code>
| [[Text]]
| Nein
| FFFFFF
| 2
|-
| <code>font</code>
| [[Text]]
| Nein
| Arial
| 2
|-
| <code>fontsize</code>
| [[Number]]
| Nein
| 12
| 2
|-
| <code>fontweight</code>
| [[Text]]
| Nein
| plain
| 2
|-
| <code>color2</code>
| [[Text]]
| Nein
| Wert von <code>color</code>
| 2
|-
| <code>bgcolor2</code>
| [[Text]]
| Nein
| Wert von <code>bgcolor</code>
| 2
|-
| <code>font2</code>
| [[Text]]
| Nein
| Wert von <code>font</code>
| 2
|-
| <code>fontsize2</code>
| [[Number]]
| Nein
| Wert von <code>fontsize</code>
| 2
|-
| <code>fontweight2</code>
| [[Text]]
| Nein
| Wert von <code>fontweight</code>
| 2
|-
| <code>form</code>
| [[Text]]
| Nein
| None
| 2
|-
| <code>onclick</code>
| [[Text]]
| Nein
| Ja, wenn <code>popupwidth</code> und <code>popupheight</code> angegeben sind:<br/>
window.name='sp';window.open(
this.href,
'${popupwidth}x${popupheight}',
'width=${popupwidth},height=${popupheight},scrollbars=yes');
return false;
| 2
|-
| <code>popupwidth</code>
| [[Number]]
| Nein
| None
| 2
|-
| <code>popupheight</code>
| [[Number]]
| Nein
| None
| 2
|-
| <code>urlparam</code>
| [[Text]]
| Nein
| None
| 2.0.1
|}

;<code>name</code>
:Variable, in der der ersetzte Text abgelegt wird.

;<code>object</code>
:Objekt das den zu ersetzenden Text enhält.

;<code>alt</code>
:Alternativtext der in die <code>alt</code>-Attribute der <code><img></code>-Tags eingetragen wird.

;<code>title</code>
:Alternativtext der in die <code>title</code>-Attribute der <code><img></code>-Tags eingetragen wird.

;<code>color</code>
:Schriftfarbe, die für den E-Mail-Text in dem generierten Bild verwendet werden soll.

;<code>linkcolor</code>
:Schriftfarbe, die für den E-Mail-Text in dem generierten und verlinkten Bild verwendet werden soll.

;<code>bgcolor</code>
:Hintergrundfarbe, die für den E-Mail-Text in dem generierten Bild verwendet werden soll.

;<code>font</code>
:Schriftart, die für den E-Mail-Text in dem generierten Bild verwendet werden soll.
:In der Standardinstallalation enthaltene Fonts sind:
:*Arial
:*Lucida
:*Verdana
:*Futura

;<code>fontsize</code>
:Schriftgrösse, die für den E-Mail-Text in dem generierten Bild verwendet werden soll.

;<code>fontweight</code>
:Schriftstyle, die für den E-Mail-Text in dem generierten Bild verwendet werden soll.
:Mögliche Werte sind:
:*plain
:*bold
:*italic

;<code>form</code>
:Artikel, der das Kontaktformular bereitstellt.

;<code>onclick</code>
:JavaScript-Funktion nach dem Klick auf eine E-Mail-Adresse ausgeführt werden soll.

;<code>popupwidth</code>
:Breite des Popup-Fensters für das Kontaktformular.

;<code>popupheight</code>
:Breite des Popup-Fensters für das Kontaktformular.

;<code>urlparam</code>
:Übergabe weiterer Parameter an das Kontaktformular. Mehrere Parameter werden über <code>&amp;</code> getrennt (Beispiel: "peter=pan&amp;donald=duck").

===weitere Parameter für das generierte Bild der E-Mailadresse im Mailformular:===

;<code>color2</code>
:Schriftfarbe, die für den E-Mail-Text in dem generierten Bild für das Mailformular verwendet werden soll.

;<code>bgcolor2</code>
:Hintergrundfarbe, die für den E-Mail-Text in dem generierten Bild für das Mailformular verwendet werden soll.

;<code>font2</code>
:Schriftart, die für den E-Mail-Text in dem generierten Bild für das Mailformular verwendet werden soll.
:In der Standardinstallalation enthaltene Fonts sind:
:*Arial
:*Lucida
:*Verdana
:*Futura

;<code>fontsize2</code>
:Schriftgrösse, die für den E-Mail-Text in dem generierten Bild für das Mailformular verwendet werden soll.

;<code>fontweight2</code>
:Schriftstyle, die für den E-Mail-Text in dem generierten Bild für das Mailformular verwendet werden soll.
:Mögliche Werte sind:
:*plain
:*bold
:*italic

==Beispiele==

===spt:email2img mit Verknüpfung zum Kontaktformular===

Template Quelltext
<source lang="xml">
<spt:email2img name="tmp_text" object="sp_text" form="${!{information.contact}}"/>
<sp:print name="tmp_text"/>
</source>

Inhalt der Variable sp_text
<source lang="text">
<ul>
<li>
E-Mail-Adresse mit Link:<br/>
<a href="mailto:test@test.de">test@test.de</a>
</li>
<li>
E-Mail-Adresse ohne Link:<br/>
test@test.de
</li>
</ul>
</source>

Inhalt der Variable tmp_text
<source lang="text">
<ul>
<li>
E-Mail-Adresse mit Link:<br/>
<a
href="/kontakt.php?email=9a399467ec17059b6896ff5ec902d75c&emailImageUrl=%2Ftest.php.media%2Ftextimage%2F1443868664.png"
class="sp-mailto"
title="E-Mail-Adresse - zum Kontaktformular bitte klicken ..."
><img src="/test.php.media/textimage/1443868664.png" /></a>
</li>
<li>
E-Mail-Adresse ohne Link:<br/>
<img src="/test.php.media/textimage/1443868664.png"
alt="geschützte E-Mail-Adresse als Grafik"
style="vertical-align:bottom" />
</li>
</ul>
</source>

Beispielcode eines Kontaktformulars, welches über den Anker (hier: "information.contact") angegeben wurde
<source lang="text">

<?php
$key = "238745991275901023489641"; // steht in der IES-Serverkonfiguration
$mode = MCRYPT_3DES;

function str_decrypt($encrypted_string) {
GLOBAL $key, $mode;

$td = mcrypt_module_open($mode, '', 'ecb', '');
$iv = mcrypt_create_iv (mcrypt_enc_get_iv_size($td), MCRYPT_RAND);
mcrypt_generic_init($td, $key, $iv);
$encrypted_data = hex2bin($encrypted_string);

// decrypt
$decrypted_string = mcrypt_ecb ($mode, $key, $encrypted_data, MCRYPT_DECRYPT, $iv);

mcrypt_generic_deinit($td);
mcrypt_module_close($td);

return trim($decrypted_string);
}

function hex2bin($hexdata) {
$bindata = "";
for ($i = 0; $i < strlen( $hexdata ); $i += 2)
eval ('$bindata .= "\x' . substr( $hexdata, $i, 2 ) . '";');

return $bindata;
}

function is_email($lom_emailstrg) {
return ereg("^[_a-zA-Z0-9-]+(.[_a-zA-Z0-9-]+)*@([a-zA-Z0-9-]{2,})+(.[_a-zA-Z0-9-]+)*.([a-zA-Z0-9-]{2,4})$", $lom_emailstrg);
}
?>

<?php
$CRLF = "\n";
$mail_address = isset($_REQUEST['email']) ? str_decrypt($_REQUEST['email']) : "default-email@some-domain.com";
if (!is_email($mail_address)) die("<p><strong>Ungültiger Aufruf !</strong></p><br>Die Empfänger-Adresse ist ungültig.");

// Darstellung des Formulars bzw. Auswertung des Requests und Versand einer E-Mail
...
?>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Date (SPT-Tag)

2008-11-12T09:54:19Z

Schramek: /* Attribute */

==Name==
<spt:date> - Datumseingabe mit Prüfung auf Gültigkeit

==Syntax==
<source lang="xml">
<spt:date name="variable"/>
</source>

==Beschreibung==
Mit dem <code>sp:date</code>-Tag können Datumseingaben im Template auf ihre Gültigkeit überprüft werden. Gültige Datumseingaben haben das Format <code>tt.mm.jjjj</code>, wobei führende Nullen im Tages- oder Monatswert weggelassen werden können.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>size</code>
| [[Number]]
| Nein
| 20
| 1
|-
| <code>value</code>
| [[String]]
| Nein
| [[System|system.now]]
| 1
|}
==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
| <code>value</code>
| [[String]]
| Nein
| ${[[System|system.now]]}
| 1
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>size</code>
| [[Number]]
| Nein
| 20
| 1
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
;<code>value</code>
:Vorgabetext für das erzeugte Eingabefeld. Ohne bzw. mit einem leeren <code>value</code>-Attribut wird in der Eingabe das aktuelle Datum angezeigt. Soll das Eingabefeld leer bleiben, muss als <code>value</code> ein Leerzeichen (" ") angegeben werden.
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>size</code>
:'size'-Wert des generierten input-Tags.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Datum ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
Datum (TT.MM.JJJJ) <spt:date name="date_test" value=" "/>
</sp:io>

<sp:io type="out">
<sp:print name="date_test" dateformat="dd.MM.yyyy"/>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Counter (SPT-Tag)

2008-11-12T09:54:08Z

Schramek: /* Attribute */

==Name==
<spt:counter> - Zählt Zugriffe auf publizierte Informationen

==Syntax==
<source lang="xml">
<spt:counter name="variable" mode="read" varname="variable"/>
</source>

==Beschreibung==
Mit dem sp:counter-Tag kann ermittelt werden wie oft eine Seite aufgerufen wurde.

<code><spt:counter name="hit"/></code> erzeugt in der Ausgabeseite im Standard-Fall JavaScipt-Code in Form von

<source lang="html4strict">
<script
type="text/javascript"
src="/ies/counter?SYS_CNTR_id=101020100000001157-1015%3Ahits;SYS_CNTR_mode=;SYS_CNTR_varname=sp_counter">
</script>
</source>

Ab Version 2.0.3 generiert spt:counter alternativ auch PHP-Code, wenn das Attribute <code>language</code> auf den Wert <code>php</code> gesetzt wird. In diesem Fall wird PHP-Code generiert. <code><spt:counter name="hit" language="php"/></code> erzeugt PHP-Code in Form von

<source lang="php">
<?php
function spt_counter_getCounter() {
$protocol = ($_SERVER["HTTPS"] == "on") ? "https" : "http";
$hostname = $_SERVER["HTTP_HOST"];
$url = $protocol . "://" . $hostname . "/ies/counter?SYS_CNTR_id=101020100000001157-1015%3Ahits;SYS_CNTR_mode=;SYS_CNTR_javascript=false";
return file_get_contents($url);
}
$sp_counter = spt_counter_getCounter();
?>
</source>

Bei jedem Aufruf der Seite wird die angegebene Counter-Variable um eins hochgezählt. Der counter-Tag wird ausschließlich im Ausgabebereich eines Templates genutzt. Der Counter-Wert kann im Eingabebereich eines Templates mit [[sp:print]] oder [[sp:text]] ausgegeben werden. Zu beachten ist hierbei, dass der Counter als [[Content-Type|Content-Typ]] "counter" gespeichert wird. Counter werden intern im [[CounterInformation]]-Objekt verwaltet.

Um spt:counter Nutzern zu können müssen zwei Bedingungen erfüllt sein:
# Der Counter-Manager muß aktiviert sein. Dieser kann über die Administrations-Oberläche des IES im Bereich 'Dienste' gestartet werden.
# Die generierte Counter-Url im JavaScript muss per HTTP-Request erreichbar ist. Dazu muß der Publikationsbereich in dem die Seite generiert wurde als [[Webapplication|Webapplikation]] im IES aktiviert sein. Zusätzlich muss der Webserver einen [[JkMount]] von <code>/ies/counter</code> auf den IES gesetzt haben.

'''Hinweis:''' Der Counter-Manager nimmt die Counter-Requests entgegen und erhöht den Counter-Wert zunächst nur im RAM-Speicher, ohne das Feld des Artikels in der Datenbank zu speichern. Dadurch wird verhindert das bei jedem Request Artikel gespeichert werden und es zu Performanz-Problemen kommt. In regelmäßigen Abständen wird der Wert im RAM-Speicher am Artikel gespeichert. Zu beachten ist noch das diese Änderung des Artikels nicht zu einer Neugenerierung der Seite führt. Der Wert des Counters sollte deswegen für generierte Seiten immer mit <sp:counter> und JavaScript und nicht mit <sp:print name="hit.counter"/> ausgegeben werden. Bei Live-Seiten ist <sp:print name="hit.counter"/> möglich, da falls vorhanden der Wert im RAM-Speicher ausgelesen wird. (ab Version 2.0.3)

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>mode</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>varName</code> ([[deprecated]] ab Version 2.0.3)
| [[Text]]
| Nein.
| sp_counter
| 1
|-
| <code>varname</code>
| [[Text]]
| Nein
| sp_counter
| 2.0.3
|-
| <code>language</code>
| [[Text]]
| Nein
| javascript
| 2.0.3
|}

;<code>name</code>
:Name der Variablen in der der Zugriffswert gespeichert wird.

;<code>mode</code>
:Der Zähler kann in verschiedenen Modi betrieben werden. Gültige Modi sind:
:;read
::Counter wird nicht hoch gezählt, sondern es wird nur der aktuelle Zählerstand als Variable ausgegeben.
:;write
::Counter wird hochgezählt, aber es wird keine Variable gesetzt.
:;''keine Angabe''
::Counter wird hochgezählt und der aktuelle Zählerstand wird als Variable ausgegeben.

;<code>varName</code>
:der Name der Variablen, in die der aktuelle Counterwert ausgegeben wird [default=sp_counter].
: '''''Deprecated (ab Version 2.0.3)''' Das Attribut ist veraltet, und sollte nicht mehr verwendet werden. Es sollte statt dessen <code>varname</code> verwendet werden.

;<code>varname</code>
:der Name der Variablen, in die der aktuelle Counterwert ausgegeben wird [default=sp_counter].

;<code>language</code>
:Gibt an in welcher Programmiersprache der Code generiert werden soll. Mögliche Werte sind
:;<code>javascript</code>
::Es wird JavaScript-Code generiert
:;<code>php</code>
::Es wird PHP-Code generiert

==Beispiele==

===Mit spt:counter eine Variable setzen===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<sp:text name="meincounter" type="counter"/>
</sp:io>

<sp:io type="out">
<spt:counter name="meincounter" mode="read"/>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

UserPoolHandler

2008-11-12T09:53:43Z

Schramek: /* Parameter */

==Name==
<code>USRP</code> UserPoolHandler - Handler für die User-Pool Verwaltung

==Klasse==
<code>com.sitepark.ies.jsp.handler.UserPoolHandler</code>

==Beschreibung==
Mit diesem Handler werden Pools angelegt, geändert und gelöscht. Weiter können über diesen Handler Elemente und Pools verschoben und kopiert werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_USRP_action</code>
| Ja
| None
| 1
|-
| <code>SYS_USRP_id</code>
| Ja für <code>update</code> und <code>delete</code>
| None
| 1
|-
| <code>SYS_USRP_entries</code>
| Ja für <code>copy</code>, <code>move</code>
| Node
| 1
|-
|-
| <code>SYS_USRP_target</code>
| Ja für <code>create</code>, <code>copy</code>, <code>move</code>
| Node
| 1
|-
| <code>SYS_USRP_name</code>
| Nein
| None
| 1
|-
| <code>SYS_USRP_comment</code>
| Nein
| None
| 1
|-
| <code>SYS_USRP_anchor</code>
| Nein
| None
| 1
|}

;<code>SYS_USRP_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt einen neuen User-Pool.
:;<code>update</code>
::Ändert einen User-Pool. Alle mitgesendeten Feld werden aktualisiert. Ist das Feld leer wird es vom User-Pool gelöscht. Nicht mitgesendete Felder bleiben unverändert.
:;<code>delete</code>
::Löscht einen Rollen-Pool.
:;<code>copy</code>
::Kopiert eine Liste von User-Pools. Die ID-Liste wird in <code>SYS_USRP_entries</code> angegeben. Die kopierten User-Pools werden in dem Pool angelegt, der mit <code>SYS_USRP_target</code> angegeben wurde.
:;<code>pool-copy</code>
::<code>SYS_USRP_entries</code> angegeben. Die angegebene Pools werden mit allen Unterpools in dem Pool angelegt, der mit <code>SYS_USRP_target</code> angegeben wurde.
:;<code>element-copy</code>
::<code>SYS_USRP_entries</code> angegeben. Die angegebenen Pools werden mit allen Elementen in dem Pool angelegt, der mit <code>SYS_USRP_target</code> angegeben wurde. Wenn <code>SYS_USRP_copyEntries</code> angegeben wurde, werden nur Elemente der Poolstruktur kopiert, die auch in der Liste angegeben sind.
:;<code>deep-copy</code>
::<code>SYS_USRP_entries</code> angegeben. Der angegebenen Pools werden mit allen Unterpools und allen Elementen in dem Pool angelegt, der mit <code>SYS_USRP_target</code> angegeben wurde.
:;<code>move</code>
::Verschiebt eine Liste von User-Pools. Die ID-Liste wird in <code>SYS_USRP_entries</code> angegeben. Die User-Pools werden in den Pool verschoben, der mit <code>SYS_USRP_target</code> angegeben wurde.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_USRP_id</code>
:ID des User-Pools, auf den sich die Aktion bezieht.

;<code>SYS_USRP_entries</code>
:Liste von User-Pool-ID's die verschoben/kopiert werden sollen.

;<code>SYS_USRP_target</code>
:Die ID des Pools indem ein User-Pool angelegt/verschoben werden soll.

;<code>SYS_USRP_name</code>
:Name für den User-Pool.

;<code>SYS_USRP_comment</code>
:Bemerkung für den User-Pool.

;<code>SYS_USRP_anchor</code>
:Anchor des User-Pools.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#SYS-F013|SYS-F013]]
*[[Errorcode#USRP-E010|USRP-E010]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

WorklistHandler

2008-11-12T09:53:41Z

Schramek: /* Parameter */

==Name==
<code>WOLI</code> WorklistHandler - Steuert die Aktionen auf Einträge in der Worklist

==Klasse==
<code>com.sitepark.ies.jsp.handler.WorklistHandler</code>

==Beschreibung==
Dieser Handler steuert die Aktionen, die sich auf einzelne Einträge der Worklist beziehen. Die Listeneinträge eines Nutzers können verändert, oder an den Ersteller der Nachricht zurückgesendet werden. Neue Einträge können erstellt und an einen oder mehrere Nutzer, Nutzer-Pools oder Rollen versendet werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_WOLI_action</code>
| Ja
| None
| 1
|-
| <code>SYS_WOLI_id</code>
| Ja für <code>update</code>, <code>reply</code> und <code>delete</code>
| None
| 1
|-
| <code>SYS_WOLI_elementID</code>
| Ja
| None
| 1
|-
| <code>SYS_WOLI_subject</code>
| Nein
| None
| 1
|-
| <code>SYS_WOLI_message</code>
| Nein
| None
| 1
|-
| <code>SYS_WOLI_recipientID</code>
| Nein
| None
| 1
|-
| <code>SYS_WOLI_recipientPoolID</code>
| Nein
| None
| 1
|-
| <code>SYS_WOLI_roleID</code>
| Nein
| None
| 1
|-
| <code>SYS_WOLI_type</code>
| Nein
| None
| 1
|-
| <code>SYS_WOLI_priority</code>
| Nein
| None
| 1
|-
| <code>SYS_WOLI_status</code>
| Nein
| None
| 1
|}

;<code>SYS_WOLI_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt einen neuem Worklist-Eintrag.
:;<code>update</code>
::Ändert ein Worklist-Eintrag.
:;<code>delete</code>
::Löscht einen Worklist-Eintrag.
:;<code>reply</code>
::Weist einen Worklist-Eintrag zurück.

;<code>SYS_WOLI_id</code>
:ID der Worklist.

;<code>SYS_WOLI_elementID</code>
:Element, auf den sich der Worklist-Eintrag bezieht.

;<code>SYS_WOLI_subject</code>
:Überschrift zu dem Worklist-Eintrag.

;<code>SYS_WOLI_message</code>
:Nachricht zu dem Worklist-Eintrag.

;<code>SYS_WOLI_recipientID</code>
:Ein bestimmter Empfänger des Worklist-Eintrags. Es ist auch möglich eine komma-separierte Liste von NutzerIDs anzugeben, die alle den Worklisteintrag sehen sollen.

;<code>SYS_WOLI_recipientPoolID</code>
:Eine oder mehrere Nutzergruppen, an die der Worklisteintrag geschickt werden soll.

;<code>SYS_WOLI_roleID</code>
:Eine oder mehrere komma-separiete Rollen-ID´s, die diesen Worklist-Eintrag bekommen sollen.

;<code>SYS_WOLI_type</code>
:Typ des Worklist-Eintrags.

;<code>SYS_WOLI_priority</code>
:Prorität des Worklist-Eintrags.

;<code>SYS_WOLI_status</code>
:Status des Worklist-Eintrags.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#WOLI-E010|WOLI-E010]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

UserHandler

2008-11-12T09:53:35Z

Schramek: /* Parameter */

==Name==
<code>USRE</code> Handlername - Verwaltet Nutzer

==Klasse==
<code>com.sitepark.ies.jsp.handler.UserHandler</code>

==Beschreibung==
Über diesen Handler können die Nutzer des Systems verwaltet werden. Es können Nutzer erzeugt, geändert, gelöscht, kopiert, verschoben und Verknüpfungen erstellt werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_USRE_action</code>
| Ja
| None
| 1
|-
| <code>SYS_USRE_id</code>
| Ja für <code>update</code> und <code>delete</code>
| None
| 1
|-
| <code>SYS_USRE_entries</code>
| Ja für <code>copy</code>, <code>move</code>, <code>create-link</code>
| None
| 1
|-
| <code>SYS_USRE_target</code>
| Ja für <code>create</code>, <code>copy</code>, <code>move</code>, <code>create-link</code>
| None
| 1
|-
| <code>SYS_USRE_comment</code>
| Nein
| None
| 1
|-
| <code>SYS_USRE_anchor</code>
| Nein
| None
| 1
|-
| <code>SYS_USRE_login</code>
| Ja
| None
| 1
|-
| <code>SYS_USRE_password</code>
| Ja
| None
| 1
|-
| <code>SYS_USRE_rpassword</code>
| Ja
| None
| 1
|-
| <code>SYS_USRE_lastName</code>
| Ja
| None
| 1
|-
| <code>SYS_USRE_firstName</code>
| Nein
| None
| 1
|-
| <code>SYS_USRE_type</code>
| Ja
| None
| 1
|-
| <code>SYS_USRE_link</code>
| Nein
| None
| 1
|-
| <code>SYS_USRE_locale</code>
| Ja
| None
| 1
|}

;<code>SYS_USRE_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt einen neue Nuzter.
:;<code>update</code>
::Ändert eines Nutzers. Alle mitgesendeten Feld werden aktualisiert. Ist das Feld leer wird es gelöscht. Nicht mitgesendete Felder bleiben unverändert.
:;<code>delete</code>
::Löscht einen Nutzer.
:;<code>copy</code>
::Kopiert eine Liste von Nutzern. Die ID-Liste wird in SYS_USRE_entries angegeben. Die kopierten Nutzer werden in dem Pool angelegt, der mit SYS_USRE_target angegeben wurde.
:;<code>move</code>
::Verschiebt eine Liste von Nutzern. Die ID-Liste wird in SYS_USRE_entries angegeben. Die Nutzer werden in den Pool verschoben, der mit SYS_USRE_target angegeben wurde.
:;<code>create-link</code>
::Verknüpft eine Liste von Nutzern. Die ID-Liste wird in SYS_USRE_entries angegeben. Die neuen Verknüpfungen werden in den Pool angelegt, der mit SYS_USRE_target angegeben wurde.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_USRE_id</code>
:ID des Nutzers, auf den sich die Aktion bezieht.

;<code>SYS_USRE_entries</code>
:Liste von Nutzer-ID's die verschoben/kopiert/verlinkt werden sollen.

;<code>SYS_USRE_target</code>
:Die ID des Pools indem eine Nutzer/ein Link angelegt/verschoben werden soll.

;<code>SYS_USRE_comment</code>
:Bermerkung für die Nutzer.

;<code>SYS_USRE_anchor</code>
:Anchor des Nutzers.

;<code>SYS_USRE_login</code>
:Nutzer-Login.

;<code>SYS_USRE_password</code>
:Passwort des Nutzers.

;<code>SYS_USRE_rpassword</code>
:Zweite Eingabe des Passworts.

;<code>SYS_USRE_lastName</code>
:Nachname des Nutzers.

;<code>SYS_USRE_firstName</code>
:Vorname des Nutzers.

;<code>SYS_USRE_type</code>
:Type des Nutzers (Zugriffslevel):
:*<code>system.contants.SYSTEM_ADMINISTRATOR</code>
:*<code>system.contants.ADMINISTRATOR</code>
:*<code>system.contants.EDITOR</code>
:*<code>system.contants.GUEST</code>
:*<code>system.contants.ANONYMOUS</code>

;<code>SYS_USRE_link</code>
:Pools, in die ein Link erstellt werden soll.

;<code>SYS_USRE_locale</code>
:Spracheinstellung des Nutzers.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#SYS-F013|SYS-F013]]
*[[Errorcode#USRE-E011|USRE-E011]]
*[[Errorcode#USRE-E012|USRE-E012]]
*[[Errorcode#USRE-W011|USRE-W011]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

TemplateHandler

2008-11-12T09:52:58Z

Schramek: /* Parameter */

==Name==
<code>TPLE</code> TemplateHandler - Verwaltet Templates

==Klasse==
<code>com.sitepark.ies.jsp.handler.TemplateHandler</code>

==Beschreibung==
Über diesen Handler können die Templates des Systems verwaltet werden. Es können Templates erzeugt, geändert, gelöscht, kopiert, verschoben und Verknüpfungen erstellt werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_TPLE_action</code>
| Ja
| None
| 1
|-
| <code>SYS_TPLE_id</code>
| Ja für <code>update</code> und <code>delete</code>
| None
| 1
|-
| <code>SYS_TPLE_entries</code>
| Ja für <code>copy</code>, <code>move</code>, <code>create-link</code>
| None
| 1
|-
| <code>SYS_TPLE_target</code>
| Ja für <code>create</code>, <code>copy</code>, <code>move</code>, <code>create-link</code>
| None
| 1
|-
| <code>SYS_TPLE_name</code>
| Ja für <code>create</code>
| None
| 1
|-
| <code>SYS_TPLE_comment</code>
| Nein
| None
| 1
|-
| <code>SYS_TPLE_anchor</code>
| Nein
| None
| 1
|-
| <code>SYS_TPLE_source</code>
| Nein
| None
| 1
|-
| <code>SYS_TPLE_suffix</code>
| Nein
| None
| 1
|-
| <code>SYS_TPLE_type</code>
| Nein
| <code>template</code>
| 1
|-
| <code>SYS_TPLE_version</code>
| Nein
| <code>0</code>
| 1
|}

;<code>SYS_TPLE_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt ein neues Template.
:;<code>update</code>
::Ändert ein Template. Alle mitgesendeten Feld werden aktualisiert. Ist das Feld leer, wird es gelöscht. Nicht mitgesendete Felder bleiben unverändert.
:;<code>delete</code>
::Löscht ein Template.
:;<code>copy</code>
::Kopiert eine Liste von Templates. Die ID-Liste wird in <code>SYS_TPLE_entries</code> angegeben. Die kopierten Templates werden in dem Pool angelegt, der mit <code>SYS_TPLE_target</code> angegeben wurde.
:;<code>move</code>
::Verschiebt eine Liste von Templates. Die ID-Liste wird in <code>SYS_TPLE_entries</code> angegeben. Die Templates werden in den Pool verschoben, der mit <code>SYS_TPLE_target</code> angegeben wurde.
:;<code>create-link</code>
::Verknüpft eine Liste von Templates. Die ID-Liste wird in <code>SYS_TPLE_entries</code> angegeben. Die neuen Verknüpfungen werden in den Pool angelegt, der mit <code>SYS_TPLE_target</code> angegeben wurde.
:;<code>reposit</code>
::Mit dieser Aktion wird von einem Template eine ältere Version aus der Datenbank geholt und als aktuelles Element gesetzt.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_TPLE_id</code>
:ID des Templates, auf den sich die Aktion bezieht.

;<code>SYS_TPLE_entries</code>
:Liste von Template-ID's die verschoben/kopiert/verlinkt werden sollen.

;<code>SYS_TPLE_target</code>
:Die ID des Pools indem ein Template/Link angelegt/verschoben werden soll.

;<code>SYS_TPLE_name</code>
:Der Name des Templates.

;<code>SYS_TPLE_comment</code>
:Bemerkung für das Template.

;<code>SYS_TPLE_anchor</code>
:Anchor des Templates.

;<code>SYS_TPLE_source</code>
:Der Template-Source.

;<code>SYS_TPLE_suffix</code>
:Die Endung mit der Artikel generiert werden sollen, falls keine Angaben durch den Redakteur erfolgten.

;<code>SYS_TPLE_type</code>
:Der Typ des Templates:
:;<code>system.constants.TEMPLATE</code>
::normales Template.
:;<code>system.constants.TAG_TEMPLATE</code>
::Tag-Template.

;<code>SYS_TPLE_version</code>
:Ein bestimmter Versionsstand der angezeigt und bearbeitet werden soll. Die aktuelle Version hat stets den Stand 0. Versionen werden durch Zeitstempel repräsentiert (in Millisekunden ab dem 1.1.1970 1:00). Diese können über <code>myInformationID.history</code> ausgelesen werden. Der hier angegebene Wert wird mit dem Kommando <code>reposit</code> ausgewertet.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#SYS-F013|SYS-F013]]
*[[Errorcode#TPLE-E010|TPLE-E010]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

TemplatePoolHandler

2008-11-12T09:52:55Z

Schramek: /* Parameter */

==Name==
<code>TPLP</code> TemplatePoolHandler — Verwaltet Template-Pools
==Klasse==
<code> com.sitepark.ies.jsp.handler.TemplatePoolHandler</code>

==Beschreibung==
Über diesen Handler können die Template-Pools des Systems verwaltet werden. Es können Template-Pools erzeugt, geändert, gelöscht, kopiert und verschoben werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_TPLP_action</code>
| Ja
| None
| 1
|-
| <code>SYS_TPLP_id</code>
| Ja für <code>update</code>, <code>delete</code>
| None
| 1
|-
| <code>SYS_TPLP_entries</code>
| ja für <code>copy</code>, <code>move</code>
| None
| 1
|-
| <code>SYS_TPLP_target</code>
| Ja für <code>create</code>, <code>copy</code>, <code>move</code>
| None
| 1
|-
| <code>SYS_TPLP_name</code>
| Nein
| None
| 1
|-
| <code>SYS_TPLP_comment</code>
| Nein
| None
| 1
|-
| <code>SYS_TPLP_anchor</code>
| Nein
| None
| 1
|}

;<code>SYS_TPLP_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt einen neuen Template-Pool.
:;<code>update</code>
::Ändert einen Template-Pool. Alle mitgesendeten Feld werden aktualisiert. Ist das Feld leer, wird es vom Template-Pool gelöscht. Nicht mitgesendete Felder bleiben unverändert.
:;<code>delete</code>
::Löscht einen Template-Pool.
:;<code>copy</code>
::Kopiert eine Liste von Template-Pools. Die ID-Liste wird in <code>SYS_TPLP_entries</code> angegeben. Die kopierten Template-Pools werden in dem Pool angelegt, der mit <code>SYS_TPLP_target</code> angegeben wurde.
:;<code>pool-copy</code>
::<code>SYS_TPLP_entries</code> angegeben. Die angegebene Pools werden mit allen Unterpools in dem Pool angelegt, der mit <code>SYS_TPLP_target</code> angegeben wurde.
:;<code>element-copy</code>
::<code>SYS_TPLP_entries</code> angegeben. Die angegebenen Pools werden mit allen Elementen in dem Pool angelegt, der mit <code>SYS_TPLP_target</code> angegeben wurde. Wenn <code>SYS_TPLP_copyEntries</code> angegeben wurde, werden nur Elemente der Poolstruktur kopiert, die auch in der Liste angegeben sind.
:;<code>deep-copy</code>
::<code>SYS_TPLP_entries</code> angegeben. Der angegebenen Pools werden mit allen Unterpools und allen Elementen in dem Pool angelegt, der mit <code>SYS_TPLP_target</code> angegeben wurde.
:;<code>move</code>
::Verschiebt eine Liste von Template-Pools. Die ID-Liste wird in <code>SYS_TPLP_entries</code> angegeben. Die Role-Pools werden in den Pool verschoben, der mit <code>SYS_TPLP_target</code> angegeben wurde.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_TPLP_id</code>
:ID des Template-Pools, auf den sich die Aktion bezieht.

;<code>SYS_TPLP_entries</code>
:Liste von Template-Pool-IDs die verschoben/kopiert werden sollen.

;<code>SYS_TPLP_target</code>
:Die ID des Pools indem ein Template-Pool angelegt/verschoben werden soll.

;<code>SYS_TPLP_name</code>
:Name für des Template-Pools.

;<code>SYS_TPLP_comment</code>
:Bemerkung für den Template-Pool.

;<code>SYS_TPLP_anchor</code>
:Anchor des Template-Pools.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#SYS-F013|SYS-F013]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

RolePoolHandler

2008-11-12T09:52:22Z

Schramek: /* Parameter */

==Name==
<code>ROLP</code> RolePoolHandler - Verwaltet Rollen-Pools

==Klasse==
<code>com.sitepark.ies.jsp.handler.RolePoolHandler</code>

==Beschreibung==
Über diesen Handler können die Rollen-Pools des Systems verwaltet werden. Es können Rollen-Pools erzeugt, geändert, gelöscht, kopiert und verschoben werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_ROLP_action</code>
| Ja
| None
| 1
|-
| <code>SYS_ROLP_id</code>
| Ja für <code>update</code>, <code>delete</code>
| None
| 1
|-
| <code>SYS_ROLE_entries</code>
| ja für <code>copy</code>, <code>move</code>
| None
| 1
|-
| <code>SYS_ROLE_target</code>
| Ja für <code>create</code>, <code>copy</code>, <code>move</code>
| None
| 1
|-
| <code>SYS_ROLP_name</code>
| Nein
| None
| 1
|-
| <code>SYS_ROLP_comment</code>
| Nein
| None
| 1
|-
| <code>SYS_ROLP_anchor</code>
| Nein
| None
| 1
|}

;<code>SYS_ROLP_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt einen neuen Rollen-Pool.
:;<code>update</code>
::Ändert einen Rollen-Pool. Alle mitgesendeten Feld werden aktualisiert. Ist das Feld leer, wird es vom Rollen-Pool gelöscht. Nicht mitgesendete Felder bleiben unverändert.
:;<code>delete</code>
::Löscht einen Rollen-Pool.
:;<code>copy</code>
::Kopiert eine Liste von Rollen-Pools. Die ID-Liste wird in <code>SYS_ROLP_entries</code> angegeben. Die kopierten Rollen-Pools werden in dem Pool angelegt, der mit <code>SYS_ROLP_target</code> angegeben wurde.
:;<code>pool-copy</code>
::<code>SYS_ROLP_entries</code> angegeben. Die angegebene Pools werden mit allen Unterpools in dem Pool angelegt, der mit <code>SYS_ROLP_target</code> angegeben wurde.
:;<code>element-copy</code>
::<code>SYS_ROLP_entries</code> angegeben. Die angegebenen Pools werden mit allen Elementen in dem Pool angelegt, der mit <code>SYS_ROLP_target</code> angegeben wurde. Wenn <code>SYS_ROLP_copyEntries</code> angegeben wurde, werden nur Elemente der Poolstruktur kopiert, die auch in der Liste angegeben sind.
:;<code>deep-copy</code>
::<code>SYS_ROLP_entries</code> angegeben. Der angegebenen Pools werden mit allen Unterpools und allen Elementen in dem Pool angelegt, der mit <code>SYS_ROLP_target</code> angegeben wurde.
:;<code>move</code>
::Verschiebt eine Liste von Rollen-Pools. Die ID-Liste wird in <code>SYS_ROLP_entries</code> angegeben. Die Role-Pools werden in den Pool verschoben, der mit <code>SYS_ROLP_target</code> angegeben wurde.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_ROLP_id</code>
:ID des Rollen-Pools, auf den sich die Aktion bezieht.

;<code>SYS_ROLP_entries</code>
:Liste von Rollen-Pool-IDs die verschoben/kopiert werden sollen.

;<code>SYS_ROLP_target</code>
:Die ID des Pools indem ein Rollen-Pool angelegt/verschoben werden soll.

;<code>SYS_ROLP_name</code>
:Name für des Rollen-Pools.

;<code>SYS_ROLP_comment</code>
:Bemerkung für den Rollen-Pool.

;<code>SYS_ROLP_anchor</code>
:Anchor des Rollen-Pools.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#SYS-F013|SYS-F013]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

RoleHandler

2008-11-12T09:52:14Z

Schramek: /* Parameter */

==Name==
<code>ROLE</code> RoleHandler - verwaltet Rollen

==Klasse==
<code>com.sitepark.ies.jsp.handler.RoleHandler</code>

==Beschreibung==
Über diesen Handler können die Rollen des Systems verwaltet werden. Es können Rollen erzeugt, geändert, gelöscht, kopiert, verschoben und Verknüpfungen erstellt werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_ROLE_action</code>
| Ja
| None
| 1
|-
| <code>SYS_ROLE_id</code>
| Ja für update und delete
| None
| 1
|-
| <code>SYS_ROLE_entries</code>
| Ja für <code>copy</code>, <code>move</code>, <code>create-link</code>
| None
| 1
|-
| <code>SYS_ROLE_target</code>
| Ja für <code>create</code>, <code>copy</code>, <code>move</code>, <code>create-link</code>
| None
| 1
|-
| <code>SYS_ROLE_name</code>
| Ja für <code>create</code>
| None
| 1
|-
| <code>SYS_ROLE_comment</code>
| Nein
| None
| 1
|-
| <code>SYS_ROLE_anchor</code>
| Nein
| None
| 1
|-
| <code>SYS_ROLE_newElement</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_readElement</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_modifyElement</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_deleteElement</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_duplicateElement</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_maxElement</code>
| Nein
| <code>-1</code>
| 1
|-
| <code>SYS_ROLE_newPool</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_deletePool</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_maxPool</code>
| Nein
| <code>-1</code>
| 1
|-
| <code>SYS_ROLE_editorLevel</code>
| Nein
| <code>-1</code>
| 1
|-
| <code>SYS_ROLE_read</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_modify</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_duplicate</code>
| Nein
| <code>false</code>
| 1
|-
| <code>SYS_ROLE_publisher</code>
| Nein
| None
| 1
|}

;<code>SYS_ROLE_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt eine neue Rolle.
:;<code>update</code>
::Ändert eine Rolle. Alle mitgesendeten Feld werden aktualisiert. Ist das Feld leer wird es gelöscht. Nicht mitgesendete Felder bleiben unverändert.
:;<code>delete</code>
::Löcht eine Rolle.
:;<code>copy</code>
::Kopiert eine Liste von Rollen. Die ID-Liste wird in <code>SYS_ROLE_entries</code> angegeben. Die kopierten Rollen werden in dem Pool angelegt, der mit <code>SYS_ROLE_target</code> angegeben wurde.
:;<code>move</code>
::Verschiebt eine Liste von Rollen. Die ID-Liste wird in <code>SYS_ROLE_entries</code> angegeben. Die Artikel werden in den Pool verschoben, der mit <code>SYS_ROLE_target</code> angegeben wurde.
:;<code>create-link</code>
::Verknüpft eine Liste von Rollen. Die ID-Liste wird in <code>SYS_ROLE_entries</code> angegeben. Die neuen Verknüpfungen werden in den Pool angelegt, der mit <code>SYS_ROLE_target</code> angegeben wurde.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_ROLE_id</code>
:ID der Rolle, auf den sich die Aktion bezieht.

;<code>SYS_ROLE_entries</code>
:Liste von Role-ID's die verschoben/kopiert/verlinkt werden sollen.

;<code>SYS_ROLE_target</code>
:Die ID des Pools indem eine Rolle/ein Link angelegt/verschoben werden soll.

;<code>SYS_ROLE_name</code>
:Name der Rolle.

;<code>SYS_ROLE_comment</code>
:Bermerkung für die Rolle.

;<code>SYS_ROLE_anchor</code>
:Anchor der Rolle.

;<code>SYS_ROLE_newElement</code>
:Bestimmt, ob neue Elemente in diesem Pool angelegt werden dürfen. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_readElement</code>
:Bestimmt, ob Elemente in diesem Pool gelesen werden dürfen. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_modifyElement</code>
:Bestimmt, ob Elemente in diesem Pool geändert werden dürfen. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_deleteElement</code>
:Bestimmt, ob Elemente in diesem Pool gelöscht werden dürfen. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_duplicateElement</code>
:Bestimmt, ob die Elemente in diesem Pool dupliziert werden dürfen. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_maxElement</code>
:Legt die maximale Anzahl an Elementen in einem Pool für diese Rolle fest.

;<code>SYS_ROLE_newPool</code>
:Bestimmt, ob neue Pools in diesem Pool angelegt werden dürfen. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_deletePool</code>
:Bestimmt, ob Pools in diesem Pool gelöscht werden dürfen. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_maxPool</code>
:Legt die maximale Anzahl an Pools in einem Pool für diese Rolle fest.

;<code>SYS_ROLE_editorLevel</code>
:Der Redakteurslevel für diesen Pool. Dieser kann innerhalb der Templates ausgewertet werden.

;<code>SYS_ROLE_read</code>
:Bestimmt, ob der aktuelle Pool gelesen werden darf. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_modify</code>
:Bestimmt, ob der aktuelle Pool geändert werden darf. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_duplicate</code>
:Bestimmt, ob der aktuelle Pool dupliziert werden darf. (<code>true</code> / <code>false</code>).

;<code>SYS_ROLE_publisher</code>
:Liste von PublisherID's in der Publiziert werden darf..

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#SYS-F013|SYS-F013]]
*[[Errorcode#ROLE-E010|ROLE-E010]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

PublisherHandler (deprecated)

2008-11-12T09:52:09Z

Schramek: /* Parameter */

==Name==
<code>PUBH</code> PublisherHandler - Handler zur Verwaltung der Publikationsbereiche

==Klasse==
<code>com.sitepark.ies.jsp.handler.PublisherHandler</code>

==Beschreibung==
'''''Deprecated.''' Dieser Hander wird ab Version 2.0 nicht mehr unterstützt, da dies in dem Bereich der mandantenübergreifende Administration fällt.''

Mit diesem Handler können Publisher verwaltet werden. Ein Publisher ist ein konfiguriertes Ausgabe-Modul. Der File-Publisher steuert die Ausgabe der Dateien in Verzeichnisse (z.B eines Webservers). Für jeden Publikationsbereich wird hier ein Publisher angemeldet. Über den PublisherHandler wird der <code><publisher></code>-Bereich der Konfiguration bearbeitet.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_PUBH_action</code>
| Ja
| None
| 1
|-
| <code>SYS_PUBH_id</code>
| Ja für <code>update</code> und <code>delete</code>
| None
| 1
|-
| <code>SYS_PUBH_type</code>
| Nein
| file
| 1
|-
| <code>SYS_PUBH_name</code>
| Ja
| None
| 1
|-
| <code>SYS_PUBH_anchor</code>
| Ja
| None
| 1
|-
| <code>SYS_PUBH_documentRoot</code>
| Ja für Typ <code>file</code>
| None
| 1
|-
| <code>SYS_PUBH_directory</code>
| Nein
| None
| 1
|-
| <code>SYS_PUBH_url</code>
| Ja für Typ <code>file</code>
| None
| 1
|-
| <code>SYS_PUBH_aliases</code>
| Nein
| None
| 1
|-
| <code>SYS_PUBH_encoding</code>
| Nein
| <code>UTF-8</code>
| 1
|-
| <code>SYS_PUBH_locale</code>
| Nein
| <code>default</code>
| 1
|-
| <code>SYS_PUBH_schemeType</code>
| Nein
| <code>prefix</code>
| 1
|-
| <code>SYS_PUBH_schemeValue</code>
| Nein
| None
| 1
|-
| <code>SYS_PUBH_headerdata</code>
| Nein
| None
| 1
|-
| <code>SYS_PUBH_database</code>
| Nein
| None
| 1
|-
| <code>SYS_PUBH_personalizationDatasource</code>
| Nein
| None
| 1
|-
| <code>SYS_PUBH_metadata</code>
| Nein
| None
| 1
|-
| <code>SYS_PUBH_clients</code>
| Nein
| None
| 1
|}

;<code>SYS_PUBH_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt einen neuen Publisher.
:;<code>update</code>
::Ändert einen Publisher.
:;<code>delete</code>
::Noch nicht verfügbar.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_PUBH_id</code>
:ID des Publishers.

;<code>SYS_PUBH_type</code>
:Typ des Publishers.
:;<code>file</code>
::Datei-Publisher.
:;<code>http</code>
::HTTP-Publisher.
:;<code>database</code>
::Datenbank-Publisher.
:;<code>mail</code>
::E-Mail-Publisher.

;<code>SYS_PUBH_anchor</code>
:Ein Anchor für den Publikationsbereich.

;<code>SYS_PUBH_name</code>
:Der Name des Publishers.

;<code>SYS_PUBH_documentRoot</code>
:Das Verzeichnis, in das der File-Publisher schreiben soll. Der Ordner muss bereits vorhanden und beschreibbar sein.

;<code>SYS_PUBH_directory</code>
:Optionale Angabe eines Unterverzeichnisses einer Domain. Diese Option wird i.d.R. nur für Portale benötigt. Der Server schreibt dann vor jede absolute URL "<code>/myfolder</code>" den hier konfigurierten Wert vor: "<code>/thisFolder/myFolder</code>".

;<code>SYS_PUBH_url</code>
:Die URL, über die auf diesen File-Publisher zugegriffen werden kann.

;<code>SYS_PUBH_aliases</code>
:Aliases der konfigurierten URL. Diese Werte können benötigt werden, falls Imp eingesetzt wird und mehrere URLs für diese Domain existieren (z.B. <code>http</code> und <code>https</code>).

;<code>SYS_PUBH_encoding</code>
:Das Enconding der Dateien, die in dem Publisher generiert werden. Optimalerweise sollten Templates nach "HTML 4" einen META-Tag generieren, der diesen Wert enhält:
:<code><meta http-equiv="content-type" content="text/html; charset=<sp:print name="system.publisher.encoding"/>"></code>
:Durch das Encoding ist es möglich in jeder beliebigen Sprache zu publizieren.

;<code>SYS_PUBH_locale</code>
:Bei mehrsprachigen Eingaben innerhalb des Templates kann hierüber gesteuert werden, welcher Inhalt in diesem Publisher verwendet werden soll.

;<code>SYS_PUBH_schemeType</code>
:Die Verwendung eines Schemes ermöglicht es mehrsprachige Websites in einer Ordnerstruktur zu verwalten. Mit dem Scheme-Typ kann angegeben werden, ob eine konfigurierbare Zeichenkette vor oder hinter dem Dateinamen angefügt wird. Webserver wie der Apache können anhand der Spracheinstellung des Browsers bei zwei Dateien (<code>index.html.en</code> und <code>index.html.de</code>) automatisch die richtige ausliefern.

;<code>SYS_PUBH_schemeValue</code>
:Die Zeichenkette, die bei Verwendung von Schemes eingefügt wird.

;<code>SYS_PUBH_headerdata</code>
:HTTP-Header-Angaben für den HTTP-Publisher.

;<code>SYS_PUBH_database</code>
:Name der Datenbank für den HTTP-Publisher, in die publiziert werden soll. Die Datenbank muss im Server entsprechend konfiguriert werden.

;<code>SYS_PUBH_personalizationDatasource</code>
:Zieldatenbank für die Personalisierungsdaten. Die Datenbank muss im Server entsprechend konfiguriert werden.

;<code>SYS_PUBH_metadata</code>
:Allgemeine Metadaten für die Publisher. Hierüber können beliebige, zusätzliche Name-Value-Paare gespeichert werden.

;<code>SYS_PUBH_clients</code>
:Die Mandanten, die generell Zugriff auf diesen Publisher bekommen sollen.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#PUBH-E010|PUBH-E010]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

PoolPermissionHandler

2008-11-12T09:52:05Z

Schramek: /* Parameter */

==Name==
<code>PERM</code> PoolPermissionHandler - Handler für die Verwaltung der Zugriffsrechte von Nutzern auf Pools

==Klasse==
<code>com.sitepark.ies.jsp.handler.PoolPermissionHandler</code>

==Beschreibung==
Dieser Handler steuert die Zuweisung von Zugriffsrechten einzelner Benutzer auf Pools mit Hilfe von Rollen.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_PERM_action</code>
| Ja
| None
| 1
|-
| <code>SYS_PERM_user</code>
| Ja
| None
| 1
|-
| <code>SYS_PERM_pool</code>
| Ja
| None
| 1
|-
| <code>SYS_PERM_role</code>
| Ja
| None
| 1
|-
| <code>SYS_PERM_recursion</code>
| Ja
| None
| 1
|-
| <code>SYS_PERM_hide</code>
| Nein
| None
| 1
|}

;<code>SYS_PERM_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>set</code>
::Setzt die Zugriffsrechte für den Nutzer auf genau diese Rolle. Alle älteren Angaben werden überschrieben.
:;<code>add</code>
::Fügt dem Nutzer die ausgewählte Rolle hinzu. Ein Nutzer hat die Summe aller Rechte seiner Rollen.
:;<code>delete</code>
::Löscht die angegebene Rollenzuweisung.

;<code>SYS_PERM_user</code>
:Die ID des Pools, in dem die Rechte eines Nutzers durch Rollenzuweisung angezeigt bzw. verändert werden sollen.

;<code>SYS_PERM_role</code>
:Rolle, die vergeben, verändert bzw. genommen werden soll.

;<code>SYS_PERM_recursion</code>
:Steuert, ob die Rolle automatisch rekursiv auf alle bestehenden und auch alle neu hinzukommenden Pools angewandt werden soll. (0 = keine Rekursion / 1 = Rekuriv für alle aktuellen Pools / 2 = Rekursiv auch für alle neuen Pools).

;<code>SYS_PERM_hide</code>
:Steuert, ob die Rolle sichtbar ist. Rechte durch sichtbare Rollen erlauben die Auswahl in der Artikelverwaltung. Versteckte Rechte erlauben das Lesen von Elementen in Auswahlfenstern (Systemlink-Popup auf Pools, in denen nicht gearbeitet werden darf). (<code>true</code> / <code>false</code>).

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#SYS-F013|SYS-F013]]
*[[Errorcode#PERM-E010|PERM-E010]]
*[[Errorcode#PERM-E011|PERM-E011]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

InformationHandler

2008-11-12T09:51:07Z

Schramek: /* Parameter */

==Name==
<code>INFE</code> InformationHandler - Verwaltet Artikel

==Klasse==
<code>com.sitepark.ies.jsp.handler.InformationHandler</code>

==Beschreibung==
Über diesen Handler können die Artikel des Systems verwaltet werden. Es können Artikel erzeugt, geändert, gelöscht, kopiert, verschoben und Verknüpfungen erstellt werden. Über diesen Handler kann eine Vorschau eines Artikels mit den übertragenen Daten und einen angegebenen Publikationsbereich erzeugt werden. Der Artikel wird ebenfalls für das Auslesen von alten Artikel-Versionen verwendet.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_INFE_action</code>
| Ja
| None
| 1
|-
| <code>SYS_INFE_id</code>
| Ja für <code>update</code>, <code>delete</code>, <code>reposit</code>
| None
| 1
|-
| <code>SYS_INFE_entries</code>
| Ja für <code>copy</code>, <code>move</code>, <code>create-link</code>
| None
| 1
|-
| <code>SYS_INFE_target</code>
| Ja für <code>create</code>, <code>copy</code>, <code>move</code>, <code>create-link</code>
| None
| 1
|-
| <code>SYS_INFE_name</code>
| Ja für <code>create</code>
| None
| 1
|-
| <code>SYS_INFE_anchor</code>
| Nein
| None
| 1
|-
| <code>SYS_INFE_comment</code>
| Nein
| None
| 1
|-
| <code>SYS_INFE_file</code>
| Ja für Artikel vom Typ <code>article</code>
| None
| 1
|-
| <code>SYS_INFE_articleType</code>
| Nein
| None
| 1
|-
| <code>SYS_INFE_publicationArea</code>
| Nein
| None
| 1
|-
| <code>SYS_INFE_publicationChecked</code>
| Nein
| None
| 1
|-
| <code>SYS_INFE_publicationTemplate</code>
| Ja, für jeden <code>SYS_INFE_publicationArea</code> Parameter
| None
| 1
|-
| <code>SYS_INFE_publicationPersonalization</code>
| Nein
| None
| 1
|-
| <code>SYS_INFE_previewArea</code>
| Nein
| None
| 1
|-
| <code>SYS_INFE_version</code>
| Ja für reposit
| None
| 1
|-
| <code>SYS_INFE_listID</code>
| Nein
| None
| 1
|-
| <code>SYS_INFE_listAction</code>
| Nein
| None
| 1
|}

;<code>SYS_INFE_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt einen neuen Artikel.
:;<code>update</code>
::Ändert einen Artikel. Alle mitgesendeten Felder werden aktualisiert. Ist das Feld leer, wird es vom Artikel gelöscht. Nicht mitgesendete Felder bleiben unverändert.
:;<code>delete</code>
::Löscht einen Artikel.
:;<code>copy</code>
::Kopiert eine Liste von Artikeln. Die ID-Liste wird in <code>SYS_INFE_entries</code> angegeben. Die kopierten Artikel werden in dem Pool angelegt, der mit <code>SYS_INFE_target</code> angegeben wurde.
:;<code>move</code>
::Verschiebt eine Liste von Artikeln. Die ID-Liste wird in <code>SYS_INFE_entries</code> angegeben. Die Artikel werden in den Pool verschoben, der mit <code>SYS_INFE_target</code> angegeben wurde.
:;<code>create-link</code>
::Verknüpft eine Liste von Artikeln. Die ID-Liste wird in <code>SYS_INFE_entries</code> angegeben. Die neuen Verknüpfungen werden in dem Pool angelegt, der mit <code>SYS_INFE_target</code> angegeben wurde. Verknüpfungen können nur für [[Resource|Resourcen]] erstellt werden.
:;<code>preview</code>
::Mit dieser Aktion wird aus den mitgesendeten Artikeldaten und dem angegebenen Artikel (falls vorhanden) ein temporärer Artikel erzeugt, mit dem eine temporäre Datei in dem angegebenen Publikationsbereich generiert wird.
:;<code>edit</code>
::Mit dieser Aktion wird ein Artikel nur innerhalb der Session verändert, ohne die Änderungen zu speichern. Hiermit kann ein Artikel erst solange bearbeitet werden, bis alle gewünschten Daten eingetragen wurden. Anschließend kann mit einem <code>update</code> bzw. <code>create</code> der Artikel gespeichert werden.
:;<code>reposit</code>
::Mit dieser Aktion wird von einem Artikel eine ältere Version aus der Datenbank geholt und als aktuelles Element gesetzt.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_INFE_id</code>
:ID des Artikels, auf den sich die Aktion bezieht.

;<code>SYS_INFE_entries</code>
:Liste von Artikel-IDs, die verschoben/kopiert/verlinkt werden sollen.

;<code>SYS_INFE_target</code>
:Die ID des Pools, indem ein Artikel/Link angelegt/verschoben werden soll.

;<code>SYS_INFE_name</code>
:Der Name des Artikels.

;<code>SYS_INFE_comment</code>
:Bemerkung für den Artikel.

;<code>SYS_INFE_anchor</code>
:Anchor des Artikels.

;<code>SYS_INFE_file</code>
:Der Name der Datei, die mit dem Artikel erzeugt werden soll. (Nur für Artikel vom Typ <code>article</code>).

;<code>SYS_INFE_type</code>
:Zur Verfügung stehende Aktionen:
:;<code>acticle</code>
::Ein Artikel, der generiert werden kann. z.B. als Datei.
:;<code>resource</code>
::Ein Artikel, der nur in der Datenbank liegt und nicht generiert werden kann.
:;<code>media</code>
::Ein Medium, z.B. Bilder, PDF, ...

;<code>SYS_INFE_publicationArea</code>
:Über diesen Parameter wird die Publikation eines Artikels gesteuert. Dieser Parameter enthält die ID des Publikationsbereichs für den die weiteren Parameter <code>SYS_INFE_publicationChecked</code>, <code>SYS_INFE_publicationTemplate</code> und <code>SYS_INFE_publicationPersonalization</code> gelten.

:Alle zur Verfügung stehenden Publikations-Objekte eines Mandanten können mit <code>system.client.publisher</code> erreicht werden.

;<code>SYS_INFE_publicationChecked</code>
:Soll ein Artikel für einen mit <code>SYS_INFE_publicationArea</code> angegebenen Publikationsbereich publiziert werden, so muß mit diesem Parameter ebenfalls die ID des Publikationsbereichs mitgesendet werden. Soll ein Artikel für einen mit <code>SYS_INFE_publicationArea</code> angegebenen Publikationsbereich depubliziert werden, so wird für diesen Publikationsbereich kein <code>SYS_INFE_publicationChecked</code>-Parameter mitgesendet.

;<code>SYS_INFE_publicationTemplate</code>
:Für diesen Parameter ist die Reihenfolge der Parameter die mitgesendet werden entscheidend. Für jeden mit <code>SYS_INFE_publicationArea</code> angegebenen Publikationsbereich muß es einen Parameter <code>SYS_INFE_publicationTemplate</code> geben, der die ID des Templates enthält, mit dem der Artikel für diesen Publikationsbereich publiziert werden soll. Dabei erfolgt die Zuordnung zwischen <code>SYS_INFE_publicationArea</code> und <code>SYS_INFE_publicationTemplate</code> über die Reihenfolge, in der die Parameter gesendet werden. Der erste <code>SYS_INFE_publicationArea</code>-Parameter verwendet das Template, das mit dem ersten <code>SYS_INFE_publicationTemplate</code>-Parameter mitgesendet wurde. Die Anzahl beider Parameter muß gleich sein.

;<code>SYS_INFE_publicationPersonalization</code>
:Sollen für die Publikationsbereiche Personalisierungsdaten gespeichert werden, so wird dieser Parameter mitgesendet. Wird dieser Parameter mitgesendet, muß ähnlich wie bei <code>SYS_INFE_publicationTemplate</code>, die Anzahl der Parameter mit der Anzahl der <code>SYS_INFE_publicationArea</code>-Parameter gleich sein. Die Zuordnung erfolgt über die Reihenfolge der gesendeten Parameter.

;<code>SYS_INFE_previewArea</code>
:Der Publikationsbereich, für den eine Vorschau erzeugt werden soll.

;<code>SYS_INFE_version</code>
:Ein bestimmter Versions-Stand der angezeigt und bearbeitet werden soll. Die aktuelle Version hat stets den Stand 0. Versionen werden durch Zeitstempel repräsentiert (in Millisekunden ab dem 1.1.1970 1:00). Diese können über <code>myInformationID.history</code> ausgelesen werden. Der hier angegebene Wert wird mit dem Kommando <code>reposit</code> ausgewertet.

;<code>SYS_INFE_listAction</code>
:Dieser Parameter löst eine Aktion auf eine Liste des Artikels aus. Dadurch kann eine Liste modifiziert werden. Folgende Aktionen sind möglich:
:;clearList
::Löscht eine ganze Liste, die mit über <code>SYS_INFE_listID</code> angegebenen wurde.
:;swapList
::Vertauscht alle Listen-Elemente der mit <code>SYS_INFE_listID</code> angegebenen Liste. Das erste Element wird zum letzten, das zweite zum vorletzten, ..., das letzte Element wird zum ersten Element.
:;addItem
::Fügt ein leeres Listen-Element an das Ende der mit <code>SYS_INFE_listID</code> angegebenen Liste. Da <code>spt:iterator</code> auch ein leeres Listen-Element anzeigt, wenn die Liste leer ist, werden zwei leere Listen-Elemente bei einer leeren Liste erzeugt.
:;moveItemDown
::Verschiebt das mit <code>SYS_INFE_listID</code> angegebene Listen-Element um eine Position nach unten.
:;moveItemUp
::Verschiebt das mit <code>SYS_INFE_listID</code> angegebene Listen-Element um eine Position nach oben.
:;removeItem
:: Löscht das mit <code>SYS_INFE_listID</code> angegebene Listen-Element.
:;insertItem
::Fügt das mit <code>SYS_INFE_listID</code> angegebene Listen-Element hinzu. Da <code>spt:iterator</code> auch ein leeres Listen-Element anzeigt, wenn die Liste leer ist, werden zwei leere Listen-Elemente bei einer leeren Liste erzeugt.

;<code>SYS_INFE_listId</code>
:Die ID der Liste, oder des Listen-Elements, auf das sich die Listen-Action <code>SYS_INFE_listAction</code> bezieht.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#INFE-E010|INFE-E010]]

<noinclude>
[[Category:Handler]]
</noinclude>

InformationPoolHandler

2008-11-12T09:51:02Z

Schramek: /* Parameter */

==Name==
<code>INFP</code> InformationPoolHandler - Verwaltet Artikel-Pools

==Klasse==
<code>com.sitepark.ies.jsp.handler.InformationPoolHandler</code>

==Beschreibung==
Über diesen Handler können die Artikel-Pools des Systems verwaltet werden. Es können Artikel-Pools erzeugt, geändert, gelöscht, kopiert, und verschoben werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_INFP_action</code>
| Ja
| None
| 1
|-
| <code>SYS_INFP_id</code>
| Ja für <code>update</code>, <code>delete</code>
| None
| 1
|-
| <code>SYS_INFP_entries</code>
| Ja für <code>copy</code>, <code>move</code>
| None
| 1
|-
| <code>SYS_INFP_target</code>
| Ja für <code>create</code>, <code>copy</code>, <code>move</code>
| None
| 1
|-
| <code>SYS_INFP_name</code>
| Ja für <code>create</code>
| None
| 1
|-
| <code>SYS_INFP_comment</code>
| Nein
| None
| 1
|-
| <code>SYS_INFP_anchor</code>
| Nein
| None
| 1
|-
| <code>SYS_INFP_dir</code>
| Nein
| None
| 1
|-
| <code>SYS_INFP_resetLinks</code>
| Nein (nur für <code>element-copy</code> & <code>deep-copy</code>)
| true
| 1
|-
| <code>SYS_INFP_copyEntries</code>
| Nein (nur für <code>element-copy</code> & <code>deep-copy</code>)
| None
| 1
|-
| <code>SYS_INFP_oldLinkID</code>
| Ja, für <code>substitute-link</code>
| None
| 1
|-
| <code>SYS_INFP_newLinkID</code>
| Ja, für <code>substitute-link</code>
| None
| 1
|}

;<code>SYS_INFP_action</code>
:Zur Verfügung stehende Aktionen:
:;<code>create</code>
::Erzeugt einen neuen Artikel-Pool.
:;<code>update</code>
::Ändert einen Artikel-Pool. Alle mitgesendeten Felder werden aktualisiert. Ist das Feld leer, wird es vom Artikel-Pool gelöscht. Nicht mitgesendete Felder bleiben unverändert.
:;<code>delete</code>
::Löscht einen Artikel-Pool.
:;<code>copy</code>
::Kopiert eine Liste von Artikel-Pools. Die ID-Liste wird in <code>SYS_INFP_entries</code> angegeben. Die kopierten Artikel-Pools werden in dem Pool angelegt, der mit <code>SYS_INFP_target</code> angegeben wurde.
:;<code>pool-copy</code>
::<code>SYS_INFP_entries</code> angegeben. Die angegebene Pools werden mit allen Unterpools in dem Pool angelegt, der mit <code>SYS_INFP_target</code> angegeben wurde.
:;<code>element-copy</code>
::<code>SYS_INFP_entries</code> angegeben. Die angegebenen Pools werden mit allen Elementen in dem Pool angelegt, der mit <code>SYS_INFP_target</code> angegeben wurde. Wenn <code>SYS_INFP_copyEntries</code> angegeben wurde, werden nur Elemente der Poolstruktur kopiert, die auch in der Liste angegeben sind.
:;<code>deep-copy</code>
::<code>SYS_INFP_entries</code> angegeben. Die angegebenen Pools werden mit allen Unterpools und allen Elementen in dem Pool angelegt, der mit <code>SYS_INFP_target</code> angegeben wurde.
:;<code>move</code>
::Verschiebt eine Liste von Artikel-Pools. Die ID-Liste wird in <code>SYS_INFP_entries</code> angegeben. Die Artikel-Pools werden in den Pool verschoben, der mit <code>SYS_INFP_target</code> angegeben wurde.
:;<code>edit</code>
::Mit dieser Aktion wird ein Artikel-Pool nur innerhalb der Session verändert, ohne die Änderungen zu speichern. Hiermit kann ein Artikel-Pool erst solange bearbeitet werden, bis alle gewünschten Daten eingetragen wurden. Anschließend kann mit einem <code>update</code> bzw. <code>create</code> der Artikel-Pool gespeichert werden.
:;<code>substitute-link</code>
::Kommando, um im System einen Link gegen einen anderen zu ersetzen. Ersetzt wird der Link <code>SYS_INFP_oldLinkID</code> gegen <code>SYS_INFP_newLinkID</code>. Artikel, in denen der Link ausgetauscht wird, werden entweder über <code>SYS_INFP_entries</code> angegeben, oder es werden alle Artikel unterhalb des Pools <code>SYS_INFP_id</code> aktualisiert.
:;<code>none</code>
::Es wird keine Aktion ausgeführt.

;<code>SYS_INFP_id</code>
:ID des Artikel-Pools, auf den sich die Aktion bezieht.

;<code>SYS_INFE_entries</code>
:Liste von Artikel-Pool-ID's die verschoben/kopiert werden sollen.

;<code>SYS_INFP_target</code>
:Die ID des Pools, indem ein Artikel-Pool angelegt/verschoben werden soll.

;<code>SYS_INFP_name</code>
:Der Name des Artikel-Pools.

;<code>SYS_INFP_comment</code>
:Bemerkung für den Artikel-Pool.

;<code>SYS_INFP_anchor</code>
:Anchor des Artikel-Pools.

;<code>SYS_INFP_dir</code>
:Der Pfad des Verzeichnisses, für die generierten Artikel dieses Pools.

;<code>SYS_INFP_resetLinks</code>
:Ersetzt bei Kopieraktionen die Verlinkungen innerhalb der Struktur auf die Elemente der neue erstellten Struktur.

;<code>SYS_INFP_copyEntries</code>
:Elemente, die bei einer Kopieraktion exklusiv kopiert werden sollen.

;<code>SYS_INFP_oldLinkID</code>
:Die Link-ID, die bei <code>substitute-link</code> gegen <code>SYS_INFP_newLinkID</code> ersetzt werde soll.

;<code>SYS_INFP_newLinkID</code>
:Die Link-ID, die bei <code>substitute-link</code> die ID <code>SYS_INFP_oldLinkID</code> ersetzet.

==Fehlercodes==
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#INFP-E010|INFP-E010]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

LoginHandler

2008-11-12T09:50:56Z

Schramek: /* Parameter */

==Name==
<code>LGIN</code> LoginHandler - Anmelden eines Nutzers an den Server

==Klasse==
<code>com.sitepark.ies.jsp.handler.LoginHandler</code>

==Beschreibung==
Über diesen Handler wird ein Nutzer am Server angemeldet. Wird mit der Action "<code>checkLogin</code>" geprüft, ob ein Login bereits existiert, so wird in der Attribute-Map des Handlers der Wert "<code>loginIsAvailable</code>" gesetzt. Dieser kann im Template über "<code>system.handler.first.attributes.loginIsAvailable</code>" abgefragt werden.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_LGIN_action</code>
| Nein, nicht beim Login (default)
| None
| 1
|-
| <code>SYS_LGIN_login</code>
| Ja, wenn <code>SYS_LGIN_session</code> nicht angegeben ist, oder bei <code>SYS_LGIN_action=checkLogin</code>
| None
| 1
|-
| <code>SYS_LGIN_password</code>
| Ja, bei <code>SYS_LGIN_action=login</code> wenn <code>SYS_LGIN_session</code> nicht angegeben ist
| None
| 1
|-
| <code>SYS_LGIN_client</code>
| Ja, bei <code>SYS_LGIN_action=login</code> wenn <code>SYS_LGIN_session</code> nicht angegeben ist
| None
| 1
|-
| <code>SYS_LGIN_session</code>
| Ja, bei <code>SYS_LGIN_action=login</code> wenn <code>SYS_LGIN_login</code>, <code>SYS_LGIN_password</code> und <code>SYS_LGIN_client</code> nicht angegeben sind.
| None
| 1
|-
| <code>SYS_LGIN_maintenance</code>
| Nein
| None
| 1
|-
| <code>SYS_gui</code>
| Ja bei <code>SYS_LGIN_action=login</code>
| gui1
| 1
|}

;<code>SYS_LGIN_action</code>
:Steuert die Aktion des Handlers. Folgende Werte sind zulässig:
:;<code>login</code>
::Mit den übergebenen Parametern soll eine Session erzeugt werden.
:;<code>checkLogin</code>
::Es soll geprüft werden, ob das Login bereits vergeben ist.

;<code>SYS_LGIN_login</code>
:Login des Nutzers.

;<code>SYS_LGIN_password</code>
:Passwort des Nutzers.

;<code>SYS_LGIN_client</code>
:ID des Mandanten oder Anchor des Mandanten, in dem der Nutzer liegt.

;<code>SYS_LGIN_session</code>
:Die Session ID einer im IES aktiven Session. Dies ist sinnvoll, wenn der Nutzer über einen anderen Mechanismus (z.B. Personalisierung) am Server angemeldet wurde und diese Session weiter verwendet werden soll.

;<code>SYS_maintenance</code>
:Dieser Parameter muß mit dem Wert <code>true</code>, mitgesendet werden, wenn sich der Server im Wartungs-Modus befindet. Ansonsten ist ein Login nicht möglich.

;<code>SYS_gui</code>
:Angabe des zu verwendenden GUIs. Diese Angabe wird nicht direkt von diesem Handler ausgewertet, ein Login ist jedoch ohne GUI niemals möglich. Angegeben wird hier die GUI-ID.

==Fehlercodes==
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]
*[[Errorcode#LGIN-E011|LGIN-E011]]
*[[Errorcode#LGIN-E012|LGIN-E012]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

GenerateHandler

2008-11-12T09:50:23Z

Schramek: /* Parameter */

==Name==
<code>GENE</code> GenerateHandler - Setzen von Generierungsevents

==Klasse==
<code>com.sitepark.ies.jsp.handler.GenerateHandler</code>

==Beschreibung==
Mit diesem Handler können Artikel neu generiert werden. Je nachdem welche Werte dem Handler übergeben werden, wird ein Artikel, werden alle Artikel eines Pools, alle Artikel mit einem bestimmten Template oder alle Artikel eines Publikationsbereichs herausgeschrieben. Die Parameter können kombiniert werden. Der Artikel wird nur für die Publikationsbereiche neu generiert, in denen er publiziert ist.

==Parameter==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Required || Default || ab IES Version
|-
| <code>SYS_GENE_action</code>
| Ja
| None
| 1
|-
| <code>SYS_GENE_informationId</code>
| Nur einer der fünf Werte muss übertragen werden.
| None
| 1
|-
| <code>SYS_GENE_informationPoolId</code>
| Nur einer der fünf Werte muss übertragen werden.
| None
| 1
|-
| <code>SYS_GENE_tempateId</code>
| Nur einer der fünf Werte muss übertragen werden.
| None
| 1
|-
| <code>SYS_GENE_publisherId</code>
| Nur einer der fünf Werte muss übertragen werden.
| None
| 1
|-
| <code>SYS_GENE_clientId</code>
| Nur einer der fünf Werte muss übertragen werden.
| None
| 1
|}

;<code>SYS_GENE_informationId</code>
:
:;<code>generate</code>
::Generiert die, über die Parameter angegebenen Artikel.
:;<code>none</code>
::Der Handler wird nicht ausgeführt.

;<code>SYS_GENE_informationId</code>
:Ein oder mehrere Artikel ID's, die neu generiert werden sollen.

;<code>SYS_GENE_informationPoolId</code>
:Ein oder mehrere Pool ID's, um die Artikel zu generieren, die in diesem Pool liegen.

;<code>SYS_GENE_tempateId</code>
:Ein oder mehrere Template ID's um die Artikel zu generieren, die mit den Templates publiziert sind.

;<code>SYS_GENE_publisherId</code>
:Ein oder mehrere Publisher ID's um die Artikel zu generieren, die in den angegebenen Publikationsbereichen publiziert sind.

;<code>SYS_GENE_clientId</code>
:Ein oder mehrere Mandanten ID's um die Artikel zu generieren, die in den angegebenen Mandanten publiziert sind.

==Fehlercodes==
*[[Errorcode#SYS-F001|SYS-F001]]
*[[Errorcode#SYS-F011|SYS-F011]]
*[[Errorcode#SYS-F012|SYS-F012]]

<noinclude>
[[Category:Handler]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Mathematische Funktionen

2008-11-12T09:49:53Z

Schramek: /* Funktionen */

==Beschreibung==
Mathematische Funktionen zur Berechnung von Zahlenwerten.

Als mathematische Konstanten stehen [[Constants|system.constants.PI]] und [[Constants|system.constanst.E]] zur Verfügung.

==Funktionen==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>floor([[Number]] x)</code>
| [[Number]]
| Die Funktion rundet ab. Sie ähnelt der ceil()-Funktion. Im Gegensatz zu dieser wird hier aber die nächst niedrigere Ganzzahl zurückgegeben. Ganze Zahlen werden nicht verändert.
| 2.0.3
|-
| <code>ceil([[Number]] x)</code>
| [[Number]]
| Die Funktion dient zum Aufrunden und liefert die nächst höhere Ganzzahl, wenn die Zahl nicht schon eine ganze Zahl ist.
| 2.0.3
|-
| <code>round([[Number]] x)</code>
| [[Number]]
| Liefert die kaufmännisch gerundete Ganzzahl von x zurück. Wenn x eine Ganzzahl ist, bleibt sie unverändert.
| 2.0.3
|-
| <code>min([[Number]] a, [[Number]] b)</code>
| [[Number]]
| Die min()-Funktionen liefern den kleineren von zwei Werten als Rückgabewert.
| 2.0.3
|-
| <code>max([[Number]] a, [[Number]] b)</code>
| [[Number]]
| Die max()-Funktionen liefern den grösseren von zwei Werten als Rückgabewert.
| 2.0.3
|-
| <code>abs([[Number]] x)</code>
| [[Number]]
| Die abs()-Funktionen liefern den Betrag von x (mathematische Betragsfunktion: y = ǀxǀ). Sollte ein negativer Wert als Argument übergeben werden, so wird dieser in einen positiven Wert umgewandelt.
| 2.0.3
|-
| <code>cos([[Number]] x)</code>
| [[Number]]
| Liefert den Kosinus von x.
| 2.0.3
|-
| <code>acos([[Number]] x)</code>
| [[Number]]
| Liefert den Arcus-Kosinus von x, wobei 0 <= x <= π.
| 2.0.3
|-
| <code>cosh([[Number]] x)</code>
| [[Number]]
| Liefert den Kosinus-Hyperbolicus von x.
| 2.0.3
|-
| <code>sin([[Number]] x)</code>
| [[Number]]
| Liefert den Sinus von x.
| 2.0.3
|-
| <code>asin([[Number]] x)</code>
| [[Number]]
| Liefert den Arcus-Sinus von x, wobei -π/2 <= x <= π/2.
| 2.0.3
|-
| <code>sinh([[Number]] x)</code>
| [[Number]]
| Liefert den Sinus-Hyperbolicus von x.
| 2.0.3
|-
| <code>tan([[Number]] x)</code>
| [[Number]]
| Liefert den Tangens von x.
| 2.0.3
|-
| <code>atan([[Number]] x)</code>
| [[Number]]
| Liefert den Arcus-Tangens von x, wobei -π/2 <= x <= π/2.
| 2.0.3
|-
| <code>tanh([[Number]] x)</code>
| [[Number]]
| Liefert den Tangens-Hyperbolicus von x.
| 2.0.3
|-
| <code>exp([[Number]] x)</code>
| [[Number]]
| Liefert den Exponentialwert von x zur Basis e (der Eulerschen Zahl e = 2.71828…), also e<sup>x</sup>
| 2.0.3
|-
| <code>expm1([[Number]] x)</code>
| [[Number]]
| Liefert den Exponentialwert von x zur Basis e minus 1, also e<sup>x</sup> – 1. Berechungen nahe Null können mit expm1(x) + 1 präziser ausgedrückt werden als mit exp(x).
| 2.0.3
|-
| <code>signum([[Number]] x)</code>
| [[Number]]
| Die signum()-Funktionen liefern 0 zurück, wenn x gleich 0 ist. Ist x grösser als 0 wird 1 zurückgeliefert. Ist x kleiner als 0 wird -1 zurückgeliefert.
| 2.0.3
|-
| <code>sqrt([[Number]] x)</code>
| [[Number]]
| Liefert die Quadratwurzel von x. sqrt steht für square root.
| 2.0.3
|-
| <code>log([[Number]] x)</code>
| [[Number]]
| Berechnet den Logarithmus zur Basis e.
| 2.0.3
|-
| <code>log10([[Number]] x)</code>
| [[Number]]
| Berechnet den Logarithmus zur Basis 10.
| 2.0.3
|}

<noinclude>
[[Category:Funktionen]]
</noinclude>