Ausgabe im XDF-Format

Ein XSF-Schema beschreibt mit Hilfe von XML die Inhalte eines Formulars. Daten, die Sie über die Formularschnittstelle an das Formular übergeben und in das Formular eingebunden haben, sind im XSF-Datenstrom als Body des <sym>-Tags sichtbar, beispielsweise der Wert 1349,00 in:

<sym name="WA_BOOKING-FORCURAM">1349,00</sym>

Angaben über den Typ von WA_BOOKING sind im XSF-Schema nicht enthalten, da dieses Format nur die Ausgabe des Formulars beschreibt. Die Werte der Symbole sind also schon währungs- und sprachenabhängig aufbereitet.

Anwendungen, die Formulare im SAP-System aufrufen 'wissen' natürlich, welche Daten sie dem Formular an der Formularschnittstelle übergeben haben. Sollen diese Daten aber außerhalb des SAP-Systems verarbeitet werden, reicht das XSF-Schema nicht aus.

Hier schafft das XDF-Format Abhilfe. Mit dem XDF-Format können Sie die Daten eines Formularaufrufs an die Spool-Verarbeitung übergeben oder als Tabelle zurückgeben lassen.

Voraussetzungen

Bei der Ausgabe über die Spool-Verarbeitung muß im System wenigstens ein Drucker vom Type 'PLAIN' eingerichtet sein. SAP Smart Forms legt XDF im Spool im Binär-Format ab, damit keine Informationen durch Konvertierungen verloren gehen (siehe auch: Ausgabe von XML-Dokumenten).

Funktionsumfang

Ein XDF-Dokument enthält sowohl die von der Anwendung übergebenen Import- und Tabellen-Parameter als auch gesetzte Standard-Parameter. Auch wenn von der Anwendung nichts übergeben wurde, gibt es zu jedem in der Formularschnittstelle definierten Parameter ein Tag mit den folgenden Angaben:

Der Name des Tags entspricht dem Namen des Schnittstellenparameters
Das Attribut TYPE gibt den Datentypen des ABAP Dictionaries zum Parameter an
Das Attribut OBJECT gibt den ABAP Dictionary Objekttypen (z.B. "TABL") an
Das Attribut TIMESTAMP enthält den Zeitpunkt der letzten Änderung des Dictionary-Typs

Die Werte für diese Attribute werden zum Aufrufzeitpunkt bestimmt. Im Body der Tags stehen die übergebenen Werte der Anwendung. SAP Smart Forms verwendet für die Darstellung der Werte die gleiche XML-Repräsentation wie das Interface Repository.

Hinweis Hinweis

Numerische Werte, bei denen nicht entschieden werden kann, ob den Wert 0 haben oder initial sind, werden mit ausgegeben.

Ende des Hinweises

Aktivitäten

Statische Aktivierung im Formular

Wählen Sie im Form Builder den Knoten Formularattribute und dann die Registerkarte Ausgabeoptionen.
Im Rahmen Ausgabe stellen Sie als Ausgabeformat XDF Ausgabe ein. Sie können Spool oder Anwendung wählen.
Bei der Auswahl Spool können Sie optional ein Ausgabegerät vom Typ PLAIN angeben (alternativ geht das auch im Spool-Dialog).
Aktivieren Sie Ihr Formular.

Dynamische Aktivierung beim Funktionsbausteinaufruf

Definieren Sie eine Struktur für die Ausgabeoptionen (Typ: SSFCOMPOP):
Syntax
1. ```
data: output_options    type SSFCOMPOP.
```
Ende des Codes
Um die statischen Einstellungen zu überschreiben, setzen Sie das Feld XDFCMODE:
Syntax
1. ```
output_options-xdfcmode = 'X'.
```
Ende des Codes
Mit den Parametern XDF, XDFOUTMODE und XDFOUTDEV bestimmen Sie nun die XDF-Einstellungen ähnlich wie bei der statischen Aktivierung. Die XDF-Ausgabe aktivieren Sie mit dem Parameter XSF. Der Ausgabemodus entspricht dem Parameter XSFOUTMODE ('S' für Spool und 'A' für Anwendung) und das Ausgabegerät dem Parameter XSFOUTDEV, zum Beispiel:
Syntax
1. ```
output_options-XDF = 'X'.
output_options-XDFOUTMODE = 'S'.
output_options-XDFOUTDEV = 'P863'.
```
Ende des Codes
Achtung
Falls der Parameter TDDEST der Ausgabeoptionen mit einem Wert belegt ist, ignoriert SAP Smart Forms XSFOUTDEV.

Ende der Warnung.
Rufen Sie den gererischen Funktionsbaustein auf und übergeben Sie die Struktur output_options an den gleichnamigen Standard-Parameter.

Rückgabe von XDF als Tabelle (XSFOUTMODE='A')

Die XDF-Tabelle wird mit den gleichen Parametern übergeben wie bei der XSF-Ausgabe, also mit der XML/HTML-Ausgabestruktur (XMLOUTPUT) des Standard-Export-Parameters JOB_OUTPUT_INFO.