Quelltext der Seite Spml (SPT-Tag)

==Name==
<spt:spml> - schreibt den Header für SPML-Live Seiten

==Syntax==
<source lang="xml">
<spt:spml/>
</source> 

==Beschreibung==
In einem Publikationsbereich herausgeschriebene SPML-Seite die Live ausgeführt werden sollen, benötigen Header-Informationen, die vor Beginn des eingentlichen SPML-Codes in der Seite stehen müssen. Dies ist nötig, um z.B. mit <code>system.publisher</code> abfragen zu können, in welchem Publikationsbereich die SPML-Seite liegt. Dieser Tag schreibt den benötigten Code in die Seite. Hierbei ist zu beachten, dass nicht der Tag selber herausgeschrieben werden darf. Dieser Tag wird in den Out-Teil eines Templates vor allen anderen Zeichen geschrieben. Das Template muß so aufgebaut sein, dass der <code><spt:spml></code>-Tag das erste Byte in die generierte Seite schreibt (Leerzeichen und Zeilenumbrüche dürfen nicht schon herausgeschrieben worden sein. Ist dies doch der Fall, schreibt der <code><spt:spml></code>-Tag die Fehlermeldung:

''can't execute <spt:spml>, spml-file must start with <spt:spml>''

Zu den Headerinformationen gehören auch Import-Anweisungen. Diese werden allerdings nur benötigt, wenn Scriptlet-Code in der SPML-Seite aufgenommen werden soll. Mit dem Attribut <code>api</code> können kommasepariert Namen der APIs angegeben werden, desses Packages mit Import-Anweisungen eingebunden werden sollen.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>api</code>
| [[String]]
| Nein
| None
| 2
|}

;<code>api</code>
:Kommaseparierte Liste von APIs, dessen Packages mit Import-Anweisungen eingebunden werden sollen. Mögliche APIs sind:
:;<code>log4j</code>
::Siehe http://logging.apache.org/log4j/1.2/apidocs/index.html
:;<code>jdom</code>
::Siehe http://www.jdom.org/docs/apidocs/index.html
:;<code>mail</code>
::Siehe http://java.sun.com/products/javamail/javadocs/index.html

==Beispiele==

===Fullpage-Template für SPML-Code===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<h1>Administrations-Template - Fullpage</h1>
<div class="editorblock">
  <h2>SPML-Fullpage-Code</h2>
  <em>Mit diesem Template können Sie den Code einer ganzen Seite erfassen.<br>
  <br>
  Eingabe<br>
  <spt:textarea name="sp_code" style="width: 100%;" cols="85" rows="20" wrap="off"/>
</div>
</sp:io><sp:io type="out"><spt:spml/><sp:print name="sp_code"/></sp:io>
</source>


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