Overview Page Button Configuration

Use
You can use button configuration as an easy way to create, modify, and delete buttons from the overview
page.

Features
While rendering the overview page, the method IF_BSP_WD_TOOLBAR_CALLBACK~GET_BUTTONS from
the CL_BSP_WD_WINDOW class will check to see if the view controller is implemented. The view
controller is implemented when you have defined the CFG_BUTTONS _MODIFY method, which is
inherited from the CL_BSP_WD_VIEW_CONTROLLER class. If this is the case, the buttons defined in the
BSP configuration will be modified per the logic that you introduced.

You can maintain the following fields for each button:

Field Description
ID The ID of the button to be configured.
Text Use this field to define the text to be displayed on the button.
• You can leave this field blank if you have specified a Type.
• You can specify the alias of an OTR text to render the button
text. For example, you can define Text as
OTR(CRM_BSP_UI_FRAME_BRC/AUTHORIZATION_ROLES).
Tooltip Use this field to define the tooltip for the button.
• You can leave this field blank you have specified a Type.
• You can specify the alias of an OTR text to render the tooltip
text.
Icon Source Use this field to specify the URL of the icon to be displayed. For
example,
/SAP/BC/BSP/SAP/thtmlb_styles/sap_skins/serenity/images/edit.gif.
Type Use this field to define the Type for a predefined standard button, for
example, SAVE or CANCEL. If you have defined a Type, the Text,
Tooltip, and Icon Source fields are automatically populated.
Enabled Use this field to enable or disable the button.
Backend Event Use this field to defines the name of the backend event, that is
triggered when you choose the button.
Frontend Event Use this field to define the JavaScript event handler, that is executed
when you choose the button.

Activities
• To implement button configuration, you must redefine the method CFG_BUTTONS _MODIFY in
the view controller class of the overview page.
• Using the Button Configuration assignment block, you specify the maximum number of visible
buttons and you can view a table showing the buttons that have been defined.
 • You can modify the static configuration depending on runtime information while rendering the
overview page. The method CFG_BUTTONS _MODIFY is called only when there are buttons
defined in the Button Configuration of the overview page in the BSP Workbench.
• When the method CL_BSP_WD_WINDOW-> IF_BSP_WD_TOOLBAR_CALLBACK~GET_BUTTONS is
executed, the call to CFG_BUTTONS _MODIFY is performed, executing the desired logic for the
defined buttons.
1. CFG_BUTTONS _MODIFY: This method has the changing parameter CT_BUTTONS of type
CRMT_THTMLB_BUTTON_EXT_T, which is the tabular version of the button configuration
details. It contains all information required to render the toolbar. It is possible for you to
modify the toolbar data to meet the requirements of the application. This can, for
example, be used to activate and deactivate buttons.
2. CFG_NUM_VISIBLE_BUTTONS_MODIFY: This method has one returning parameter
RV_MAX_BUTTON_NUMBER of type I. The returned value will override the configured
value for Maximum Number of Buttons Displayed.
3. CFG_BUTTONS_IS_ACTIVE: Redefining this method allows you to disable the execution of
the logic for button configuration, instead the buttons of the toolbar will be displayed.

How to distribute button configurations internally

You need to consider that the button configuration has different visibility requirements than the
implementation of the overview page toolbar in the view controller's
IF_BSP_WD_TOOLBAR_CALLBACK~GET_BUTTONS function. This means that a configuration must be
provided for each config key after switching an overview page to button configuration. If this is not done,
the toolbar will not show any buttons. The WCF_DISTR_BTN_CONFIG_INTERNAL report is provided so that
you can distribute the button configuration for a specified view without modifying the view configuration.
What’s New

Overview Page Button Configuration

Use
With this feature, you can define the button configuration of the overview page. You can create,
modify, and delete buttons using the CFG_BUTTONS_MODIFY method.

Technical Details
Product Features are New
Country Dependency Valid for all countries
Software Component Version WEBCUIF
Application Component UI Configuration & Design Layer (CA-WUI-CON)
Available as of SAP Enhancement Package 3 for SAP CRM 7.0 SP14
SAP Enhancement Package 4 for SAP CRM 7.0 SP07