Configuring the Web Dynpro Runtime Environment (SAP Library

Configuring the Web Dynpro Runtime Environment

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 when the Web Dynpro runtime environment is installed.

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 Visual Administrator.

Proceed as follows to start the Visual Administrator:

...

1. Open the Visual Administrator by double-clicking the file go.bat in the local file directory of the Java engine of the SAP Web Application Server:

\usr\sap\<System ID>\<System Number>\j2ee\admin

Example: The background file can be stored in the directory
\usr\sap\J2E\JC00\j2ee\admin

2. Navigate to directory Server 0 0_xxxxx → Services → Configuration Adapter → webdynpro → sap.com → tc~wd~dispwda.

3. Choose the file PropertySheetdefault.

4. The Visual Administrator opens so that you can edit the values. You can change or redefine the parameters specified below.

5. Make entries for the values by selecting the relevant line. A dialog box appears in which you can enter value changes in the Custom field. Choose Ok to save the value changes.

Parameter Description

Overview of the parameters and the values they can take

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 whether the duplicate VMO name check is enabled/disabled 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