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.
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 |
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://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.
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 |