Show TOC

Application Parameters and URL ParametersLocate this document in the navigation structure

Use

You can control the Web Dynpro ABAP runtime or the Web Dynpro ABAP application by inserting the URL query string parameter into the request URL. To do this, you simply extend the URL in the browser:

        
<scheme>://<host>.<domain>.<extension>:<port>/sap/bc/webdynpro/<namespace>/<application name>?<parameter name>=<parameter value>
         
Example

http://us7211.wdf.sap.corp:50021/sap/bc/webdynpro/sap/demo_table?sap-language=EN

Parameter names and parameter values are not case sensitive (exception: sap-exiturl, if a server is linked that does differentiate between upper and lowercase). You can combine several parameters in one URL.

Caution

Be aware of the security issues relating to URL and application parameters. For more information, see Data Security in Web Applications.

Setting Parameters

You can set URL and application parameters in the following places:

  • In the Web Dynpro application (in transaction SE80 in the Web Dynpro explorer for the application on the Parameters tab page).

    You can either define new parameters or select a predefined parameter and assign a value to it.

  • In the application configuration (Web Dynpro application CONFIGURE_APPLICATION, tab Parameter).

  • Globally for all applications and a specific client using Web Dynpro application: WD_GLOBAL_SETTING

    Call Web Dynpro ABAP application WD_GLOBAL_SETTING, and enter the value you want the parameter to be for all applications.

  • For the user and all applications (with user parameters – only possible for a few parameters).

  • For the current call (as a URL parameter – in this case, the parameter names are not case-sensitive).

Various applications parameters

Application Parameters/

URL Parameter

Possible Values

Description

WDACCESSIBILITY /

SAP-ACCESSIBILITY

  • No value specified

  • X

Activates Accessibility support.

This parameter can be activated in all of the places named above. OR logic is used (the parameter can be activated in one place). This parameter is normally either defined on a user-specific basis or specified for test purposes in the URL.

Name of the user parameter: ACCESSIBILITY_MODE

Specifies which screen reader support is used.

  • No value specified:

    ARIA-compatible role attributes (landmarks) are used. GET_ACCESSIBILITY( ) API returns value ABAP_FALSE.

  • X:

    SAP's own support for screen readers This setting is recommended for optimal support. GET_ACCESSIBILITY( ) API returns value ABAP_FALSE.

    ARIA-compatible support for screen readers in compliance with W3C ARIA standard. The controls are described with ARIA attributes. GET_ACCESSIBILITY( ) API returns value ABAP_FALSE.

WDACCESSIBILITYMODE/

SAP-ACCESSIBILITYMODE

  • No value specified

  • CLASSIC (default value)

  • ARIA

Specifies which screen reader support is used.

  • No value specified:

    ARIA-compatible role attributes (landmarks) are used. GET_ACCESSIBILITY( ) API returns value ABAP_FALSE.

  • CLASSIC:

    SAP's own support for screen readers This setting is recommended for optimal support. GET_ACCESSIBILITY( ) API returns value ABAP_FALSE.

  • ARIA:

    ARIA-compatible support for screen readers in compliance with W3C ARIA standard. The controls are described with ARIA attributes. GET_ACCESSIBILITY( ) API returns value ABAP_FALSE.

WDALLOWUSERAGENTS /

-

  • TOLERATED (default value)

  • SUPPORTED

Specifies in which browsers Web Dynpro applications can be run.

  • TOLERATED:

    Users can also run Web Dynpro applications in browsers that are supported by Unified Rendering browser recognition even if these browsers are not supported by SAP in accordance with the Product Availability Matrix (PAM).

  • SUPPORTED:

    To specify that Web Dynpro applications can only be run exclusively in SAP-supported browsers (in accordance with PAM), you set the parameter to value supported.

For more information, see Changing the Default Browser Detection.

WDALLOWMULTIPLEACTIONS /

WDALLOWMULTIPLEACTIONS

  • X (default value)

  • No value specified

Specifies that more than one action per roundtrip can be processed. For more information see Multiple Actions per Roundtrip in Phase Model.

WDALLOWQUICKVIEWS /

-

  • X (default value)

  • No value specified

Specifies whether quick views are to be available or not.

The parameter cannot be forwarded as a URL parameter. Administrators can set this parameter as an application parameter in the global settings.

The application can use IF_WD_APPLICATION->GET_QUICKVIEWS_ALLOWED() to import the parameter during runtime.

Note

If the application is running in accessibility mode, the result is always abap_false because quick views cannot be displayed in this mode.

