For SAP applications that can be launched with parameters, the launchpad provides the capability to pass user-specific default values rather than fixed values.
For example, if an application is launched with a parameter that refers to a user-specific default value for "cost center", the application can filter a list according to the cost center of the user who launched the application.
If supported by the applications assigned to users, they can not only enter a single value per parameter, but also sets of values and value ranges.
Target mappings that are shipped by SAP may contain parameters that refer to user-specific default values.
In the launchpad designer, the names of these values look like this:
%%UserDefault.<parameterName>%% for single-value parameters
%%UserDefault.extended.<parameterName>%% for sets of values and value ranges
These parameters enable applications to be launched with user-specific default values rather than fixed values. Users can set their preferred values in the Default Values dialog box. These default values can be overridden, for example if the previous application or the tile that launches the application explicitly passes another value.
Users can access the Default Values dialog box by choosing from the Options menu of the SAP Fiori launchpad.
In this dialog, users see fields for all default values that are used in target mappings assigned to them.
For parameters that support sets of values and value ranges (UserDefaults.extended), the user can enter a primary value directly in the Default Values dialog box, as well as sets of values and value ranges in the Additional Values dialog box. Applications that only accept a single value receive the primary value. Applications that accept sets of values receive a set of values consisting of the primary value and additional values.
SAP application areas, like financials, can provide initial values as well as a value help. The data for the initial values and the value help originate from plug-ins, which are provided by SAP application areas as well.
In the Default Values dialog box, initial values and the value help from the application system are only available if the user is assigned to the respective plug-in for user-specific default values.
SAP application areas provide such plug-ins for the SAP Fiori launchpad. These plug-ins are SAPUI5 components that are instantiated during the startup of the SAP Fiori launchpad.
Plug-ins for parameters referring to user-specific default values are displayed in the launchpad designer as target mappings with the following configuration:
Parameter |
Values |
---|---|
Semantic Object |
Shell |
Action |
plugin |
Parameters |
Name: sap-ushell-plugin-type Value: UserDefaults |
You can assign plug-ins to users via catalogs, just like regular target mappings. For more information, see Activating Plug-Ins on the ABAP Platform.
The plug-ins provided by SAP application areas typically use OData services to get initial values and a value help from the application system. For the initial values and the value help to work, it is important that these services are active and that all relevant users have the required authorizations for using these services. For more information on the required administration tasks, see the documentation for the respective application.