Anfang des Inhaltsbereichs

Funktionsdokumentation Ausgabe im XDF-Format  Dokument im Navigationsbaum lokalisieren

Verwendung

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.

Hinweis

Siehe auch: Beispielausgabe.

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:

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. Die Abbildung von ABAP-Datentypen auf diese Repräsentation ist unter http://ifr.sap.com/home/Documents/ABAP_Serialization.htm beschrieben.

Hinweis

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

Aktivitäten

Statische Aktivierung im Formular

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

Dynamische Aktivierung beim Funktionsbausteinaufruf

  1. Definieren Sie eine Struktur für die Ausgabeoptionen (Typ: SSFCOMPOP):
  2. data: output_options    type SSFCOMPOP.

  3. Um die statischen Einstellungen zu überschreiben, setzen Sie das Feld XDFCMODE:
  4. output_options-xdfcmode = 'X'.

  5. 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:
  6. output_options-XDF = 'X'.
    output_options-XDFOUTMODE = 'S'.
    output_options-XDFOUTDEV = 'P863'.

    Achtung

    Falls der Parameter TDDEST der Ausgabeoptionen mit einem Wert belegt ist, ignoriert SAP Smart Forms XSFOUTDEV.

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

 

 

 

Ende des Inhaltsbereichs