Form (SP-Tag)

Name

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

Syntax

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

Beschreibung

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

Attribute

Name	Type	Required	Default	ab IES Version
uri	Text	Nein	None	2
template	Attribute	Nein	None	2
handler	Text	Nein	None	2
module	Text	Nein	None	2
context	Text	Nein	None	2
nameencoding	Text	Nein	hex, wenn Formular an eine PHP-Seite gesendet wird	1
enctype	Text	Nein	None	1
method	Text	Nein	None	1
id	Text	Nein	None	1
name	Text	Nein	None	1
command (deprecated ab Version 2.0)	Text	Ja oder uri oder information	None	1
locale	Locale	Nein	None	1
Dynamische Attribute	Text	Nein	None	1

uri

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 uri noch template angegeben, so wird die aktuelle URL angesprochen.

template

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 Webapplikationen nicht mit Templates, sondern mit SPML-Seite realisiert werden.

handler

Handler, an das das Formular gesendet werden soll. Handler werden vor der, mit uri oder template angegebenen Seite, ausgeführt.

module

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

context

SPML-Seiten sind immer Teil einer Webapplikation. Jede Webapplikation besitzt eine Context-Pfad mit der die URL beginnt (Es existert auch ein ROOT-Context-Pfad (/)). Soll die URL einer Seite herausgeschrieben werden, die in einer anderen Webapplikation liegt, so wird mit diesem Attribut der Context-Pfad angegeben. Context-Pfade von Webapplikationen können sich ändern. Damit auch bei solchen Änderungen die URL richtig generiert wird sollte in den meisten Fällen eher das Attribut module verwendet werden.

nameencoding

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 ([, ]) enthalten könne. Beim Aufbau von 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 sp_body wird hex:73705f626f6479

command (deprecated ab Version 2.0)

Deprecated. Dieses Attribut ist veraltet und wird in zukünftigen Versionen nicht mehr unterstüzt werden. Kommandos wurden in der Version 2.0 abgeschafft zugunsten einer flexibleren Lösung abgeschafft. Ein Kommando bestand aus einem Template mit einem optionalen Handler. Für jede Template-Handler-Kombination musste ein eigenes Kommando angelegt werden. Diese Verbindung wurde aufgebrochen und durch zwei neue Attribute template und handler ersetzt. Um einen Handler aufzurufen und anschließend ein Template auszuführen ist nun die Definition eines Kommandos nicht mehr nötig. Um einen Handler auszurufen und anschließend ein Template auszuführen verwenden sie die beiden Attribute handler und template. Um einen Handler aufzurufen und anschließend eine SPML-Seite auszuführen verwenden sie die Attribute handler und uri.

Existierendes Command. Muss im GUI definiert worden sein.

enctype

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.

method

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.

locale

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

id

Optionale id für den erzeugten HTML-Form-Tag. Wird dieses Attribut nicht gesetzt wird automatisch eine ID generiert

name

Optionaler Name für das erzeugte Formular.

Dynamische Attribute

Dynamische Attribute sind beliebige HTML-Attribute, die evaluiert und bis zum HTML-Tag durchgereicht werden..

Beispiele

Neuen Artikel anlegen

Template Quelltext

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