Benannte Includes 

Verwendung

Wird zur Definition einer Datenbanktabelle oder Struktur ein Include verwendet, kann der inkludierten Teilstruktur ein Name zugeordnet werden. Über diesen Namen kann die Gruppe der Felder im Include in ABAP-Programmen als Ganzes angesprochen werden.

Funktionsumfang

In ABAP-Programmen können die Felder entweder direkt über <Tabellen-/Strukturname>-<Feldname> oder analog über <Tabellen-/Strukturname>-<Gruppenname>-<Feldname> angesprochen werden. Auf die Felder der Gruppe als Ganzes kann über <Tabellen-/Strukturname>-<Gruppenname> zugegriffen werden.

Struktur PERSON inkludiert eine Struktur ADDRESS mit dem Namen ADR. ADDRESS hat ein Feld CITY. Sie können über PERSON-ADR auf alle Felder in der Struktur ADDRESS zugreifen. Auf das inkludierte Feld CITY kann dann alternativ über PERSON-CITY oder PERSON-ADR-CITY zugegriffen werden.

Es ist möglich, eine Struktur mehrfach zu inkludieren (z. B. in Periodengruppen). Da hierbei der direkte Zugriff über Feldnamen zulässig bleiben muss, sind die inkludierten Feldnamen aus Eindeutigkeitsgründen umzubenennen.

Hierfür lässt sich jeder Gruppe ein Suffix zuordnen, um das die Namen der Gruppenfelder erweitert werden. Die Felder können dann in ABAP-Programmen über <Tabellen-/Strukturname>-<Feldname (mit Suffix)> oder <Tabellen-/Strukturname>-<Gruppenname>-<Feldname (mit Suffix)> angesprochen werden.

Eine Struktur PERSON inkludiert eine Struktur ADDRESS zweifach. Die erste Adresse ist die Privatadresse mit Suffix H und Namen ADRH. Die andere Adresse ist die Geschäftsadresse mit Suffix W und Namen ADRW. Auf das Feld CITY in der Privatadresse kann dann über PERSON-CITYH oder PERSON-ADRH-CITY zugegriffen werden.

Die Funktionalität der benannten Includes im ABAP Dictionary entspricht dem ABAP-Konstrukt INCLUDE TYPE ... AS ... RENAMING ... .

Sofern Sie den Komponenten einer inkludierten Struktur kein Suffix zuweisen, erfolgt keine Umbenennung. Der zugeordnete Name kann nur zur alternativen Adressierung der Komponenten verwendet werden. Eventuelle Namenskonflikte zwischen den Komponenten inkludierter Strukturen werden nicht aufgelöst, und der zugeordnete Name wird in Anweisungen wie MOVE-CORRESPONDING oder SELECT INTO CORRESPONDING nicht  berücksichtigt. Um eine tatsächliche Umbenennung zu erreichen, müssen Sie ein Suffix zuweisen.