Show TOC Start of Content Area

Background documentation Web Dynpro-Specific URL Parameters  Locate the document in its SAP Library structure

With the URL parameters discussed below, you can influence how the Web Dynpro application is launched from the URL:

      sap-accessibility
This parameter can be used to activate the unrestricted mode. For the value true or X, the settings for the user master record are overwritten and unrestricted mode is activated.

Recommendation

We recommend that you maintain the settings for the unrestricted mode using the SAP User Management Engine (UME) in the user master record.

      sap-cssurl
You can use this parameter to determine the Cascading Style Sheet (CSS) to be used and thus to display the Web Dynpro application in a design that meets your company requirements. The value to be assigned is a URL. Therefore, the CSS to be used has to be stored in a J2EE Engine directory. The default themes that are provided by SAP are located in the following URL:
sap-cssurl=http://<Host-Name>:<Port-Nummer>/webdynpro/resources/sap.com/tc~wd~dispwda/global/SSR/themes/sap_chrome/ur/ur_ie5.css

Recommendation

We also recommend that you save your company-specific CSS in this directory as well.

      sap-locale
You use this parameter to overwrite your language preference settings in the user master record, which is maintained using the User Management Engine (UME). The value to be assigned corresponds to the language ID for the language with which the settings should be overwritten. If the Web Dynpro application does not require user authentication, which is the case when developing applications in particular, you can use it to set the required language preference. The language preference is usually specified by the Web browser’s language setting.
The required language can only be displayed if the corresponding resource bundle is available. Otherwise, the Web Dynpro framework follows a given search mechanism to find the most suitable resource bundle. This search mechanism is described in more detail in
Search Process for Determining the Required Resource Bundle.
The value to be assigned contains a character string with two lowercase letters, which indicate the language, optionally followed by a hyphen or underscore and two uppercase letters, which indicate the country. The abbreviations of language and country in this character string correspond to the default language ID according to ISO standard 639. Various Web sites in the World Wide Web can provide you with information about this ISO standard.

Example

If you want to display the Web Dynpro application currently displayed in English in German instead, you have to assign the value de_DE or de-DE.

      sap-rtl
You use parameter to determine whether the Web Dynpro application is displayed from right to left. The Web Dynpro application is displayed from right to left for the value true or X.

Note

As the Web Dynpro application does not automatically display from right to left, even if the user logged on in Hebrew, for example, then you have to pass this parameter to the application. Only then is the content of the Web Dynpro application displayed from right to left.

      sap-wd-arfc-useSys
You use parameter to map an existing logical system name to another logical system name. This means that you can use this mapping with a single adaptive RFC model to access different backend systems using a single J2EE installation. This mapping is valid for the current application instance only.
When using an adaptive RFC model with which you can access SAP systems, by default two logical system names are created at design time, which are used to configure the JCo destination for the metadata on the one hand, and to change the application data on the other. This default system name has to be configured after deployment using the
Web Dynpro Content Administrator. Each of these logical system names represents a set of configuration data, which contains all relevant informaton required for a JCo connection to an SAP system.
By adding the URL parameter
sap-wd-arfc-useSys, you can map an existing logical system name to a different required logical system name and therefore access one and the same Web Dynpro model in different SAP systems using the adaptive RFC model.
The prerequisite for this is that, in addition to the default JCo connections, you created the new logical system name with the
Web Dynpro Content Administrator and configured it for the required SAP system. The new system names have to have the same names as the system names to which the mapping refers, and may be enhanced with a maximum of three characters.
For the default system name WD_MODELDATA_DEST, the new name could be WD_MODELDATA_DESTSyB, for example, and for WD_RFC_METADATA_DEST the new name could be WD_RFC_METADATA_DESTSyB.
When configuring the two new JCo destinations, ensure that both JCo destinations refer to the same SAP system.
The following applies to the format of the value to be assigned:
sap-wd-arfc-useSys=<default system name>:<suffix of the mapped system>

Note

Also note that mapping cannot be changed if the Web Dynpro application is running.

Example

The URL http://<Host-Name>:<Port-Nummer>/webdynpro/dispatcher/local/Example_Project/Example?sap-wd-arfc-useSys= WD_MODELDATA_DEST:SyB&sap-wd-arfc-useSys=WD_RFC_METADATA_DEST:SyB starts the Web Dynpro application Example and maps the logical system name WD_RFC_METADATA_DEST (default system name that is created at design time when the model is created) to WD_RFC_METADATA_DESTSyB and WD_MODELDATA_DEST (default system name that is created when the model is created at design time) to WD_MODELDATA_DESTSyB. The enhancement SyB represents a different SAP system from the default system.

      sap-wd-client
You use parameter to specify the protocol between the server and the client. You can assign the following values to this parameter:

       HtmlClient
The server provides the Web Dynpro application in HTML format to the client.

       XmlClient
The server provides the Web Dynpro application in XML format to the client.

       WmlClient
The server provides the Web Dynpro application in WML format to the client. The server automatically transfers the Web Dynpro application in this protocol to the mobile end device using the device detection mechanism, which is why this value is only relevant if you want to force displaying the application in a Web browser on an ordinary desktop PC when you develop mobile Web Dynpro applications.

       PieClient
The server provides the Web Dynpro application in a special protocol for displaying the application on mobile devices that support a Pocket Internet Explorer (PIE).  The server automatically transfers the Web Dynpro application in this protocol to the mobile end device using the device detection mechanism, which is why this value is only relevant if you want to force displaying the application in a Web browser on an ordinary desktop PC when you develop mobile Web Dynpro applications.

Note

Note how these values are written (upper/lowercase letters).

      sap-wd-clienttrace
You can use tracing to find out information about the Web Dynpro application’s processing process. If runtime errors occur, you can use it to trace this process and assess it to find errors. The information is displayed in a popup directly in the user interface.
You can use parameter
sap-wd-clienttrace to determine the appropriate trace level. The trace level determines how detailed the information should be displayed when runtime errors occur. Possible trace levels are:

       0 = Switches tracing off

       1 = Displays serious errors, which mean that the application cannot be continued, and errors that may affect the application.

       2 = As 1, but also warnings

       3 = As 2, but also useful notes for users

       4 = As 3 but also additional information can only be interpreted by experienced users and should be used for debugging purposes.

       5 = AS 4 and also displays the current view assembly, its window, user interface elements and so on.

Example

sap-wd-clienttrace=5

End of Content Area