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.
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
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.
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.
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>
Also note that mapping cannot be changed if the Web Dynpro application is running.
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 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.
sap-wd-clienttrace=5