Object IDs

Each object within a SAPGUI application is identified by a unique ID, which contains the ID information of the complete object hierarchy, beginning with the application object itself. The IDs of the objects in the hierarchy are separated by forward slashes ("/") where the application object itself begins with a forward slash.
Object ID Description
SAP Application The application's ID is /app.
SAP Connection A connection's partial ID is con[X], where X is the index of the connection. The index is required when there are multiple objects with the same base ID. The index is 0-based.

Example: /app/con[0]

SAP Session The session's partial ID is ses[X], where X is the index of the session within the current connection.

Example: /app/con[0]/ses[0]

SAP Window or Dialog The window's partial ID is wnd[X], where X is the index of the window within the current session.

Example: /app/con[0]/ses[0]/wnd[0]

SAP User Area The ID of the user area is usr. As there is only one user area per window, there is no need for an index here.

Example: /app/con[0]/ses[0]/wnd[0]/usr

SAP Title Bar The ID of the title bar is titl. It is a child of a window or dialog.

Example: /app/con[0]/ses[0]/wnd[0]/titl

SAP Tool Bar The partial ID is tbar[X]. There can be up to two tool bars on a window and therefore the index is needed.

Example: /app/con[0]/ses[0]/wnd[0]/tbar[0]

SAP Status Bar The ID of the status bar is sbar. As there is only one status bar per window, there is no need for an index here.

Example: /app/con[0]/ses[0]/wnd[0]/sbar

Other Controls Certain control types have special ID prefixes (for example, lbl for labels and txt for text controls). Following the prefix, controls have a programmatical name (for example, RSYST-BCODE).

Controls that are listed in a table format can have multi-dimensional indices, similar to the indices shown above for sessions, connections, etc.

A multi-dimensional index is defined as controlid[X,Y].

Examples:

/app/con[0]/ses[0]/wnd[0]/usr/txtRSYST-BCODE

/app/con[0]/ses[0]/wnd[0]/usr/sub:SAPMSYST:0020/txtINFO-TABTDLINE[0,0]

/app/con[0]/ses[0]/wnd[0]/tbar[0]/btn[0]