Using Include Objects in Scripts

Usually parts of the scripts in your objects can be reused because they are identical. For this purpose you create Include objects (JOBI), where you store this common code. You can then insert Include objects in the scripts of other objects; this avoids repetitions, minimizes maintenance and facilitates consistency across scripts. This topic describes how to work with scripts in which an Include object has been inserted.

Simply write :INCLUDE or :INC and the name of the Include object in the particular script section in which you want to integrate it. A plus icon is displayed at the beginning of the line. For example:

Click it to open the dialog with the content of the Include object. For example:

The script functions contained in the Include refer to the object in which it has been integrated and not to the Include object itself. For example, the SYS_ACT_ME_NAME script function provides the name of the object where the Include object has been inserted and not the name of the Include object itself.

The code of the Include object cannot be modified here. To edit it, place the cursor anywhere in the name of the Include object and right-click to select Open. This opens its definition pages.

Detaching the Script Editor Dialog

Scripts can be long and complex, containing as many nested Include objects as you need. To keep an overview when writing or modifying them you can open multiple instances of the Script editor dialog and detach them by clicking the button. You can then arrange them on your screen at your convenience.

See also: