Anfang des Inhaltsbereichs

Funktionsdokumentation Includes  Dokument im Navigationsbaum lokalisieren

Verwendung

Bei Tabellen und Strukturen besteht neben dem Aufzählen der einzelnen Felder auch die Möglichkeit, die Felder aus einer anderen Struktur zu inkludieren. Einzelfelder und Includes können beliebig gemischt werden. Die folgende Abbildung zeigt eine Struktur mit den Feldern F3 und F4, die in eine Tabelle inkludiert ist.

 

Achtung

Die Verwendung von Includes kann zu Namenskonflikten führen, wenn die inkludierten Strukturen oder Tabellen im Nachhinein geändert werden. Sie sollten daher möglichst Teilstrukturen, d.h. Komponenten eines strukturierten Typs, verwenden. Bei Datenbanktabellen, deren Komponenten elementar sein müssen, sollten Sie benannte Includes mit einem Suffix verwenden, um Namenskonflikte zu vermeiden.

 

Diese Grafik wird im zugehörigen Text erklärt

Funktionsumfang

Wird ein Include geändert, so werden alle Tabellen und Strukturen automatisch angepasst, die dieses inkludieren.

Beispiel

Struktur A ist in Tabelle B inkludiert. Wenn Sie ein neues Feld in Struktur A einfügen und dann die Struktur aktivieren, wird Tabelle B entsprechend angepasst, d.h. das neue Feld wird auch in Tabelle B eingefügt.

Sie können einem Include einen Gruppennamen zuordnen, über den die Gruppe der Felder im Include in ABAP-Programmen als Ganzes angesprochen werden kann.

Includes können auch geschachtelt sein, d.h. Struktur A inkludiert Struktur B, die ihrerseits Struktur C inkludiert usw. Die maximale Schachtelungstiefe ist auf neun begrenzt. Ein Pfad von geschachtelten Includes in einer Tabelle bzw. Struktur kann also höchstens die Länge neun haben (die Tabelle/Struktur selbst ist dabei ausgenommen). Dies wird in der folgenden Abbildung erläutert.

Diese Grafik wird im zugehörigen Text erklärt

Achtung

Es können nur flache Strukturen inkludiert werden. In einer flachen Struktur verweist jedes Feld entweder auf ein Datenelement oder ist direkt mit Datentyp, Länge und Dezimalstellen (optional) versehen worden.

In eine Tabelle können nur Strukturen inkludiert werden. In eine Struktur können Tabellen, Strukturen und Views inkludiert werden.

Hinweis

Für die Länge der Feldnamen gilt in Tabellen eine stärkere Einschränkung als in Strukturen. In einer Tabelle darf ein Feldname nur maximal 16 Stellen lang sein, während in einer Struktur 30 Stellen für den Feldnamen erlaubt sind. Eine Struktur kann nur dann in eine Tabelle inkludiert werden, wenn alle Feldnamen in der Struktur maximal 16 Stellen lang sind.

Es kann nur eine Tabelle auf einem Pfad von geschachtelten Includes liegen.

Beispiel

Eine Tabelle TAB1 inkludiert eine Struktur STRUKT1, die ihrerseits wieder eine Struktur STRUKT2 inkludiert. Hier liegt nur die Tabelle TAB1 auf dem Pfad der geschachtelten Includes. Es ist auch möglich, TAB1 in eine weitere Struktur STRUKT0 zu inkludieren. Dagegen kann in TAB1 keine andere Tabelle TAB2 inkludiert werden, da in diesem Fall zwei Tabellen (TAB1 und TAB2) auf einem Pfad von geschachtelten Includes liegen würden.

Weitere Informationen:

Include einfügen

 

 

 

Ende des Inhaltsbereichs