Print (SP-Tag)

Name

<sp:print> - Ausgabe-Tag

Syntax

 <sp:print name="variable" encoding="html"/>

Beschreibung

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

Attribute

Name	Type	Required	Default	ab IES Version
name	Attribute	Ja oder text bzw. expression	None	1
text	Text	Ja oder name bzw. expression	None	1
expression	Expression	Ja oder name bzw. text	None	1
default	Text	Nein	None	1
encoding	Text	Nein	None	1
encrypt	Text	Nein	None	1
locale	Locale	Nein	None	1
dateformat	Text	Nein	None	1
decimalformat	Text	Nein	None	1
arg	Expression	Nein	None	2.0.3

name

Attribute das ausgegeben werden soll (Siehe „Attribute“).

text

Alternative zu name (Siehe „Text“).

expression

Alternative zu name (Siehe „Expression“).

default

Auszugebender Default-Wert, wenn das Ergebnis von name bzw. text bzw. expression leer ist.

encoding

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

< zu &lt;

> zu >

' zu '

" zu "

& zu &

xml

encoded XML-Text

< zu &lt;

> zu >

' zu '

" zu "

& zu &

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: [1]

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

encrypt

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

locale

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

dateformat

Angaben zur Datumsformatierung. Um für die Formatierung die gewünschte Sprache zu erhalten bestehen folgende Möglichkeiten:

• Die Angabe einer Sprache über das locale-Attribut dieses Tags. Dies hat aber auch Einfluss auf die in name angegebenen Variablen.
• Übername des Locals des aktiven Publishers. Wird das locale-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:

  dd.MM.yyyy HH:mm|en
  

decimalformat

Angaben zur Dezimalformatierung. Um für die Formatierung die gewünschte Sprache zu erhalten bestehen folgende Möglichkeiten:

• Die Angabe einer Sprache über das locale-Attribut dieses Tags. Dies hat aber auch Einfluss auf die in name angegebenen Variablen.
• Übername des Locals des aktiven Publishers. Wird das locale-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:

  ##.00|en
  

  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 deklariert.

arg (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 arg</arg>-Attributen angegenben werden. Es ist also möglich mehere Attribute arg in diesem Tag anzugeben. Diese Formatierung wird durchgeführt, wenn mindestens ein arg-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 arg-Attributen nach den Regeln des StringFormats formatiert. Zu beachten ist, das die arg-Argumente eine Expression erwartet. Zahlen können direkt übergeben werden. Zeichenketten müssen ich ' gefasst werden

<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"/>

Ausgabe

Nicht definierte Variablen liefern:
Sie können aber einen Default-Wert haben: Hallo

Ausgabe einer Expression

Template Quelltext

<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"/>

Ausgabe

Der Print-Tag kann auch rechnen:
(7 + 12) * 2 - 3 = 35