WDALLOWVALUESUGGEST /

WDALLOWVALUESUGGEST

  • ON (default value)

  • OFF

  • No value specified

Activates and deactivates the function for Suggested Values for Input Fields.

WDDELTARENDERING /

SAP-WD-DELTARENDERING

  • ON (default value)

  • OFF

  • No value specified

View-based Delta Rendering.

For many applications, it has proven sensible to only send changed views to the client. However, this makes it more difficult to detect changes and to perform tests since the application must be completely tested with delta rendering active. Typically, this parameter is set in the application. However, it sometimes makes sense to set the URL parameter for test purposes. If the context changes are to be traced (in WD_TRACE_TOOL), you have to set this parameter.

WDDISABLEDYNAMICRESOURCESDN /

-

  • X

  • No specification (default value)

Download options suppressed with UI element FileDownload, function AttachFileToResponse, and all active components (e.g. OfficeIntegration, GANTT). For more information, see Security Notes for Downloading Files.

WDENABLEFIELDHISTORY /

-

  • X (default value)

  • No value specified

Activates or deactivates the history of an input field, either system-wide or for individual Web Dynpro applications. For more information, see Suggested Values for Input Fields.

WDENABLEXBCMLCLIENT /

-

  • X

  • No specification (default value)

Activates eCATT rendering for a client or application. For more information about eCATT, see Extended Computer Aided Test Tool. For information about eCATT and Web Dynpro ABAP see eCATT and Web Dynpro ABAP.

WDFAVICON /

-

  • Relative URL to favicon on the server

Enables a favorites icon (favicon) to be displayed on the left of the URL in the address line of a browser (see figure).

The parameter can be implemented at the following levels:

  • Client

  • Application

  • Application configuration

  • Application customizing

The value of the parameter is the relative URL to the favicon on the server. The data type of the favicon must be .ico.

Note

If no value is specified, the SAP favicon is displayed (see figure). If no favicon is to be displayed, set parameter about: blank.

WDHELPCENTERDISPLAY /

-

  • NEW_WINDOW (default value)

  • SIDE_PANEL

Display mode for the Help Center for Web Dynpro ABAP applications. See also Utilizing the Help Center for Applications in SAP Business Suite, Making the Help Center Available for SAP Applications and Activating Help Center and Selecting Display Mode.

With the standard setting the application Help Center opens in a separate browser window. If you want to display the Help Center in the side panel of the Web Dynpro application, use the value SIDE_PANEL. If the Web Dynpro window has sufficient space, the Help Center is displayed in the side panel of the application, if not, the standard setting applies.

WDHIDEMOREFIELDHELPASDEFAULT /

-

  • X

  • No value specified

The extended help display is deactivated by default. For selected individual fields you can reactivate the F1 help; see also Property Explanation.

WDLIGHTSPEED /

SAP-WD-LIGHTSPEED

  • X (default value)

  • No value specified

The standard system has new Rendering Technology activated.

The new rendering technology can be activated and deactivated for each client, in each application or in the URL. A distinction is made between the parameter being there but with an empty value (classic rendering is used), and the parameter not being there (the default value is used).

WDPREFERREDRENDERING /

-

  • STANDARDS (default value)

  • QUIRKS

  • STAND_ONLY

Define preferred HTML rendering mode.

  • STANDARDS:

    Starts the application in W3C standards mode (DOCTYPE HTML), provided the rendering engine supports standards mode.

    The STANDARDS value is effective in Internet Explorer 9 and higher Internet Explorer versions, and in Firefox, Safari, and Chrome. Older Internet Explorer versions are rendered always in quirks mode.

  • QUIRKS:

    Starts the application in quirks mode, provided the rendering engine supports quirks mode. If it does not, the standards mode is used.

  • STAND_ONLY

    Forces the use of the standard mode for HTML rendering and results in the application terminating for all browsers that do not support this mode (e.g. Internet Explorer earlier than Version 9).

For more information, see UI Control Rendering in Standards Mode, and SAP Note 1753544 Information published on SAP site.

Note In addition to application parameter WDPREFERREDRENDERING URL parameter sap-wd-htmlrendermode is also available. Note that this URL parameter can only be used internally at SAP.

WDREFFIELDBEHAVIOUR /

-

  • 0 (default value)

  • 1

Converting Currency Amounts.

  • 0 (default value):

    If the application parameter is set to 0, the internal value of the referenced field is not changed.

  • 1:

    If the parameter is set to 1, the position of the decimal point in the referenced field remains unchanged.

WDREMOTEDESKTOP /

