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

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 <

> zu >

' zu '

" zu "

& zu &

xml

encoded XML-Text

< zu <

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

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 Doppelpunkt getrennt das Locale angegeben werden:
```
##.00:en
```

Beispiele

Ausgabe einer Variablen

Template Quelltext

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