How To Find The Name Of A Button

This section is only relevant if you are using the legacy capability of BPA scripts to bring a user to a base fixed page and perform functionality by executing existing buttons on that page.

If you want a Press a button step to press a button or click a link in the application toolbar, use one of the following names:

Button Name
IM_GOBACK
IM_HISTORY
IM_GOFORWARD
IM_menuButton

IM_USER_HOME

IM_MY_PREF

IM_helpButton

If you want a Press a button step to press a button in the page actions toolbar, use one of the following names:

Button Name
IM_SAVE
IM_REFRESH
IM_CLEAR
IM_COPY

IM_DELETE

IM_ScrollBack

IM_ScrollForward

The following buttons are also supported:

Button Name	Comments
IM_TO_DO
IM_CurrentTo Do	This navigates to the To Do Entry page for the user's current To Do. Refer to A User's Current To Do for more information.
IM_MINIMIZE_DASHBOARD	Pressing this will collapse the dashboard. Note that when a script is finished, it will return the dashboard to the state it was when the script was launched.
IM_MAXIMIZE_DASHBOARD	Pressing this will expand the dashboard. Note that when a script is finished, it will return the dashboard to the state it was when the script was launched.

Follow these steps to find the name of other buttons that reside in the object display area of a fixed page:

• Navigate to the page in question.

• Right click in the body of the page

• Select Inspect from the pop-up menu.

• In the search look for the text "Widget Info". Note that if there are multiple sections on the page, you will find multiple "Widget Info" results. Based on the details shown, you are able to confirm which section you are looking for.

• Iconized buttons (e.g., search buttons) are represented as HTML images and their field names are prefixed with IM. The following is an example of the HTML on the Algorithm - Main page (notice the IM fields for the iconized buttons).

    * Widget Info:
    *     Widget_ID , Element Type - label info - label
    *     ALG_CD, IT - CI_ALG$ALG_CD -  Algorithm Code
    *     IM_ALG_CD, IM - $SEARCH_FOR_ALG_LBL -  Search for Algorithm
    *     OWNER_FLG, IS - $OWNER_FLG -  Owner
    *     DESCR50, IT - $DESCR50 -  Description
    *     IM_Main_algtypCont, IM - $F1_SHOW_ALG_CTX -  Show Algorithm Context Menu
    *     ALG_TYPE_CD, IT - $ALG_TYPE_CD -  Algorithm Type
    *     IM_ALG_TYPE_CD, IM - $SEARCH_ALGTYPE_LBL -  Search for Algorithm Type

• Transaction-specific actions buttons are represented as switches. The following is an example of the HTML on the Batch Job Submission - Main page (notice the SW fields for the buttons). Note, if you want to Set focus to such a field, you would move a Predefined Value of TRUE to the switch.

* ACTION_Q_SW, BU - $ACTION_Q_SW - Duplicate & Queue
* ACTION_CANCEL_SW, BU - $CANCEL_SW - Cancel

Parent topic

Additional Topics