Ansicht
Dokumentation

DDIF_FIELDLABEL_GET - DD: Schnittstelle zum Lesen Texten zu Tabellen oder Typen

BAL Application Log Documentation   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Mit diesem Funktionsbaustein können Sie die Laufzeitinformation einer Tabelle oder allgemeiner eines beliebigen Typs des ABAP Dictionary lesen. Die Laufzeitinformation enthält auch Textinformation. Falls Sie keine Textinformation wünschen, so sollten Sie den wesentlich effizienteren Funktionsbaustein DDIF_NAMETAB_GET verwenden. In dessen Dokumentation sind auch die Begriffe erläutert, die im folgenden verwendet werden.

Dieser Baustein besorgt die Laufzeitinformation zu dem Typ, dessen Name im IMPORT-Parameter TABNAME festgelegt ist. Ist kein solcher Typ vorhanden, so wird die Ausnahme NOT_FOUND ausgelöst.
Achtung: Ist der IMPORT-Parameter ALL_TYPES nicht gesetzt, so werden nur flache strukturierte Typen berücksichtigt. In diesem Fall wird die Ausnahme also auch ausgelöst, falls der spezifizierte Typ ein Datenelement, eine tiefe Struktur oder ein Tabellentyp ist.

Ist der betrachtete Typ ein strukturierter Typ, so wird seine Feldliste im Parameter DFIES_TAB zurückgegeben.
Hat allerdings der IMPORT-Parameter FIELDNAME nicht den Initialwert, so werden nur die Felder berücksichtigt, deren Name mit dem Inhalt dieses Parameters übersinstimmt. Falls es kein solches Feld gibt (oder wenn der Typ ein Datenelement oder ein Tabellentyp ist), wird die Ausnahme NOT_FOUND ausgelöst.
Hat der IMPORT-Parameter LFIELDNAME nicht den Initialwert, so werden nur Felder berücksichtigt, deren langer Name mit dem Inhalt des Parameters übereinstimmt. Da es höchstens ein solches Feld geben kann, wird die Information dann im EXPORT-Parameter DFIES_WA zurückgegeben. DFIES_TAB ist in diesem Fall undefiniert. Falls es kein solches Feld gibt (oder wenn der Typ ein Datenelement oder ein Tabellentyp ist), wird die Ausnahme NOT_FOUND ausgelöst.

Ist der Typ ein Datenelement oder ein Tabellentyp (und ALL_TYPES gesetzt), so wird die Beschreibung des Typs ebenfalls im Parameter DFIES_WA zurückgegeben. Hat allerdings einer der beiden Parameter FIELDNAME oder LFIELDNAME nicht Initialwert, so wird die Ausnahme NOT_FOUND ausgelöst.

Die Texte werden in der durch den Parameter LANGU spezifizierten Sprache zurückgegeben. Ist dieser Parameter initial, so ist der Inhalt der Textfelder undefiniert. Ebenfalls undefiniert ist der Inhalt der Textfelder für Tabellentypen und für die Felder, die keinen elementaren Typ haben. Datenelemente bzw. Felder mit elementarem Typ, für die in der spezifizierten Sprache kein Text vorhanden ist, sind daran zu erkennen, daß das Feld DFIES-LANGU Initialwert hat.

Mit Hilfe dieses Bausteins können auch die Festwerte (einschließlich der zugehörigen Festwerttexte) von elementaren Typen bestimmt werden. Ist der spezifizierte Typ ein Datenelement, zu dem Festwerte definiert sind, oder ist das durch den Parameter LFIELDNAME spezifizierte Feld durch ein solches Datenelement typisiert, so bestimmt der Baustein diese Festwerte. Die zugehörigen Festwerttexte werden ggf. in der durch LANGU definierten Sprache hinzugefügt. Diese Information wird im TABLES-Parameter FIXED_VALUES zurückgegeben. (In allen anderen Fällen ist dieser Parameter leer.)

Beispiel

Hinweise

1. Dieser Baustein liefert die Laufzeitinformation der Tabelle. Falls die Beschreibung der Tabelle benötigt wird, wie sie sich in der Pflegetransaktion des ABAP Dictionary präsentiert, so sollte der Funktionsbaustein DDIF_TABL_GET verwendet werden (bzw. DDIF_DTEL_GET oder DDIF_TTYP_GET).
2. Dieser Baustein besorgt jeweils nur die Daten zu den versorgten Parametern. Sie sollten daher immer nur die Parameter beim Aufruf versorgen, deren Inhalte bestimmt werden sollen. Benötigen Sie z.B. keine Information zu den Festwerten des behandelten Typs, so sollten Sie den TABLES-Parameter FIXED_VALUES beim Aufruf unversorgt lassen.
3. Haben die IMPORT-Parameter FIELDNAME und LFIELDNAME beide nicht den Initialwert, so werden beide Einschränkungen ausgewertet. Das Ergebnis steht dann gegebenenfalls in DFIES_WA.
   Im allgemeinen ist es ratsam, nur den Parameter LFIELDNAME zu benutzen. Der Parameter FIELDNAME wird lediglich aus Kompatibilitätsgründen unterstützt.
4. Dieser Baustein sollte nicht genutzt werden, um zu einem einzelnen Festwert den Text zu bestimmen. Verwenden Sie hierfür den Funktionsbaustein DDUT_TEXT_FOR_VALUE.
   Dieser Baustein sollte ebenfalls nicht genutzt werden, um Festwerte zu dem Zweck zu lesen, einen gegebenen Wert anschließend gegen diese Festwerte zu prüfen. Verwenden Sie hierfür den Funktionsbaustein DDUT_INPUT_CHECK.
5. Vor Release 4.0 hat dieser Funktionsbaustein, wie auch der veraltete Baustein GET_FIELDTAB, für die Dictionary Datentypen INT1, INT2, INT4 und PREC den falschen ABAP-Datentyp 'X' zurückgegeben. Zu 4.0 liefert dieser Baustein auch für Felder dieser Typen den korrekten ABAP-Datentyp.

Weiterführende Informationen

Parameter

FIELDNAME
LABEL
LANGU
LFIELDNAME
TABNAME

Ausnahmen

INTERNAL_ERROR
NOT_FOUND

Funktionsgruppe

SDIFRUNTIME

RFUMSV00 - Advance Return for Tax on Sales/Purchases   ROGBILLS - Synchronize billing plans  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6350 Date: 20240523 Time: 135310     sap01-206 ( 132 ms )