Easy Query API

Im folgenden wird das Ergebnis der Easy Query erläutert:

Import

Wenn die Query Variablen enthält, wird für jede Variable eine Importstruktur des Typs RSEQ_S_SELECT_OPTION (SIGN, OPTION, LOW, HIGH ) angelegt.

Beispiel

Die Query hat eine Pflichtvariable für das Merkmal Land. Das Merkmal ist auf den Wert country = Germany eingeschränkt worden.

SIGN = ‘I’

OPTION = ‘EQ’

LOW = ‘DE’

HIGH =’’

Ende des Beispiels.

Export

Die Easy Query bereitet die Daten so auf, dass sie von verschiedenen Werkzeugen anwendungsspezifisch zur Darstellung gebracht werden können. Um dies zu ermöglichen, liefert die Easy Query als Ergebnis folgende Tabellen (siehe auch Beispiel: Easy Query API):

Wertetabelle E_T_GRID_DATA

Die Tabelle E_T_GRID_DATA enthält die Werte. Jede Kennzahl erscheint zweimal in dieser Tabelle: einmal unformatiertfür die Aufbereitung zur Verwendung für Diagramme, einmal als formatierter Textstring entsprechend den lokalen Benutzereinstellungen.

Spaltenbeschreibung in der Tabelle E_T_COLUMN_DESCRIPTION

Hierbei handelt es sich um Informationen über die Spalten des Result Sets mit den sprachabhängigern Bezeichnungen.

Spaltenüberschrift	Beschreibung
COLUMN_NAME	Technischer Name der Spalte
COLUMN_Type	Typ der Spalte; mögliche Werte sind: C = Merkmal A = Attribut K = Kennzahl T = formatierte Kennzahl
COLUMN_DESCRIPTION	Spaltenbeschreibung (in der Anmeldesprache)

Zeilenbeschreibung in der Tabelle E_T_Row_Description

Hierbei handelt es sich um Zusatzinformationen zu den Ergebniswerten in der Tabelle E_T_GRID_DATA, damit diese ggf. vom Verwender berücksichtigt werden können.

Spaltenüberschrift	Beschreibung
ROW_ID	Zeilenzahl
COLUMN_ID	Spaltenzahl
VALUE_TYPE	Typ des Wertes, wie z.B.: T = Summe/Teilsumme (total/subtotal) E = aufgeklappter Hierarchieknoten (expanded hierarchy node) C = zusammengeklappter Hierarchieknoten (collapsed hierarchy node) L = Blattelement innerhalb einer Hierarchie (leaf element within the hierarchy)
PARENT_ROW_ID	Zeilenzahl des Vaters (nur für Hierarchien)
HIER_LEVEL	Zahl der Hierarchie-Ebene dieses Elementes

Nachrichtentabelle E_T_Message_Log

Hierbei handelt es sich um die Nachrichten.

Rückgabewerte

Rückgabewert

Beschreibung

E_S_QUERY_PROPERTIES

Metadaten der Query (InfoProvider, Queryname, angelegt am, Benutzer, der die Query angelegt oder geändert hat, Datum der letzten Änderung)

E_QUERY_OUTDATED_OR_INVALID

Kennzeichen, ob die Query veraltet oder ungültig ist.

Wenn die Query zu einem Zeitpunkt geändert wird, zu dem es bereits eine Easy Query gibt, muss die Easy Query erneut generiert werden, um die aktuellen Daten anzeigen zu können. Wenn die Neugenerierung nicht durchgeführt wird, setzt das System das Kennzeichen E_QUERY_OUTDATED_OR_INVALID=X, und die Easy Query zeigt keine Daten an.