Show TOC

Configuring Navigation Parameters with User-Specific Default ValuesLocate this document in the navigation structure

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.

Parameters Referring to User-Specific Default Values in Target Mappings

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.

Default Values Dialog Box

Users can access the Default Values dialog box by choosing Start of the navigation path User Preferences Next navigation step Default Values End of the navigation path 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.

Plug-ins for Parameters Referring to User-Specific Default Values

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.

OData Services

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.