Show TOC Start of Content Area

Process documentation Configuring the Web Dynpro Runtime Environment  Locate the document in its SAP Library structure

Purpose

You can manipulate the behavior of the Web Dynpro system configuration using specific settings. The archive file WebDynpro.wda contains the system configuration, is part of the ear. file sap.com/tc~wd~dispwda.ear, and is automatically deployed to the SAP NetWeaver Application Server.

Process Flow

To configure some basic settings of the Web Dynpro runtime environment in file default.properties, the system administrator defines system configuration properties using the SAP NetWeaver Administrator.

Parameter Description

Overview of the parameters

Parameter and Description

Value Required

Valid Values

AccessibilityChecksEnabled
If the parameter for checking accessibility is set to false, the relevant checks are not possible.

No

boolean

ActivateURLParameters
If the value is false, the Web Dynpro runtime environment ignores several URL parameters. You can deactivate URL parameters that are not available in the production mode using ActivateURLParameters. For example, the URL parameters sap.csf and sap.session.plugin are ignored.

No

boolean

AllowUserPersonalization
Enables the end user to implicitly configure the Web Dynpro interface – for example, adapt fields or tables without modification.

No

boolean

DefaultExpirationTime
Specifies the expiration time in seconds when no user interaction takes place. The default value is used if no other expiration time was defined for a Web Dynpro application.

No

Any positive integer

DefaultServerSessionAtLeastOneAppScopeExpirationTime
Defines the time interval (in seconds) until the data is removed from the cache after the last application of a server session or a user was ended. If a new application is started within this time, the data is not removed.

No

Any positive integer

DevelopmentMode
Specifies whether or not the Web Dynpro runtime environment runs in a development session. This can affect the display of error messages. For example, the error message page provides detailed information about the product/version, the protocol, and the stack trace when the Web Dynpro runtime environment runs in a development session. For productive use the DevelopmentMode has to be set to false for security reasons.

No

boolean

DuplicateNameCheckEnabled
Checks enabled/disabled status for duplicate VMO name during deployment.

 

boolean

IGSUrl
Specifies the Web address of the Internet Graphics Service (IGS) valid for the application. This service supports the display of the UI elements BusinessGraphics und GeoMap..

No

Any valid, absolute Web address.

