Textareas (SAP-Bibliothek

Textareas

Verwendung

In einer HTML Textarea können Benutzer mehrzeiligen Freitext erfassen:

Diese Grafik wird im zugehörigen Text erklärt

Hinweis

Das Eingabefeld kann auch gegen Eingabe gesperrt werden.

Der Text innerhalb einer Textarea kann nicht formatiert werden.

Textareas können in Web-Formularen auch bei Verwendung des SAP Web AS 6.10 eingesetzt werden (über ein Support Package). Siehe Hinweis 434644.

Integration

Um HTML-Textareas auf einem Web-Formular zu integrieren, zeichnen Sie einen gesamten Text-Knoten auf der Registerkarte Web-Eigenschaften als Textarea aus (siehe: Textareas verwenden). Der generierte HTML-Code sieht dann so aus:

<textarea NAME="(Name des Text-Knotens)"
          ROWS="(Wert aus Eingabefeld Spalten/Breite)"
          COLS="(Wert aus Eingabefeld Zeilen/Höhe)"
          DISABLED  >

</textarea>

Hinweis

Es kann leider nicht geprüft werden, ob die Textarea in dem Fenster, in dem der Text-Knoten ausgegeben wird, genügend Platz hat.

Funktionsumfang

Smart Forms kann sowohl aus Textelementen, aus Textbausteinen als auch aus Include-Texten eine Textarea generieren. Vor und nach dem <TEXTAREA>-Tag generiert Smart Forms HTML-Eingabefelder vom Typ HIDDEN, in denen die Attribute des Smart Form Textes abgelegt sind. Beim Submit werden diese Attribute mit übertragen:

Übertragene Informationen bei Verwendung einer Textarea auf einem Web-Formular

Name des versteckten Eingabefeldes	Wert des Eingabefeldes nach Texttyp, falls es das Attribut für den Texttyp gibt
Name des versteckten Eingabefeldes	Textelement	Textbaustein	Include-Text
xsf_meta	TEXT_ELEMENT	TEXT_MODULE	TEXT_INCLUDE
name		Name des Textbausteins	Textname
object			Textobjekt
id			Text-ID
lang	Sprache, z.B.: DE	Sprache, z.B.: DE	Sprache, z.B.: DE
client			Mandant
Knotenname (Nur wenn Textarea-Inhalt änderbar)	(Inhalt der Textarea)	(Inhalt der Textarea)	(Inhalt der Textarea)
xsf_meta	/TEXT_ELEMENT	/TEXT_MODULE	/TEXT_INCLUDE

Die Felder werden in der hier angegebenen Reihenfolge (von oben nach unten) übertragen. Wie Sie in BSP-Applikationen auf die Übertragenen Name-/Werte-Paare zugreifen, entnehmen Sie dem Abschnitt Formulareingaben auswerten.

Zurückführen von geändertem Text in das Smart Form

In manchem Anwendungen möchten Sie den Text, der auf einem Web-Formular geändert wurde, wieder in ein Smart Form integrieren, um das Formular mit dem geänderten Text zu drucken. Für einfache und gruppierende Eingabetypen ist das kein Problem, denn die geänderten Werte können Sie über die Formularschnittstelle dem Formular übergeben.

Es ist aber nicht möglich, einen Text-Knoten an der Fomularschnittstelle zu übergeben und auch nicht vorgesehen, ein Textelement beziehungsweise einen Textbaustein über eine API von Smart Forms zu bearbeiten oder anzulegen. Falls Sie Text, der über eine Textarea erfaßt wurde, wieder in Ihrer Smart Forms Vorlage verwenden wollen, müssen Sie mit Include-Texten arbeiten. Einen Include-Text können Sie mit dem Funktionsbaustein SAVE_TEXT modifizieren, so daß beim erneuten Einlesen des Textes im Formular der aktualisierte Text gelesen wird.

Hinweis

Siehe auch die Funktionsbausteindokumenation zu SAVE_TEXT im Function Builder (SE37). SAPscript puffert Standardtexte (Textobjekt TEXT). Deshalb sind Änderungen an diesen Textobjekten nicht vor dem Verlassen der aktuellen Transaktion sichtbar. Verwenden Sie daher für den Fall, daß die mit SAVE_TEXT gemachten Änderungen direkt wieder angezeigt werden sollen, ein anderes, anwendungsspezifisches Textobjekt.