Connection Macros

Program objects that are executed as methods have two macros available when launched from a Navigator window.

Connection Macros
Macro Meaning

CONNECTIONID

The relationship ID of the connection next to the selected child business object in the Navigator browser.

CONNECTIONDIRECTION

The relationship direction (to or from) of the connection next to the selected child business object in the Navigator browser.

The connection macros are available only when the program is launched as a method from an object displayed in a Navigator window AND if the object is not the expanded object. Both macros will be empty if:


  • no connection is displayed, as in the case when the selected business object is in a flat browser;
  • more than one connection is shown, as when the selected object is in the center of a star browser or at the top of an indented browser.

In some cases the macros will not even be placed in the RPE. This situation occurs when a method is invoked programmatically (either from a program object or interactive MQL) or if a program is not executed as a method (i.e. from the toolbar).

Most programs that use a connection have access to the following:.

Connection Identification Macros
Macro Meaning

RELID

The system generated numerical identification of the connection

ISFROZEN

Boolean

Similarly, when used in the context of a connection, programs can access the following macros to identify objects on the ends of the relationship:

From Connection Macros
Macro Meaning

FROMOBJECTID

Object Identifier of Connection on "from" end of connection

FROMISFROZEN

FROMISRELATIONSHIP

To Connection Macros
Macro Meaning

TOOBJECTID

Object Identifiers of Connection on "to" end of connection

TOISFROZEN

TOISRELATIONSHIP