ValidateByRendering
For the Web Dynpro application to be able to handle the errors caused during data retrieval, the Web Dynpro runtime executes the request for each data set before the call of the wdDoPostProcessing() method. In this context, the request process is referred to as validation (IWDNode.validate() method, while the response to the client as called rendering. The default behavior during the validation phase requires all nodes in all view contexts to be validated.

No

boolean

ZipResponse
Specifies whether or not data is to be sent zipped or unzipped to a client. If this parameter is already defined in the http service of the SAP NetWeaver Application Server, this parameter should be set to false.

No

boolean

sap.defaultConnectionTimeOut
Specifies the duration of the connection

 

 

sap.defaultMaxNumberOfConnections
Specifies the maximum permitted number of valid JCo destinations.

 

 

sap.defaultMaxPoolSize
Specifies the maximum pool size

 

 

sap.defaultMaxWaitTime
Specifies the maximum wait time when calling the system

 

 

sap.domain.relaxation.blacklist
Specifies the blacklist of applications for which domain relaxation is not allowed This property is only taken into account if the configuration parameter

sap.domain.relaxation.enabled is set to true.

Valid values: 

Comma-separated list of Web Dynpro applications, containing the DC name and the application short name (i.e. it is equal to the part of the application URL that follows /webdynpro/dispatcher).

Example: 

sap.com/tc~wd~tools/Explorer, sap.com/tc~wd~tools/WebDynproConsole

 

 

sap.domain.relaxation.enabled
Specifies whether domain relaxation is enabled or not

Using the parameters sap.domain.relaxation.whitelist and sap.domain.relaxation.blacklist, it is possible to specify a list of applications which are allowed to use domain relaxation, or for which domain relaxation is forbidden.

1.       false: the sap.domain.relaxation.whitelist is checked whether it contains applications for which domain relaxation should be allowed anyway.

true: the sap.domain.relaxation.blacklist is checked whether it contains applications for which domain relaxation should not be allowed, although it is generally allowed.

 

 

sap.domain.relaxation.whitelist
Specifies comma-separated whitelist of applications for which domain relaxation is allowed.

This property is only taken into account if the configuration parameter sap.domain.relaxation.enabled is set to false, i.e. if domain relaxation is generally not allowed.

Valid values: 

Comma-separated list of Web Dynpro applications, containing the DC name and the application short name (i.e. it is equal to the part of the application URL that follows /webdynpro/dispatcher).

Example: 

sap.com/tc~wd~tools/Explorer, sap.com/tc~wd~tools/WebDynproConsole

 

 

sap.ADSCallingMode
Specifies how the Adobe Document Service is called: Either by passing all data within the SOAP request or by sending the template and the PDF separately in the form of binary data (http).

 

Soap

sap.invalidDeploymentStateURL
Defines the Web address of the HTLM page to be displayed if the application is ended because the status of the corresponding deployable object is not valid.

Yes

Any valid, absolute Web address.

sap.logoffURL
Specifies the Web address of the standard logoff page that is displayed when the user terminates the application.

Yes

Any valid, absolute Web address.

sap.noClientURL
If no client is specified in the Web Dynpro configuration file clients.properties, you can use this property to configure the displayed error page.

No

 

sap.portalURL
The iView runtime application is a runtime environment for processing iViews. This function is assigned to the component iView Runtime Java (IRJ) application. The use of this function depends on the configuration of the deployed portal. The runtime ID usually appears in the URL after http://<hostname>:<port>/.

 

 

sap.protocolSchemeForADSCall
Specifies which port the Web service client addresses: ConfigPort_ Document for http calls or SecConfigPort_Document for https calls. If the property has the value request, the protocol with which the Web Dynpro application was started is used. An http setting forces the http protocol, even if Web Dynpro was called using https. Exception: There are methods in the Adobe Document Service that force https. Examples of these are suppressPrint, digital signatures, or certification. In this case, Web Dynpro switches to the https protocol itself.

 

http, https

sap.resourceCache.deletionTime
Defines the time span after which a cached resource is removed from the cache.

No

Any positive integer

sap.resourceCache.persistenceTime
Defines the time span for which a cached resource is stored in the cache.

No

Any positive integer

sap.resourceCache.pollingTime
Defines the time interval in which the cache is refreshed.

No

Any positive integer

sap.resourcePool.directory
Defines the directory in which the cache stores its data.

No

Any positive integer

sap.sld.cacheExpirationTime
Defines the expiration time (in seconds) of an SLD object that is stored in the cache.

No

Any positive integer

sap.sld.cacheInvalidationTime
Defines the invalidation time of cached SLD objects in seconds. If an SLD that cannot be reached is to trigger an exception, this value must be set to the same value as sap.sld.cacheExpirationTime.

No

Any positive integer

sap.systemLocale
Specifies the standard language key that is used when no language key is provided by the user authentication or no value is set for the Locale configuration property of the application configuration.

No

Valid values of the ISO standard 639.

sap.textMapping.enable
Defines whether text mapping is used.

No

boolean

sap.textMapping.objectName
Defines the name of the development component (DC) containing the text mapping.

No

Name of the DC containing the text mapping.

sap.textMapping.separators
Defines a list of separators used for text mapping.

Yes if text mapping is used

 

sap.textMapping.systemName
Defines the system name of the SAP NetWeaver Application Server used

Yes if text mapping is used

System name

sap.textMapping.systemNumber
Defines the system number of the SAP NetWeaver Application Server used

Yes if text mapping is used

Name of the system number

sap.theme.default
Defines the URL of the Unified Rendering stylesheet themes used. This value is not used if a) the Web Dynpro application runs in the portal or
b) the URL parameter stylesheet_theme is set

No

Any valid, absolute Web address.

sap.url.protocols
An absolute URL address has a protocol (URI schema) of the list entered below the current configuration property. URLs with a different protocol are regarded as invalid.

No

ftp, mailto, file and all other protocols permitted for URLs

sap.useWebDynproStyleSheet
If the Web Dynpro application is running in the SAP Enterprise Portal, this property specifies whether the Portal stylesheets are to be used. If the value of the property is set to false, the Portal style sheets are used. If the value of the property is set to true, the Portal style sheets are also used if the Web Dynpro application is running in the SAP Enterprise Portal. By default, the value of this property is set to false.

No

boolean

sap.valuesetlimit.maximmediate
Defines the upper limit of the set of values immediately sent to the CSF client.

No

Any positive integer

sap.valuesetlimit.maxondemand
Defines the upper limit of the set of values sent to the CSF client on request.

No

Any positive integer

sap.webdispatcher.host
Defines the host of a used Web Dispatcher

No

Name of host

sap.webdispatcher.port
Defines the port of a used Web Dispatcher

No

Name of port

sap.webdispatcher.protocol
Defines the protocol of a used Web Dispatcher

No

http/https

 

End of Content Area