SAP-WD-REMOTEDESKTOP

  • X

  • No value specified

Optimization for remote desktops (Windows Terminal Server). This switch deactivates the greying out of the background in popups.

WDPROTECTEDAPPLICATION /

-

  • X

  • No value specified

Isolates / protects the application on the client. Specifies that the application should run with the SSL (HTTPS) protocol and that no scripting between the portal and the application is allowed.

Note that when you set this parameter Portal Integration can no longer function without restrictions. Portal eventing will not work anymore. Session handling is also affected (navigating away from iView or closing the browser), as is the work protection mode.

Note also that UI element BIApplicationFrame does not work properly if you use this parameter.

See also Web Applications Without Domain Relaxing.

WDSHAREDREPOSITORY/

-

  • X

  • No value specified

Specifies that the metadata belonging to an application is loaded into the shared memory. This can lead to memory performance problems.

When using this parameter, make sure that the shared memory is large enough.

WDUSESIGNEDAPPLETS/

-

  • CLIENTINFO (default value)
  • SIGNED

UNSIGNED

You use this parameter to specify whether the signed or unsigned Applet version of UI elements Gantt and Network is to be used.
  • CLIENTINFO:
    The Applet version to be used is selected depending on the version of the installed Java plug-in:
    • Java version smaller than or equal to 6: The unsigned version of the Applet is used.
    • Java version greater than or equal to 7: The signed version of the Applet is used.
  • SIGNED:

    The signed version of the Applet is always used.

  • UNSIGNED:

    The unsigned version of the Applet is always used.

For more information, see SAP Note 1925833 Information published on SAP site, Gantt, and Network.

- /

SAP-WD-FLASHDEBUG

  • X (default value)

  • No value specified

This parameter is needed to debug a FlashIsland application. If the Web Dynpro application is openede with URL parameter SAP-WD-FLASHDEBUG=X, the debug file is automatically used instead of the .swf file for the FlashIsland.

-/

SAP-WD-LOADONDEMAND

  • X (default value)

  • No value specified

The JavaScript sources for individual Web Dynpro ABAP UI elements are first loaded by default from the ABAP server and cached in the browser when they are needed for the first time. This saves resources because the smallest amount of JavaScript code is loaded from the browser and cached.

In some cases this behavior is not wanted or necessary. If SAP-WD-LOADONDEMAND is not activated, all JavaScript sources are packed in a file and sent to the browser. The amount of JavaScript code to be cached is much greater in this case but also no longer needs to be loaded.

-/

SAP-WD-SILVERLIGHTDEBUG

  • X

  • No value specified

This parameter is needed to debug a Silverlight application. If the Web Dynpro application is openede with URL parameter SAP-WD-SILVERLIGHTDEBUG=X, the debug file is automatically used instead of the .swf file for the SilverlightIsland.

-/

SAP-WD-STABLEIDS

  • X

  • No value specified

Provides stable view element adapter IDs, which are required for tools for automatic testing (e.g. Web Dynpro ABAP unit test framework, eCATT).

To display the view element adapter IDs, call technical from the running application, and navigate to the View Element Adapter tab. The IDs are listed in theView Element Adapter IDs column.

Name of the user parameter:

WD_STABLE_ID_F_TEST

The user parameter does not work in productive operation.

-/

SAP-WD-SUPPRESSCUSTOMHTML

  • X
  • No value specified

With this parameter, you control whether HTML is suppressed, which was specified with an HTMLIsland, HTMLContainer, or HTMLFragment. You can use the parameter to check whether an error due to incorrect customer-defined HTML occurs.

Application Parameters for Web Dynpro Adaptations

An application parameter is provided in the context of the Web Dynpro ABAP configuration framework:

See also: Web Dynpro ABAP Configuration Framework

Application Parameter

Possible Values

Description

WDDISABLEUSERPERSONALIZATION

  • X

  • No value specified

Suppresses the implicit personalization options.

More information: Personalization and Customizing

WDENABLEUIELEMENTSHIDE

  • X (default value)

  • No value specified

Suppresses the option to hide a UI element from the context menu.

Remember that if this feature is activated or deactivated, the function "Restore All Changes" is also activated or deactivated.

The setting does not affect the personalization of UI element Table.

Application Parameters for Design Settings

Application Parameter/

URL Parameter

Possible Values

Description

WDFORCEEXTERNALSTYLESHEET /

-

  • X

  • No value specified

