Show TOC Start of Content Area

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

A number of settings allow you to influence the behavior of the Web Dynpro system configuration. This is done in the archive file WebDynpro.wda. This file is part of EAR file sap.com/tc~wd~dispwda.ear and is automatically deployed on the SAP NetWeaver Application Server.

Procedure

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

...

       1.      Log in to NetWeaver Administrator either by choosing NetWeaver Administrator on your engine’s Start page or by entering the following URL:

http://<your host name>:<port>/nwa

       2.      In the top level navigation, select Configuration Management and in the second level navigation bar, select Infrastructure.

       3.      Select Application Modules, and in the Module List section enter tc~wd~dispwda (or parts of this string) into the filter row.

       4.      In the Web Module Details section, select the Web Dynpro Properties tab and select default from the corresponding table.

       5.      In the Full Details section, navigate to the property you want to configure, and make the required entries.

       6.      To save your changes, select Save in the Web Module Details section.

Parameter Description

Parameter

Description

Default

AccessibilityChecks

Enabled

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

false

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, URL parameters sap.csf and sap.session.plugin are ignored.

true

AllowUserPersonalization

Enables the end user to implicitly configure the Web Dynpro interface, for example to adapt fields or tables

true

DefaultExpirationTime

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

3600

DevelopmentMode

Specifies whether the Web Dynpro runtime environment runs in a development session. This can affect how error messages are displayed. 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.

true

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 and GeoMap.

The URL of the IGS is specified according the following pattern:
http://<server host name>< fully qualified path name>:4<server instance number>80. To give an example: http://myserver.company.com:41080

 

http://localhost:47080

InlineCSS 

Specifies whether the Web Dynpro runtime performs the optimization of inline CSS rendering; this affects server-side HTML rendering only.

false

Lightspeed

Specifies whether the Web Dynpro runtime uses Unified Rendering's Lightspeed control framework (instead of classic UR); this affects server-side HTML rendering only.

true

sap.acf.adobe.CABFileVersion

Specifies which ActiveX version is required for Adobe Interactive-Forms

      default: Uses the version specified by default for the current stack

      any other value: May be needed to automatically upgrade the front-end components without a server upgrade

default

sap.adobe.zciReady.

timeout.limit

Specifies the time a Web Dynpro application waits for the zciReady message from the Acrobat Reader in milliseconds. The default value is enough for small and medium sized forms to be loaded in the browser. Applicable only for ZCI (Zero Client Install - native) based interactive forms in Web Dynpro for Java.

1000

sap.default.authentication

Specifies whether all Web Dynpro application require authentication per default. If set to true, authentication will be required for all applications. If set to false, only those applications require authentication which have set the authentication flag in the application properties.

false

sap.defaultConnection

TimeOut

Specifies the duration of the connection (in msec)

30000

sap.defaultMaxNumber

OfConnections

Specifies the maximum permitted number of valid JCo destinations

10

sap.defaultMaxPoolSize

Specifies the maximum pool size, i.e. maximum number of simultaneously used JCo connections

5

sap.defaultMaxWaitTime

Specifies the maximum wait time when calling the system

10000

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.

      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.

true

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.invalid

DeploymentStateURL

Defines the Web address of the HTLM page to be displayed if the application is terminated due to status of the corresponding deployable object not being valid

 

/webdynpro/resources/sap.com/tc~wd~dispwda/global/deployment.htm

sap.locking.

maxWaitInterval

Specifies the maximum wait interval in seconds in the Web Dynpro locking system; needed for long-runners

If a value is defined in this property, the custom value will be used. This is especially needed for long-runners, for which request processing takes longer than 100 seconds.

This property is usually not needed and should only be modified if long-runner applications are really used.

100

sap.logoffURL

Specifies the Web address of the standard logoff page displayed when the user terminates the application

 

/webdynpro/resources/sap.com/ tc~wd~dispwda/global/logoff.htm

sap.maxUpload.file

Maximal size that an uploaded file may have (in kB, 0 for unlimited)

0

sap.maxUpload.

session

Maximal total upload in one session (in kB, 0 for unlimited)

0

sap-mem-report-filetrc

Property used for memory report:

If set to true, the memory report is written into the defaultTrace.trc file under location com.sap.tc.webdynpro.session.report, severity level INFO.

false

sap-mem-report-level

Property used for memory report: Granularity level

Specifies whether the memory analyzer is activated. Currently, valid values are 0 and 1, 0 indicating that it is not activated, 1 indicating that it is activated.

0

sap.noClientURL

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

 

/webdynpro/resources/sap.com/tc~wd~dispwda/global/noclient.htm

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. How this function is used depends on the configuration of the deployed portal. The runtime ID usually appears in the URL after http://<hostname>:<port>/.

irj

sap.previewMode.enabled

The preview mode enables features which where implemented as an outlook for upcoming functionalities

The use of those features is allowed for demo applications only. There is no support and no guarantee that these features will be available in later versions.   

false

sap.protocolScheme

ForADSCall

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.

request

sap.resourceCache.

deletionTime

Defines the time span (in secs) after which a cached resource is removed from the cache

If no value is set, the time span is 30 mins.

 

sap.resourceCache.

encryption

Defines whether the resources will be encrypted when dumped to a file

 

sap.resourceCache.

persistenceTime

Defines the time span after which a cached resource is stored in the cache

 

sap.resourceCache.

