Webclient UI Switch related processing
Do you know the meaning of these two checkboxes in F2 popup?
Let’s first learn some prerequisite knowledge:
In Webclient UI workbench the poweful functionality is provided to ensure that the given feature is only available, if the bound business switch is in active status. For example you can open component BP_HEAD and find many view are added to overview area with a related business switch.
The same logic for navigation link and component usage:
in this blog we have discussed the ui configuration logic and know the customer configuration precedes the sap configuration. After the correct configuration is determined and IF it is sap configuration, framework will load the configuration xml data with the logic below:
1. if pre_proc_active_config_s is X ( we will discuss how this flag is initialized later )
framework will first try to load configuration data from table BSP_DL_XMLST_PR( Processed Standard Configuration for switch related handling ), if nothing found, then try BSP_DL_XMLSTRX2 instead ( Storagetable for delivered XML layout descriptions ).
For customer configuration, the configuration data is always loaded from table BSP_DL_XMLSTRX2.
In order to verify the described process above, I create a simple component with one overview page which contains only one assignment block which are bound to a business switch. The switch is set as deactivated.
Then I launch the UI. Since it is the first time the UI is accessed, it is apprarently that no entry for ZSWITCH in table BSP_DL_XMLST_PR,
so data is fetched from BSP_DL_XMLSTRX2 instead. BSP_DL_XMLSTRX2 stores configuration data which does not take switch handling into consideration.
After that, framework will try switch handling centrally in method DO_SWITCH_REL_HANDLING_RT:
In this method, you can find the processor for each type of switch related handling. In my example ( overview page) it is CL_BSP_DLC_LIST_BASED:
The switch handling is done by the processor method PROCESS_CONFIG_XML:
The assignment block view is considered as inactive due to the deactivated switch, however it is put to , so the ev_changed is set to X ( the checkbox Changed by Switch processing in F2 )
Finally the switch processing result is persisted to table BSP_DL_XMLSTRX2. So when the UI is reopened next time, the stored entry will be fetched instead.
When is pre_proc_active_config_s set to X
it is controlled by CL_BSP_DLC_CONFIGURATION2=>SWITCH_PROC_ACTIVE_CONFIG_S but could be deactivated via user parameter BSP_DLC_SWITCH_PROC.
CL_BSP_DLC_CONFIGURATION2=>SWITCH_PROC_ACTIVE_CONFIG_S will by default only be set to X if current system is set up as customer system.
You could also set value VDTVRT to the user parameter, then UI framework will raise a notification message for you once the switch related handling is detected:
The corresponding logic could be found in method below:
Thank you for Master Wang ,this is the one that I want to look for 😆 .
thanks, Jerry. Great documents. But one question, how is one entry be added into table BSP_DL_XMLST_PR then? If one is making personalization, the entry should be created in personalization tables. How one configuration be added into table BSP_DL_XMLST_PR? I encounter one issue, the page itself seems no switch used, but there is one entry in table BSP_DL_XMLST_PR, how could that happen? The view is CRM_BSP_PERS/GenSettings, it is the personalization popup, which does not have personalization button at all.
and note 1472310 the report BSP_DLC_ADMIN_CONFIG_PRE_PROC might be related to this topic, which is clearing the table BSP_DL_XMLST_PR.
Thank you for Master Wang,would you like to sharing a customizing case which manifests the advantage of Switch.