Programmierinterface eines Range-Context-Knotens

Verwendung

Zum Arbeiten mit dem Range-Context-Knoten steht das Interface IF_WD_CONTEXT_NODE_RANGE zur Verfügung, welches das Interface IF_WD_CONTEXT_NODE für Standard-Context-Knoten um einige Methoden erweitert. Diese werden im Folgenden kurz beschrieben. Weitere Informationen finden Sie im System in der zugehörigen Systemdokumentation.

IF_WD_CONTEXT_NODE_RANGE~SET_TABLE_RANGE

Diese Methode ermöglicht es, einen Ausschnitt der gesamten Datenmenge, die der Context-Knoten verwalten soll, an den Knoten zu übergeben.

Name	Typisierung	Beschreibung
NEW_ITEMS	TYPE ANY TABLE	Ausschnitt der internen Tabelle, die an den Context-Knoten gebunden werden soll.
INDEX	TYPE I	Position im Context-Knoten, an die der Tabellenausschnitt eingefügt werden soll.
INVALIDATE_CHILD_NODES	TYPE ABAP_BOOL	Dieser optionale Parameter gibt an, ob bereits existierende Context-Elemente und deren Kind-Knoten invalidiert werden sollen. Der Standardwert des Parameters ist ABAP_FALSE, d. h. bereits bestehende Context-Elemente bleiben gültig, nur deren Daten werden überschrieben.

IF_WD_CONTEXT_NODE_RANGE~GET_ELEMENTS

Diese Methode liefert die im angegebenen Bereich liegenden Context-Elemente zurück. Falls die angeforderten Daten noch nicht an den Context übergeben wurden, wird die Range-Supply-Methode aufgerufen, falls diese existiert.

Name	Typisierung	Beschreibung
FROM	TYPE I	Dieser Parameter kennzeichnet den Anfang des Bereichs, für den die Context-Elemente angefordert werden.
TO	TYPE I	Dieser Parameter kennzeichnet das Ende des Bereichs, für den die Context-Elemente angefordert werden.

Name	Typisierung	Beschreibung
SET	TYPE IF_WD_CONTEXT_NODE_RANGE~TY_T_ELEMENTS	Liste von Context-Elementen und deren Indices.

IF_WD_CONTEXT_NODE_RANGE~SET_MAX_ELEMENT_COUNT

Diese Methode muss aufgerufen werden, um die maximale Größe des Context-Knotens zu setzen.

Achtung

Wird die maximale Größe des Context-Knotens nicht gesetzt, dann kommt es beim Binden von Daten an den Context-Knoten zu einem Kurzdump.

Name	Typisierung	Beschreibung
MAX_ELEMENT_COUNT	TYPE I	Maximale Größe des Context-Knotens.

IF_WD_CONTEXT_NODE_RANGE~GET_MAX_ELEMENT_COUNT

Diese Methode gibt die maximale Größe des Context-Knotens zurück.

Name	Typisierung	Beschreibung
MAX_ELEMENT_COUNT	TYPE I	Maximale Größe des Context-Knotens.

IF_WD_CONTEXT_NODE_RANGE~SET_SELECTION

Diese Methode ermöglicht es, die Selektion des Context-Knotens zu setzen, ohne dass dafür Context-Elemente erzeugt werden müssen. Dies kann insbesondere dann zu einer Speicherersparnis führen, wenn alle Zeilen einer Tabelle selektiert werden.

Name	Typisierung	Beschreibung
SELECTION	TYPE IF_WD_CONTEXT_NODE_RANGE~TY_T_SELECTION	Angabe, welcher Bereich des Context-Knotens selektiert werden soll.
SELECT_ALL	TYPE ABAP_BOOL	Angabe, ob der gesamte Inhalt des Context-Knotens selektiert werden soll..

IF_WD_CONTEXT_NODE_RANGE~GET_SELECTION

Diese Methode gibt den selektierten Bereich des Context-Knotens zurück.

Name	Typisierung	Beschreibung
SELECTION	TYPE IF_WD_CONTEXT_NODE_RANGE~TY_T_SELECTION	Selektierter Bereich des Context-Knotens.

IF_WD_CONTEXT_NODE_RANGE~SET_MIN_ELEMENT_COUNT

Diese Methode setzt die minimale Größe des Context-Knotens, d.h. die Anzahl der Elemente, die beim erstmaligen Aufruf der Range-Supply-Methode für einen noch leeren Context-Knoten mindestens angefordert wird. Der Standardwert für diese minimale Größe liegt bei fünf Elementen.

Name	Typisierung	Beschreibung
MIN_ELEMENT_COUNT	TYPE I	Dieser Parameter setzt die minimale Größe des Context-Knotens.

IF_WD_CONTEXT_NODE_RANGE~GET_MIN_ELEMENT_COUNT

Diese Methode gibt die minimale Größe eines Context-Knotens zurück.

Name	Typisierung	Beschreibung
MIN_ELEMENT_COUNT	TYPE I	Dieser Parameter setzt die minimale Größe des Context-Knotens.

IF_WD_CONTEXT_NODE_RANGE~INVALIDATE_RANGE

Diese Methode ermöglicht es, einen Bereich des Context-Knotens zu invalidieren, d.h. die Context-Elemente, die in einem bestimmten Bereich des Context-Knotens liegen, aus dem Context-Knoten zu entfernen.

Name	Typisierung	Beschreibung
FROM	TYPE I	Dieser Parameter kennzeichnet den Anfang des Bereichs, ab dem die Context-Elemente aus dem Context-Knoten entfernt werden sollen.
TO	TYPE I	Dieser Parameter kennzeichnet das Ende des Bereichs, bis zu dem die Context-Elemente aus dem Context-Knoten entfernt werden sollen.

IF_WD_CONTEXT_NODE_RANGE~BIND_TABLE_RANGE

Diese Methode ähnelt SET_TABLE_RANGE, wobei jedoch die Zeilen eingefügt werden, was dazu führt, dass auch die Gesamtzahl der Zeilen erhöht wird.

Hinweis

Sie sollten BIND_TABLE_RANGE nicht in der Supply-Methode aufrufen, sondern dort statt dessen SET_TABLE_RANGE aufrufen.

Weitere Informationen

Range-Context-Knoten