Ansicht
Dokumentation

DMC_DDIF_TABL_GET_WRAPPER - DD: Schnittstelle zum Lesen einer Tabelle aus dem ABAP/4 Dictionary

ROGBILLS - Synchronize billing plans   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Mit diesem Funktionsbaustein können die Dictionary-Sourcen einer Tabelle gelesen werden. Der Name der zu lesenden Tabelle ist im Parameter NAME zu übergeben.

Die Sourcen der Tabelle werden gemäß STATE gelesen. Dabei sind STATE = 'A' (Lesen der aktiven Version) und STATE = 'M' (Lesen der neuesten Version) möglich. Ist der Parameter LANGU gefüllt, so werden die zugehörigen Texte in der durch LANGU spezifizierten Sprache mitgelesen.

Im Parameter GOTSTATE erfährt man, in welchem Zustand das Objekt gelesen wurde. Falls STATE = 'A' war, so kann GOTSTATE die Werte 'A' (Objekt besitzt aktive Version) und ' ' (keine aktive Version des Objekts vorhanden) annehmen. Falls dagegen STATE = 'M' war, so kann GOTSTATE die Werte ' ' (Objekt nicht im ABAP Dictionary vorhanden), 'N' (Objekt befindet sich im Zustand "neu" im ABAP Dictionary), 'A' (Objekt befindet sich im Zustand "aktiv" im ABAP Dictionary) und 'M' (Objekt befindet sich im Zustand "überarbeitet" im ABAP Dictionary) annehmen.

Beispiel

Hinweise

Alle TABLE-Parameter sind (genau wie natürlich die EXPORT-Parameter) optional. Der Funktionsbaustein besorgt auch nur die Teile der Sourcen, die vom Aufrufer erfragt werden. Um unnötige Leseoperationen zu vermeiden, sollten beim Aufruf daher nur die Parameter versorgt werden, die für die weitere Bearbeitung auch gebraucht werden. Falls also zum Beispiel die Indizes einer Tabelle nicht gebraucht werden, so sollten die Parameter DD12V_TAB und DD17V_TAB nicht versorgt werden.

Die folgenden Abschnitte sind nur relevant, wenn die gelesene Tabelle andere Strukturen inkludiert.

Hat GOTSTATE den Wert 'A', so wird die Tabelle in expandierter Version zurückgegeben. Das bedeutet, daß alle inkludierten Strukturen einschließlich ihrer Fremdschlüssel aufgelöst wurden. Dies betrifft auch die bereits an die Tabelle angehängten Append-Strukturen (das sind im Normalfall alle aktiven Append-Strukturen zu dieser Tabelle).
Felder, die in einer inkludierten Struktur liegen erkennt man hierbei daran, daß das Feld ADMINFIELD der DD03P_TAB einen Wert von '1' bis '9' hat.

Hat GOTSTATE dagegen den Wert 'M' oder 'N', so wird die Tabelle in komprimierter Form zurückgegeben. Das heißt, daß Felder, die in inkludierten Strukturen (oder in Append-Strukturen) liegen nicht in der Feldliste (DD03P_TAB) auftauchen.
Für Fremdschlüssel bedeutet dies, daß Fremdschlüssel, deren Prüffeld in einer inkludierten Struktur liegt, nur dann angegeben werden, wenn ihre Definition von der Definition bei der Struktur abweicht. Solche Fremdschlüsseldefinitionen erkennt man daran, daß in ihrem Header (DD08V_TAB) das Feld NOINHERIT den Wert 'Y' oder den Wert 'N' hat.
Dabei besagt NOINHERIT = 'Y', daß alle Eigenschaften des Fremdschlüssels übersteuert wurden. In diesem Fall bedeutet CHECKTABLE = '*', daß an dem betrachteten Feld kein Fremdschlüssel hänget, selbst, wenn das Feld in der inkludierten Struktur Prüffeld eines Fremdschlüssles ist. Ansonsten ist in CHECKTABLE die für dieses Feld gültige Prüftabelle angegeben und in DD05M_TAB sind die Feldzuordnungen zu finden.
Dagegen besagt NOINHERIT = 'N', daß die Feldzuordnungen von der inkludierten Tabelle übernommen werden und nur die sonstigen Attribute (Text, Verhalten auf dem Dynpro, semantische Eigenschaften) durch die angegebene Definition übersteuert werden. Daher finden sich in diesem Fall auch keine zugehörigen Einträge in DD05M_TAB.

Ein Eintrag in der DD03P_TAB bezeichnet genau dann eine inkludierte Struktur, wenn PRECFIELD <> ' ' ist.

Weiterführende Informationen

Parameter

DD02V_WA
DD03P_TAB
DD05M_TAB
DD08V_TAB
DD09L_WA
DD12V_TAB
DD17V_TAB
EV_VIEWREF
E_EXIST_ON_DB
GOTSTATE
I_CHECK_ON_DB
I_DEL_GROUPNAME
I_GET_ALL_INFOS
I_NAMETAB_ONLY
LANGU
NAME
STATE

Ausnahmen

ILLEGAL_INPUT
NO_AUTHORIZATION
NO_FIELDS
UNDEFINED_ERROR

Funktionsgruppe

CNV0

rdisp/max_wprun_time - Maximum work process run time   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4942 Date: 20240523 Time: 122110     sap01-206 ( 117 ms )