SAP Query verfügt über mehrere Möglichkeiten, die von einer Query ermittelten Daten an andere Software-Produkte weiterzugeben. Zum Beispiel können diese Daten

• an ein Tabellenkalkulationsprogramm (z.B. EXCEL) über die XXL-Schnittstelle

• an die SAP-Präsentationsgrafik

• an das Führungsinformationssystem EIS weitergegeben oder

• über die Download-Schnittstelle als Datei abgelegt werden.

In allen Fällen ist die Vorgehensweise ähnlich. Die ermittelten Daten werden in einer internen Tabelle (Datentabelle) bereitgestellt, deren Felder in Reihenfolge und Typ den Feldern entsprechen, die in der Liste ausgegeben werden. Eine weitere interne Tabelle (Beschreibungstabelle) enthält eine Beschreibung der einzelnen Felder der Datentabelle. Neben Typ und Position in der Liste sind z.B. Informationen über die Feldnamen enthalten. Diese beiden Tabellen werden an die oben genannten Produkte übergeben und von ihnen weiter verarbeitet.

SAP Query stellt diese Schnittstelle auch allgemein zur Verfügung, so daß jeder Kunde die Möglichkeit hat, eigene Software-Produkte anzuschließen. Dies ist das Ziel der Erweiterung SQUE0001.

Die Erweiterung SQUE0001 besteht aus zwei Komponenten:

• dem Funktionsbaustein EXIT_RSAQEXCE_001

• der Menüerweiterung RSAQEXCE+DAT

Die Aktivierung der Erweiterung im Rahmen eines Projektes (Transaktion CMOD) bewirkt, daß in jedem von der Query erzeugten Report eine zusätzliche interaktive Funktion Private Ablage (Funktionscode: +DAT) zur Verfügung steht, durch deren Aktivierung der oben genannte Funktionsbaustein gerufen wird. Im wesentlichen werden dem Funktionsbaustein die oben erwähnten Tabellen (Datentabelle und Beschreibungstabelle) übergeben. Außerdem erscheint auf dem Selektionsbild ein zusätzlicher Parameter, der wie bei den anderen interaktiven Funktionen (EXCEL, Grafik, EIS, Dateiablage, Sichern usw.) die Möglichkeit bietet, die zusätzliche Funktion Private Ablage direkt auszuführen, d.h. ohne vorherige Anzeige der Liste. Da der Parameter auf dem Selektionsbild Private Ablage heißt, wird empfohlen, die Menüerweiterung ebenso zu benennen (entspricht dem Vorschlag von SAP).

Im folgenden wird beschrieben, welche Parameter dem Funktionsbaustein EXIT_RSAQEXCE_001 übergeben werden und wie die Werte dieser Parameter zu interpretieren bzw. zu verarbeiten sind. Dazu wird auf folgendes Beispiel zurückgegriffen:

Ein Nutzer hat im Mandanten 03 in der Benutzergruppe RX eine Query X1 angelegt, die aus einer einzeiligen Grundliste, einer Statistik und einer Rangliste besteht. In der Grundliste werden die Felder

in dieser Reihenfolge ausgegeben. In der Statistik werden die Felder

in dieser Reihenfolge ausgegeben, wobei für das Feld KNC1-UM01U außerdem Angaben über die Anzahl der gelesenen Sätze, den prozentualen Anteil und den Mittelwert gefordert werden. In der Rangliste werden die Felder

in dieser Reihenfolge ausgegeben.

Der Funktionsbaustein EXIT_RSAQEXCE_001 besitzt folgende Parameter:

Dieser Parameter enthält den Namen des Query-Reports, der den Aufruf des Funktionsbausteines veranlaßt hat. Aus diesem Namen kann ermittelt werden, welche Query abgearbeitet wurde, da er stets folgenden Aufbau hat.

Dieser Parameter LIST_ID enthält ein dreistelliges Kürzel zur Identifizierung der übergebenen Datentabelle. Jede von einer Query erzeugte Liste kann aus mehreren Teillisten bestehen (eine Grundliste, mehrere Statistiken, mehrere Ranglisten). Die an den Funktionsbaustein übergebene Datentabelle (DATATAB) enthält jeweils nur die Daten einer Teilliste. Die Beschreibungstabelle (LISTDESC) enthält jedoch stets die Beschreibung für die Felder aller Teillisten.

Die möglichen Werte des Parameters sind

Dieser Parameter enthält einen Text, der bei der Definition der Query der entsprechenden Teilliste zugeordnet wurde.

Diese Tabelle enthält die Daten der übergebenen Teilliste. Die Felder dieser Tabelle entsprechen in Reihenfolge und Typ den Feldern, die in der Teilliste ausgegeben wurden. Jeweils eine Tabellenzeile entspricht einer Listenzeile. Dabei werden eventuell vorhandene Zeilenumbrüche in Zeilen von Grundlisten nicht berücksichtigt, d.h. solche umgebrochenen Zeilen bilden trotzdem eine Tabellenzeile.

Da der Aufbau der Datentabelle von der Definition der übergebenen Teilliste abhängig ist, kann ihre Struktur nicht mit übergeben werden, sondern muß im Funktionsbaustein selbst bestimmt werden. Dazu kann die Beschreibungstabelle LISTDESC mit zu Hilfe genommen werden. Der Zugriff auf einzelne Felder der Datentabelle ist mit Hilfe von Feldsymbolen und der Anweisung ASSIGN COMPONENT möglich.

Wird im vorliegenden Beispiel die Grundliste übergeben, so besteht eine Zeile der Datentabelle aus 5 Feldern mit folgenden Typen, Längen und Dezimalstellen:

Wird die Statistik übergeben, so besteht eine Zeile der Datentabelle aus 5 Feldern mit folgenden Typen, Längen und Dezimalstellen:

Wird die Rangliste übergeben, so besteht eine Zeile der Datentabelle aus 4 Feldern mit folgenden Typen, Längen und Dezimalstellen:

Die Angaben über Typ, Länge und Dezimalstellenzahl können entweder mit Hilfe der ABAP-Anweisung DESCRIBE FIELD oder mit Hilfe der Beschreibungstabelle LISTDESC (siehe unten) ermittelt werden.

Die Beschreibungstabelle LISTDESC enthält eine Beschreibung der Felder der Datentabelle DATATAB, die neben Typ, Länge und Dezimalstellenzahl auch Informationen umfaßt, die nicht mit Hilfe der ABAP-Anweisung DESCRIBE FIELD ermittelt werden können. Wenn eine Query aus mehreren Teillisten besteht (wie im vorliegenden Beispiel), so enthält die Beschreibungstabelle immer die Beschreibung für die Felder aller Datentabellen (aller Teillisten), die von dieser Query übergeben werden können. Über den Parameter LIST_ID können dann die passenden Einträge aus der Beschreibungstabelle besorgt werden.

Im vorliegenden Beispiel würde also die Beschreibungstabelle stets die Beschreibung für die Felder der Datentabelle der Grundliste, die Felder der Datentabelle der Statistik und die Felder der Datentabelle der Rangliste enthalten.

Die Beschreibungstabelle besitzt die Struktur RSAQLDESC. Diese Struktur besteht aus folgenden Feldern: