WebRFC-Template-Syntax (SAP-Bibliothek

WebRFC-Template-Syntax

Bei den SAP-Standard-WebRFC-Templates handelt es sich um HTML-Dokumente, die alle zulässigen HTML-Befehle enthalten können. Sie können die Templates ändern oder eigene mit einem Text-Editor oder anderen entsprechenden Werkzeugen erstellen.

Bei der WebRFC-Template-Syntax handelt es sich um HTML-Syntax. Der einzige Unterschied besteht darin, daß WebRFC-Anwendungen ihre eigenen Platzhalter definieren können. Sie können diese Platzhalter durch generierten HTML-Quelltext mit dem Funktionsbaustein WWW_HTML_MERGER ersetzen.

Obwohl WebRFC-Anwendungen alle Zeichenketten als Platzhalter akzeptieren, empfiehlt SAP, aus zweierlei Gründen HTML-Kommentare zu verwenden (z.B. <!Platzhalter!>):

Es wird vermieden, daß als Platzhalter verwendete Zeichenketten als Bestandteil eines HTML-Befehls erscheinen.

Weiterhin erscheinen - wegen des den Kommentar kennzeichnenden Ausrufezeichens - nicht durch Daten ersetzte Platzhalter bei der Anzeige des HTML-Dokument im Browser nicht.

Wenn Sie ein Template ändern, sollten Sie sich über folgende Einschränkungen beim Einsatz von Platzhaltern im Klaren sein:

Da ABAP keine Datenströme unterstützt, werden sowohl Templates als auch generierter HTML-Quelltext in Tabellen mit einer 255 Zeichen breiten Spalte abgelegt. Laden Sie ein Template in das R/3-System, wird der Template-Text über die Endzeilenzeichen (harter und weicher Zeilenumbruch) in die entsprechende Tabellenstruktur gebracht.
Platzhalter mit mehr als 255 Zeichen sollten in getrennten Zeilen erscheinen. Die gesamte Zeile kann dann durch HTML-Quelltext ersetzt werden.
Platzhalter mit bis zu 255 Zeichen können in Zeilen mit anderen HTML-Befehlen oder sogar innerhalb eines Befehls erscheinen. Ist die resultierende Zeile länger als 255 Zeichen, wird die Zeile abgeschnitten.

In WebRFC-Anwendungen verwendete Platzhalter

Platzhalter	Bedeutung	Bemerkung
<!script!>	JavaScript (oder ähnlich) zum dynamischen Modifizieren von HTML-Seiten	Hiermit werden HTML-Seiten dynamisch modifiziert. Enthält im interaktiven Web Reporting Funktionen, die auf Ereignisse reagieren.
!mimepath!	MIME-Typ	Pfad zu Grafiken, Bildern oder anderen binären Daten
<!text-nnn!>	Textsymbol	Hiermit können Sie Textelemente in Templates einsetzen.

Wenn ein Platzhalter innerhalb einer Zeichenkette im HTML-Text verwendet wird, hat SAP die Befehlsnotation weggelassen, da sie dann keinen Sinn ergibt.

Beispiel

<image> src="/dir1/!mimepath!/img.gif">