Ansicht
Dokumentation
ABAPINCLUDE_PROG - INCLUDE PROG
General Data in Customer Master CPI1466 during BackupDiese Dokumentation steht unter dem Copyright der SAP AG.
INCLUDE
INCLUDE incl $[IF FOUND$].
Zusatz:
Wirkung
Die Anweisung INCLUDE bindet das Include-Programm incl an dieser Stelle des Quelltexts ein. Bei der Syntaxprüfung und der Generierung des Programms durch den ABAP Compiler wird die Anweisung durch den Quelltext des Include-Programms ersetzt. Das eingebundene INCLUDE-Programm muss aus vollständigen Anweisungen bestehen.
Wenn das angegebene Include-Programm nicht existiert, ist das Programm syntaktisch nicht korrekt und kann nicht ausgeführt werden. Diese Fehlersituation kann durch Angabe des Zusatzes IF FOUND unterdrückt werden.
Hinweise
- Die Anweisung INCLUDE ist die einzige Anweisung, die statt einer programmeinleitenden Anweisung an der ersten Position eines Programms stehen kann. Voraussetzung ist, dass nach der Auflösung des Include-Programms eine programmeinleitende Anweisung am Anfang des einbindenden Programms steht.
- Die ABAP Workbench unterstützt die automatische Erstellung von Include-Programmen für bestimmte Programmteile, wie z.B. das Top-Include für globale deklarative Anweisungen. Verwenden Sie immer die von der ABAP Workbench vorgeschlagenen Namenskonventionen. Das Top-Include darf nur deklarative Anweisungen enthalten und wird bei der Kompilation einzelner Include-Programme eines Programms berücksichtigt.
- Im Repository
Browser des Object Navigators der ABAP Workbench werden die von einem Programm eingebundenen INCLUDE-Programme als dessen Unterknoten aufgeführt.
Zusatz
... IF FOUND
Wirkung
Der Zusatz IF FOUND bewirkt, dass das angegebene Include-Programm nur dann eingebunden wird, wenn es vorhanden ist. Ist das Include-Programm nicht vorhanden, wird die INCLUDE-Anweisung ignoriert und es kommt an dieser Stelle zu keinem Syntaxfehler.
Hinweis
Wenn der Zusatz IF FOUND angegeben ist, sollte das einbindende Programm nicht vom Quelltext
des Include-Programms abhängig sein. Ansonsten kann es in Systemen, in denen das Include-Programm vorhanden ist, syntaktisch korrekt und in anderen Systemen syntaktisch inkorrekt sein.
Beispiel
Diese Zeilen zeigen das Rahmenprogramm der Funktionsgruppe ABAP_DOCU, die in SAP GUI die ABAP-Schlüsselwortdokumentation darstellt. Es enthält ausschließlich INCLUDE-Anweisungen, die den eigentlichen Quelltext einbinden, wobei labap_docutop selbst wieder aus Include-Programmen für die einzelnen Deklarationen (globale Daten und programmlokale Klassendeklarationen) aufgebaut ist.
*&----------------------------------------------------------------*
*& Function Pool SAPLABAP_DOCU
*&----------------------------------------------------------------*
INCLUDE labap_docutop.
" Global Declarations
INCLUDE labap_docue00. " Load of Program
INCLUDE labap_docuuxx. " Function Modules
INCLUDE labap_docuo01. " PBO Modules
INCLUDE labap_docui01. " PAI Modules
INCLUDE labap_docue01. " Handling of Runtime-Events
INCLUDE labap_docup01. " Class implementations
INCLUDE labap_docup02.
INCLUDE labap_docup03.
INCLUDE labap_docup04.
INCLUDE labap_docut99. " Unit tests
PERFORM Short Reference Fill RESBD Structure from EBP Component Structure
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 5922 Date: 20240329 Time: 093741 sap01-206 ( 79 ms )