pollingTime

Defines the time interval (in secs) in which the cache is refreshed.

If no value is set, the time interval is 60 secs.

 

sap.resourcePool.

directory

Defines the directory in which the cache stores its data

 

sap-ser-report-filetrc

Property used for serialization report: Write report into trace

If set to true, the serialization report is written into the defaultTrace.trc file under location com.sap.tc.webdynpro.session.report, severity level INFO.

false

sap-ser-report-level

Specifies if the monitor is activated and if so, in which granularity information should be gathered.

Valid values:

0: serialization monitor is disabled

1: serialization monitor creates a short summary report

2: serialization monitor creates a report on class level, considering only application classes

3: serialization monitor creates a report on class level, considering all classes

4: serialization monitor creates a report on object level, considering objects of all types

0

sap.sld.cacheExpirationTime

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

3600

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.

86400

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.

en

sap.techinfo.enabled

Specifies whether the Technical Info and its system menu entry are permanently enabled

Valid Values:

      default: The value is automatically determined by the Web Dynpro runtime

      true: permanently enabled

      onRequest: disabled until the user activates it for the duration of the current application by pressing both the CTRL and ALT keys while opening the context menu (right mouse click)

      false: permanently disabled

Currently the resulting value for default is onRequest for all system types.

default

sap.techinfo.

manageExtensions

Specifies whether Technical Info allows to modify the set of active extensions within a running session. Requires that the extensions Tab is visible.

If set to default, the resulting value is automatically determined by the Web Dynpro runtime. Currently, only the System Type as specified in the licensing is taken into account. For Development systems the set of extensions can be modified, for other system (Test, Productive), it is not shown.

Valid Values:

default, true, false

default

sap.techinfo.

predefinedExtensions

Comma separated list of predefined Technical Info extensions.

All specified extensions are activated when the Technical Info is opened for the first time in a session. There are no further checks, esp. the other configuration entries showExtensions, manageExtensions are not checked! The purpose of this configuration is to allow the extensions of the Technical Info with a set of trusted extensions that should be available in every Web Dynpro session.

Caution

Be careful when extending this list. Only add trusted components

Default Value is not defined, might vary from release to release

Valid Values: no fixed value set

Format of Entries:

      QualifiedNameOfExtensionComponent '@' EngineApplicationName 

The QualifiedNameOfExtensionComponent is a Java qualified name, the EngineApplicationName is the name of a deployment unit in the format as shown in the NetWeaver Administrator.

      If the configured list starts with a '+', then the configured extensions are added to the SAP defined list of extensions, otherwise the SAP defined list is replaced by the configured list.

Example:

com.mycompany.TechnicalInfoAddOn@ mycompany.com/techinfo~plugin

default

sap.techinfo.

showExtensions

Specifies whether the list of Technical Info extensions is displayed in its own tab.

If set to default, visibility is determined by the Web Dynpro runtime automatically.

default

sap.textMapping.

enable

Defines whether text mapping is used

false

sap.textMapping.

object

Defines the name of the development component (DC) containing the text mapping

 

sap.textMapping.

objectName

Specifies the name of the deployable object (=EAR file) in which the text mapping is defined

 

local/TextMappings

sap.textMapping.

separators

Defines a list of separators used for text mapping

!;,:-_+=)([]?

sap.textMapping.

systemName

Defines the system name of the J2EE Engine used

${SYSTEM_ NAME}

sap.textMapping.

systemNumber

Defines the system number of the J2EE Engine used

${INSTANCE_ NUMBER}

sap.textMapping.

webModule

Specifies the name of the Web module (=name of the Web module's context root) containing the defined text mappings

 

sap.theme.name.default

Specifies the used default theme name

 

sap.theme.default

Defines the URL of the Unified Rendering style sheet themes used. This value is not used if

a) the Web Dynpro application runs in SAP NetWeaver Portal, or

b) URL parameter stylesheet_theme is set

 

sap.theme.hosts

Specifies the valid hosts for CSS URLs.

Comma-separated list of hosts which are valid provider for theme URLs. The usage of placeholders is possible (the syntax may be compatible with the syntax of the regular expression). If the property is empty or missing, all hosts are allowed to provide theme URLs (this is the default setting).

If a host is used that is not included in this list, the Look-and-Feel service will throw an exception.

 

sap.ui.table.

maxVisibleRowCount

Determines the maximum count of rows which can be displayed in a table.

Valid values:  any positive integer and -1

-1 means NO LIMIT

200

sap.url.protocols

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

 

http,https,ftp,mailto,file,sapacp

sap.valuesetlimit.

maxondemand

Defines the maximum size of a simple type value set which is displayed as a Simple Value Selector (DropDownByKey UI element with dropdown list). When the value set size exceeds the  configured sap.valuesetlimit.maxondemand value the dropdown list is replaced by an Extended Value Selector popup dialog.

50

sap.webdispatcher.host

Defines the host of a used Web Dispatcher

 

sap.webdispatcher.port

Defines the port of a used Web Dispatcher

 

sap.webdispatcher.

protocol

Defines the protocol of a Web Dispatcher being used

 

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 is referred to as rendering. The default behavior during the validation phase requires all nodes in all view contexts to be validated.

true

ZipResponse

Specifies whether to send the data to the client zipped or unzipped. If this parameter is already defined in the http service in J2EE Engine, this parameter should be set to false

false

 

End of Content Area