URL-Zugriff auf Smart Forms Objekte
Smart Forms verwendet beim Aufbau eines Web-Formulars Services des Internet Communication Framework (ICF). Sie können einen solchen Service dazu nutzen, auf Smart Forms Objekte — zum Beispiel Smart Styles, Grafiken und Texte — auch unabhängig von einem kompletten Web-Formular zuzugreifen. Um ein Objekt zu referenzieren, verwenden Sie einfach eine URL. Auf diese Weise können Sie zum Beispiel einen CSS style zu einem Smart Style oder Logos auf eigene Web-Seiten einbinden.
Integration
Wenn Sie auf ein Smart Forms Objekt über eine URL zugreifen, führt Smart Forms folgende Schritte durch:
Das Objekt wird aus dem SAP-System gelesen.
Für die Anzeige im Web konvertiert Smart Forms das Objekt in ein Zielformat. Je nach Objekt kann es mehrere Zielformate geben.
Das umgesetzte Zielformat wird in einen Cache im SAP-System geschrieben. Bei einem erneuten Zugriff (auch durch einen anderen Benutzer) braucht das Objekt dann nicht mehr gelesen und konvertiert werden.
Das Objekt wird übertragen, in der Regel zur Anzeige in einem Web-Browser.
Funktionsumfang
Um auf die Objekte zuzugreifen, verwenden Sie eine URL, die aus der Adresse Ihres SAP Web Application Servers (hier mit <WAS> abgekürzt), einem zum Objekt passenden Verzeichnispfad und dem Objektnamen besteht. Das Zielformat ist als Suffix im Objektnamen enthalten:
http://
<WAS>
/sap/bc/smart_forms/<Objekt-Typ>
/<Objektname>
.<Format-Suffix>
Zusätzlich können Sie an die URL Parameter der BSP-Laufzeit anhängen. Bei Textbausteinen steuern Sie über den Parameter sap-language die Sprache, in der der Textbaustein aus dem SAP-System gelesen werden soll. Der Parameter erwartet die Sprache als ISO-Sprachkennung (siehe auch: Systemspezifische URL-Parameter).
Beispiel
Um auf einen Textbaustein mit dem Namen myMod in der Sprache Deutsch und im HTML-Format zuzugreifen, können Sie folgenden Link verwenden:
http://
<WAS>
/sap/bc/smart_forms/sftext/myMod.htm?sap-language=de
In der folgenden Übersicht wird auf den Präfix "http:///sap/bc/smartforms<WAS>
" verzichtet, da er in allen Fällen gleich ist:
URL-Zugriff auf Smart Forms Objekte
Objekt |
Ausgabeformat |
URL-Struktur (ohne Prafix, siehe oben) |
Namensraum (Bei XML-Format) |
||
Formular- beschreibung |
XML |
/sfform/<Formularname>.xml |
urn:sap-com:SmartForms:2000:internal-structure |
||
Smart Style |
CSS |
/sfstyle/<Name des Smart Style>.css |
BDS-Grafik |
BMP |
/gr/graphics/bmap/<Typ>/<Name der Grafik>.bmp <Typ> kann entweder
|
Textbaustein |
HTML |
/sftext/<Name des Textbausteins>.htm |
Textbaustein |
XML |
/sftext/<Name des Textbausteins>.xml |
urn:sap-com:SmartForms:2000:xsf |
||
SAPscript-Text |
HTML |
/stdtext/<Textobjekt>/<Text-ID>/<Sprache>/<Textname>.htm |
SAPscript-Text |
XML |
/stdtext/<Textobjekt>/<Text-ID>/<Sprache>/<Textname>.xml |
urn:sap-com:SmartForms:2000:xsf |
Beispiel
Sie wollen die gleichen Schriften, die Sie auf einem Formular verwenden (beim Drucken oder bei Verwendung eines Web-Formulars), auf einer anderen BSP-Seite verwenden. Angenommen, Ihr Smart Style hätte den Namen mystyle. Sie können sich dann den zugehörigen CSS style mit Hilfe der folgenden URL herunterladen:
http://<Adresse des SAP Web AS>/sap/bc/smart_forms/sfstyle/mystyle.css
Ein Absatzformat AS aus dem Smart Style könnte im CSS style beispielsweise so aussehen:
Syntax
.MYSTYLE DIV#AS.par { font-family : "Courier New" ; font-size : 12pt ; font-weight : bold ; line-height : 1em ; text-decoration : underline ; text-align : left ; }
Wenn Sie nun das generierte CSS in eigene HTML-Seite einbauen wollen, verweisen Sie einfach im Header auf diesen Stylesheet und verwenden das Tag <div> mit den entsprechenden Attributen, um auf die Formate zuzugreifen:
Achtung
In diesem Beispiel wird der CSS style für das Layout einer BSP-Seite genutzt. Deshalb fehlt der Präfix http://<WAS>.
Syntax
<html> <head> <link rel="STYLESHEET" href="/sap/bc/smart_forms/sfstyle/mystyle.css" /> </head> <body> <div class="MYSTYLE"> <div class="par" ID="AS"> Ihr formatierter Text </div> </div> </body> </html>