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.
CAUTION: Guiding scripts that interact with and surf over fixed pages are considered legacy functionality. This technique is not supported on top of portal pages and is planned to be deprecated in a future release.

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 Working On A To Do for more information.
IM_​MINIMIZE_​DASHBOARD Pressing this will collapse the sidebar. Note that when a script is finished, it will return the sidebar to the state it was when the script was launched.
IM_​MAXIMIZE_​DASHBOARD Pressing this will expand the sidebar. Note that when a script is finished, it will return the sidebar 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