Finding Control IDs

A control ID is a number that uniquely identifies a field, such as a button, within a window. Many script commands related to logging in to Windows applications require a control ID.

To help you determine these control IDs, SecureLogin includes a tool called Window Finder. This tool displays information about a control that you have selected.

To inspect a control:

  1. Click Start > Programs > Novell SecureLogin > Window Finder.

  2. Right-click the SecureLogin icon and drag it over the control of interest.

    The Window Finder tool displays the details of the control.

    If an application page hides the Window Finder, click the WinSSO Window Finder icon on the system tray.


The SecureLogin Window Finder

The following table provides information on fields in the dialog box:

Field Description

Module Name

The name of the executable that created the window. Use this name for the application name of the Windows single sign-on script.

Command Line

The path to the module or executable.

Window Title

The title of the window that contains the control. You can use this title in a window or title statement.

Window Class

A field for information only. Each window has a class associated with it.

Handle

The handle of the parent window.

Dialog ID (Control ID)

A unique identifier. Each control has a unique identifier, called the control ID. Use this number as the target for Type, Click, Ctrl, and SetPlat statements. For information on each of these commands, see SecureLogin Commands.

Class Name

A name that determines the type of the control. For single sign-on to work correctly, the SecureLogin Windows component must be able to read and write text to the specified control. The class name determines the type of the control and whether reading and writing is possible. Supported classes include edit, combobox, and static.

Window Text

A field that displays the text contained within the control. This information can be useful in troubleshooting and for writing the regular expression required by the Setplat command.

Handle

The handle of the control window.