URL parameter WDFORCEEXTERNALSTYLESHEET has been replaced with parameter WDUSEEXTERNALSTYLESHEET. For compatibility reasons, the WDFORCEEXTERNALSTYLESHEET switch is still evaluated. The default value WDUSEEXTERNALSTYLESHEET=ON must be set. For more information, see the description of parameter WDUSEEXTERNALSTYLESHEET.

WDSTYLE_LABELALIGNMENT /

WDSTYLE-LABELALIGNMENT

  • USEGL (default value)

  • LEFT

  • RIGHT

  • No value specified

Controlling alignment of .Label.

Value USEGLmeans that all Labels are right-aligned if WDUIGUIDELINE=GL20 is set. All Labels are left-aligned, if WDUIGUIDELINE=GL11 is set.

LEFT means that allLabels are left-aligned. Default value RIGHT means that all Labels are right-aligned. If Label.width is set to initial, it is displayed with 100% width.

Note

You can also set the parameter to RIGHT if you are using RTL as the read direction (URL parameter sap-rtl=X). Note that this is possible with GridLayout and MatrixLayout, but not with FlowLayout.

Activating right-aligned Labels can make the layout worse. In this case reset the width of the Label, and make changes to the layout.

WDSTYLE_TOOLBARDESIGN

/

WDSTYLE-TOOLBARDESIGN

  • FLAT (default value)

  • HIGH

This parameter changes the appearance of ToolBarButton, ToolBarButtonChoice, ToolBarToggleButton in a ToolBar with property ToolBar.design=standard.

Value FLAT means that the specified ToolBar UI elements are displayed with no highlighting, like text in theToolBar. Value HIGH means that ToolBarUI elements are displayed exactly like normal Buttons.

Note

This application parameter only has an effect if ToolBar.design=standard.

How the elements are shown on the UI also depends on the selected theme.

WDTHEMEROOT /

SAP-THEME

  • sap_bluecrystal
  • sap_chrome

  • sap_corbu (default value)

  • sap_hcb

  • sap_standard

  • sap_tradeshow

  • sap_tradeshow_plus

Stylesheets for the application without portal integration. You can import user-configured stylesheets with report WD_THEMES.

See also Stylesheets in Web Dynpro ABAP.

WDUIGUIDELINE /

WDUIGUIDELINE

  • GL20 (default value)

  • GL11

Classic or new behavior in visualization, filtering, sorting, and selecting. Siehe auch:

Default value GL20 differs widely in the UI and in the behavior of some UI elements.

  • The red star for visualizing the state property with value required is always rendered on the left side of the Label. See also Truncating Contents in the FormLayout.

  • With drag & drop in MatrixLayout and GridLayout visualization has been changed slightly: The insert selection is now a dashed line specifying the insert position and no longer a box with the dimensions of the dragged object.

For more information, see 1875625 Information published on SAP site.

WDUSEANIMATION /

SAP-LS-USEANIMATION

  • X (default value)

  • No value specified

If the WDLIGHTSPEED parameter is active, this parameter (active by default) renders show and hide effects, for instance, for popups. You can deactivate this parameter if required for system performance.

Name of the user parameter: WDUSEANIMATION

WDUSEEXTERNALSTYLESHEET /

-

  • ON (default value)

  • OFF

  • FORCE

Web Dynpro applications use style sheets transferred by a portal or NWBC (URL parameters sap-ep-themeroot, sap-cssurl), provided the version of the stylesheet is new enough. If the version is too old, a fallback mechanism is executed. This avoids unattractive rendering and JavaScript errors. However, bear in mind that any customer branding can get lost. It is also possible to transfer a stylesheet installed on the SAP system using URL parameter sap-theme

With parameter WDUSEEXTERNALSTYLESHEET you can influence how information from external stylesheets is used.

  • WDUSEEXTERNALSTYLESHEET=ON: External style sheets are used.

    This is the default setting. The mechanism described above is activated. External stylesheet information is evaluated.

  • WDUSEEXTERNALSTYLESHEET=FORCE: Obsolete external style sheets are also used.

    This setting is the same as the default setting but with one difference: The external stylesheet will be used if the version synchronization fails. Bear in mind that this could result in unattractive rendering and JavaScript errors.

    Note

    Running a Web Dynpro application with this setting is done at your own risk. SAP Support does not provide any help or corrections for Web Dynpro applications that are operated with this setting.

  • WDUSEEXTERNALSTYLESHEET=OFF: External style sheets are ignored.

    With this setting stylesheet information passed with this URL is ignored. This means that URL parameters sap-ep-themeroot, sap-cssurl, and sap-theme are ignored. Application parameter WDTHEMEROOT, which corresponds to URL parameter sap-theme in the application, can still be set client-wide and application-wide.

URL parameter WDFORCEEXTERNALSTYLESHEET has been replaced with this new parameter WDUSEEXTERNALSTYLESHEET. For compatibility reasons, the WDFORCEEXTERNALSTYLESHEET switch is still evaluated. The default value WDUSEEXTERNALSTYLESHEET=ON must be set.

For more information, see SAP Note 1679127 Information published on SAP site..

Application Parameters for the Side Panel

The following application parameters are available in the Page Builder and side panel framework.

Application Parameter

Possible Values

Description

WDSIDEPANELCONFIGURATIONID

<configuration id>

Configuration ID of the Web Dynpro component WDR_CHIP_PAGE of type SIDEPANEL. This configuration determines the content of the side panel.

WDSIDEPANELOPEN

  • X

  • No value specified

Specifies whether the side panel is opened or not when the program is started.

WDSIDEPANELRESIZABLE

  • X (default value)

  • No value specified

Specifies whether the width of the side panel can be changed by the user or not. If the width can be changed, the side panel is separated from the main application by a splitter control.

WDSIDEPANELREMOTEPRODUCER

  • X

  • No specification (default value)

Enables sending of tagging data from a Web Dynpro application running in the NWBC content area.

WDSIDEPANELREMOTECONSUMER

  • X

  • No specification (default value)

Enables receipt of tagging data in the NWBC side panel (for example, for Page Builder or FPM applications running in the side panel).

Local Application Parameters

You can only set the following application parameters locally for individual applications, and not globally for all applications.

Application Parameter/

URL Parameter

Possible Values

Description

WDCONFIGURATIONID /

SAP-WD-CONFIGID

<config id>

Configuration ID of the Application Configuration. Passes the ID of the application configuration. Typically, this ID is specified either in the application (various applications are defined for the use of various application configurations) or is defined from the portal as a parameter in the iView.

WDSUPPORTSFULLHEIGHT /

SAP-WD-SUPPORTSFULLHEIGHT

  • 0

  • 1

  • 2

  • 3

Web Dynpro application developers must decide whether applications are to always take up the maximum height or not. Depending on your requirements you set this application to one of the following values:

  • 0 (default value)

    If this parameter has value 0, the framework sets the value to 1 in a portal environment, and to 2 in a stand-alone environment. This is the correct value for the majority of applications. This ensures that the automatic height adjustment of the iView is supported in the Portal, and in the stand-alone case the application takes on the full height of the browser window.

  • 1

    If this parameter is set to 1, the application does not extend to the full height of the browser. This is the correct setting if applications are running in an iView with automatic height adjustment. If not, UI elements with 100% height are not necessarily displayed in their full size. Some UI elements (for example, InteractiveForm) may not be displayed correctly in Firefox.

  • 2

    If this parameter is set to 2, the application can use the full 100% height of the browser. This will avoid any problems with Firefox. It is best though not to use any such applications in iViews with automatic height adjustment, since these can appear overstretched in the Enterprise Portal. To set an application to 100% height, you have to observe the following rules when setting application parameter WDSUPPORTSFULLHEIGHT:

    • The height of container-type UI elements (for example, TransparentContainer, Group, Tray, etc.) must be set to 100%. This applies particularly to ROOTUIELEMENTCONTAINER.

    • Only layouts of type MatrixLayout oder GridLayout are allowed to be used. Toggle the stretchedVertically flag to true.

    • Property vAlign for all instances of GridData and Matrix(Head)Data must be set to top.

  • 3

    If this parameter is set to 3, the framework uses the full height, without a scrollbar. With a value of 3 this parameter behaves as with 2, but with no scrollbar. Content that is too long is cut off. Use the parameter with value 3 if you create a page that uses 100% of the width and height, and has its own containers with scrollbars. This means that the application itself takes care of the scrolling behavior.

See also SAP Note .1266588 Information published on SAP site.

Order of Evaluation

The setting options are evaluated in the order below:

  1. In the parameters determined by the URL

  2. The standard parameters defined for the Web Dynpro application

A URL parameter always overrides an application parameter.

The logon language is determined or proposed from the sources listed below: These sources are evaluated in the order below whereby the first in the list is the decisive source.

  1. URL parameter sap-language.

  2. Default language in the setting for the System Logon for the Configuration Settings

  3. Web browser languages (Accept-Language)

  4. Default language of ABAP system

Note

The language from the user account is not evaluated in the ABAP system.

The language you want must have been installed in your system.