sap java web dynpro

Configuring the Web Dynpro Runtime EnvironmentProcedure

A number of settings allow you to influence the behavior of the Web Dynpro system configuration. This is done in the archive file WebDynpro.war.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.

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

01.

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

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

name for the module is displayed: webdynpro/resources/sap.com/tc~wd~dispwda

03.

In the Web Module Detailssection, select the Web Dynpro Properties tab and select default from the corresponding table.04.

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

To save your changes, select Save in the Web Module Detailssection.06.

Parameter Description

Parameter Description Default

AccessibilityChecksEnabled Specifies the whether accessibility checks are enabled. false

ActivateURLParameters If set to false, the Web Dynpro runtime ignores some URL parameters that could be set.These URL parameters are, for instance, the sap.csf.* parameters and thesap.session.plugin parameter. It's recommended to keep parameter value false in orderto deactivate URL parameters that might not be available in production mode.

false

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

true

AllowXMLHttpRequestForIE6 Specifies whether Web Dynpro is allowed to use an XMLHttpRequest object for IE6 useragents. In case ActiveX is not enabled for all such clients, you can use this switch incase of warnings or errors due to the use of an XMLHttpRequest object by Web Dynpro.

true

DefaultExpirationTime Specifies the expiration time in seconds when no user interaction takes place. Thisdefault expiration time is used if an application does not specify its own expiration timeexplicitly.Valid values:Any positive integer number

3600

DevelopmentMode Specifies whether the Web Dynpro runtime environment runs in a development mode, ornot. This can affect how error messages are displayed. For example, the error messagepage provides detailed information about product, version, protocol, and stack tracewhen the Web Dynpro runtime environment runs in a development session.

true

IGSUrl Specifies the Web address of the Internet Graphics Service (IGS) valid for theapplication. This service supports the display of the UI elements BusinessGraphics andGeoMap. The URL of the IGS is specified according the following pattern:http://<server host name>< fully qualified path name>:4<server

instance number>80.

Example: http://localhost:40080

<empty>

InlineCSS Specifies whether the Web Dynpro runtime performs the optimization of inline CSSrendering. This affects server-side HTML rendering only.

true

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

true

UISecurityLevel Specifies the security level of UI security checks. UI security means that the frameworkchecks whether a UI event is allowed in the current state of the UI element. Per defaultthe Web Dynpro runtime throws an exception, if such a situation occurs.Valid values:integer value = 0, 1, 20 No Exceptions are thrown, if UI security is violated, but the violations are traced.1 Exceptions are thrown, if generic checks like enabled, isible and read only fail, otherviolations are traced.2 Exceptions are thrown, if any security violation is recognized.Note: You should only change the default, if the security exception is caused byframework bugs or known temporary inconsistencies.

2

Configuring the Web Dynpro Runtime Environment - Developing Jav... http://help.sap.com/saphelp_nw73ehp1/helpdata/en/4c/2319ca352857...

1 of 6 1/23/2013 2:32 PM

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

true

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

false

context.extended.validation Enabling this property, node elements activate an extended sanity check on attributeaccess, for example regarding destruction of an element via eventing.

true

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 memoryanalyzer is activated, or not. 0 is indicating that it is not activated. Choose value 1 toactivate memory reporting.

0

sap-ser-report-filetrc Property used for serialization report: Write report into trace. If set to true, theserialization report is written into the defaultTrace.trc file under location

com.sap.tc.webdynpro.session.report , severity level INFO .

false

sap-ser-report-filter Specifies the problem filter which the monitor should take into account. Bit maskencoding:1 Class uses custom serialization (i.e. class is NOT shareable)2 Class loader is not shareable4 Class uses non trivial finalizer8 Class has serial persistent field16 Class has transient fields32 Super class does not implement serializable64 Object is not shareable due to a complex reason128 Class does not implement serializable (i.e. class is NOT serializable) 256 Object isnot serializable due to a complex reason

384

sap-ser-report-level Specifies if the monitor is activated and if so, in which granularity information should begathered.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

classes3 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.acf.adobe.CABFileVersion Specifies which ActiveX version is required for Adobe Interactive-Forms. Valued efault uses the version specified by default for the current stack.

Any other value: May be needed to automatically upgrade the front-end componentswithout a server upgrade

default

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

1000

sap.corecomp.useWavelineDesign Specifies whether a predefined popup window (Confirmation Dialog, EVS, OVS orTechnicalInfo) is displayed with the new wave line design.

true

sap.cmi.useLongTexts Messages being reported via an ICMIMessageProvider. can contain a short or a longmessage text. If you set this property to true you can achieve that the long message

text is taken if available.

false

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

false

sap.defaultConnectionTimeOut Specifies the duration of the connection (in msec) 30000

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

sap.defaultMaxPoolSize Specifies the maximum pool size, i.e. maximum number of simultaneously used JCoconnections.

5

sap.defaultMaxWaitTime Specifies the maximum wait time when calling the system (in msec). If the request failsafter this time interval, it will be ended with a LockException.

10000

sap.domain.relaxation.blacklist Specifies the blacklist of applications for which domain relaxation is not allowed. Thisproperty is only taken into account if the configuration parametersap.domain.relaxation.enabled is set to true.

Valid values:Comma-separated list of Web Dynpro applications, containing the DC name and the

<empty>


2 of 6 1/23/2013 2:32 PM

application short name (i.e. it is equal to the part of the application URL that follows/webdynpro/dispatcher ).

Examples: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 parameterssap.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 generallyallowed.

true

sap.domain.relaxation.whitelist Specifies comma-separated whitelist of applications for which domain relaxation isallowed. This property is only taken into account if the configuration parametersap.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 theapplication short name (i.e. it is equal to the part of the application URL that follows/webdynpro/dispatcher ).

Examples:sap.com/tc~wd~tools/Explorer sap.com/tc~wd~tools/We bDynproConsole

<empty>

sap.interoperability_arfc1_arfc2.filter Defines interoperability mode between Adaptive RFC 1 and Adaptive RFC 2 modeltypes as for connection management: ARFC1 and ARFC2 model use same statefulbackend connection in order to allow applications using different model types tointeroperate.Values (all others interpreted as off):off: no connection sharingfilterDestinationName: use list of destination names specified insap.interoperability_arfc1_arfc2.filter propertyfilterModelName: use list of qualified Java model names specified insap.interoperability_arfc1_arfc2.filter propertyon: use connection sharing for all models and destinationsIn general, connection sharing should be restricted as far as possible as this meansquite some overhead on the JCO side; That means that you should only activate it for adestination if all applications using this destination should run in interoperability modewith ARFC2. General activation should only be set for test purposes.

<empty>

sap.interoperability_arfc1_arfc2.mode Interoperability Adaptive RFC 1 / 2 by stateful connection sharing. General activation isonly recommended for test purposes.Valid values:Off (default), filterDestinationName, filterModelName, on

off

sap.invalid.DeploymentStateURL Defines the Web address of the HTLM page to be displayed if the application is termi-nated due to an invalid status of the corresponding deployable object. Web page ad-dress: /webdynpro/resources/sap.com/tc~wd~dispwda/global/deployment.htm Furtherpossible values: Any valid absolute URL.

required

sap.locking.maxWaitInterval Specifies the maximum wait interval in seconds in the Web Dynpro locking system;needed for long-runners. This is especially needed for long-runners, for which requestprocessing takes longer than 100 seconds. This property is usually not needed andshould 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 userterminates the application.Default Web page is /webdynpro/resources/sap.com/tc~wd~dispwda/global/logoff.htmPossible entries: Any valid absolute URLs

required

sap.max.session.limit Defines the maximum number of Web Dynpro page builder sessions and Web Dynprostandalone application sessions that are allowed per security session.Valid values:values > 0value < 0 deactivates the checkvalue = 0 produces an exception

7

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.msie.no-cache.workaround Specifies when the workaround for a problem with Microsoft IE and https will be acti-vated. Reason: Web Dynpro always adds the header "Pragma: no-cache" to every filetransfer during download or file exchange with Adobe or office integration. IE refuses toaccept a file if it is accessed via https and this header is present (http://support.micro-soft.com/kb/812935). The workaround is not to add this header if the client is MSIE6.The Web Dynpro configuration parameter decides when to activate it. With default valueauto the workaround will be activated if the request arrived via https. Administrators can

auto


3 of 6 1/23/2013 2:32 PM

set it to yes if there is a reverse proxy between browser and server that accesses theserver via http, so that the server cannot see that the browser used https.

sap.noClientURL If no clients are specified in Web Dynpro configuration file clients.properties, you can usethis property to configure the displayed error page.Web page address:/webdynpro/resources/sap.com/tc~wd~dispwda/global/noclient.htmFurther possible values: Any valid absolute URL

Yes (required)

sap.portalURL Specifies the default value for used portal URL. The Portal's iView runtime application isa runtime environment for processing the iViews. This function is assigned to thecomponent iView Runtime Java (IRJ) application. How this function is used depends onthe configuration of the deployed portal. The runtime ID appears in the URL afterhttp://<hostname>:<port>/

irj

sap.previewMode.enabled The preview mode enables features which where implemented as an outlook forupcoming functionalities. The use of those features is allowed for demo applicationsonly. There is no support and no guarantee that these features will be available in laterversions.

false

sap.protocolSchemeForADSCall Specifies which port the Web service client addresses:ConfigPort_Document for http calls orSecConfigPort_Document for https calls.If the property has 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 wascalled using https. Exception: There are methods in the Adobe Document Service thatforce https. Examples of these are suppressPrint, digital signatures, or certification. Inthis case, Web Dynpro switches to the https protocol itself.Summary valid values: request: same protocol scheme as current httpRequest fromclienthttp: always http (as long as no secure function of ADS is used)https: always https

request

sap.resourceCache.deletionTime Defines the time span (in secs) after which a cached resource is removed from thecache. If no value is set, the time span is 30 mins.

<empty>

sap.resourceCache.encryption Defines whether the resources will be encrypted when dumped to a file. <empty>

sap.resourceCache.persistenceTime Defines the time span after which a cached resource is stored in the cache. <empty>

sap.resourceCache.pollingTime Defines the time interval (in secs) in which the cache is refreshed. If no value is set, thetime interval is 60 secs.

<empty>

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

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 unavailable SLDshould always trigger an exception, this value must be set equally to the configurationparameter sap.sld.cacheExpirationTime .

Valid values: Any positive integer number.

86400

sap.systemLocale Specifies the standard language key that is used when no language key is provided bythe user authentication or no value is set for the Locale configuration property of theapplication configuration. Therefore, a valid ISO Language code is needed. These codesare the lower-case two-letter codes as defined by ISO-639. You can find a full list ofthese codes at a number of sites, such as:http://www.ics.uci.edu/pub/ietf/http/related/iso639.txtValid values: A valid ISO language code (ISO-639)

<Locale ofserver VM>

sap.techinfo.enabled Specifies whether the Technical Info and its system menu entry are permanentlyenabled.Valid Values:default : The value is automatically determined by the Web Dynpro runtime

true: permanently enabledonRequest : 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 arunning session. Requires that the Extensions tab is visible. If set to default , the

resulting value is automatically determined by the Web Dynpro runtime. Currently, onlythe 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 isnot 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 timein a session. There are no further checks, esp. the other configuration entriesshowExtensions , manageExtensions are not checked. The purpose of this

default


4 of 6 1/23/2013 2:32 PM

configuration is to allow the extensions of the Technical Info with a set of trustedextensions 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 setFormat of Entries:QualifiedNameOfExtensionComponent '@' EngineApplica tionName 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 theconfigured list.Example:co m.mycompany.TechnicalInfoAddOn@ mycompany.com/techinfo~plugin

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 or not text mapping is used. false

sap.textMapping.objectName Specifies the name of the deployable object (=EAR file) in which the text mapping isdefined.

local/TextMappings

sap.textMapping.separators Defines a list of separators used for text mappings of a message. !;,:-_+=)([]?

sap.textMapping.systemName Defines the system name of the J2EE Engine used for text mapping. ${SYSTEM_NAME}

sap.textMapping.systemNumber Defines the system number of the J2EE Engine used for text mapping. ${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.

<empty>

sap.theme.default Defines the URL of the Unified Rendering style sheet themes used. This value is notused ifa) the Web Dynpro application runs in SAP NetWeaver Portal, orb) URL parameter stylesheet_theme is set

<empty>

sap.theme.hosts Specifies the valid hosts for CSS URLs. Comma-separated list of hosts which are validprovider for theme URLs. The usage of placeholders is possible (the syntax may becompatible 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 usedthat is not included in this list, the Look-and-Feel service will throw an exception.

<empty>

sap.theme.name.default Specifies the used default theme name. <empty>

sap.ui.table.maxVisibleRowCount Determines the maximum count of rows which can be displayed in a table.Valid values:any positive integer

200

sap.url.protocols Comma-separated list of protocols used by the Web Dynpro URL generator as whitelistof allowed protocols. If the property is empty, the supported default protocols are httpand https. If a protocol is used that is not included in this list, the URL generator throwsan exception. After changing this property, the server needs to be restarted.

http,https,ftp,mailto,file,sapacp

sap.useWebDynproStyleSheet If running in the SAP NetWeaver Portal, this flag specifies whether or not the Portal stylesheets shall be used. They are used if the parameter is set to false (default). If set totrue, the Web Dynpro style sheets are used also when running in the Portal.

false

sap.valuesetlimit.maxondemand Defines the maximum size of a simple type value set which is displayed as a SimpleValue Selector (DropDownByKey UI element with dropdown list). When the value setsize exceeds the configured sap.valuesetlimit.maxondemand value the

dropdown list is replaced by an Extended Value Selector (EVS) popup dialog.

50

sap.wd.disableAsyncInputValidation Specifies whether input validation is disabled. If set to false, the validation of data ininput fields bound to numeric simple types is automatically done while the user entersdata.

false

sap.wd.disableInputValidationUs-ingOVSSuggester

Disables the additional validation of user input via a defined IWDOVSSuggesterimplementation.. To deactivate this new validation, set this property to true . More

information: Providing Search Result Value Lists (OVS)

false

sap.wd.showPresentationModeDe-scriptionAsComboBox

Specifies whether an input field bound to a CctCode with presentation mode descriptionis rendered as ComboBox or as DropDown UI element. If configuration is set to true theinput field is rendered as a ComboBox. More information: Displaying and FormattingCore Data Types

true

sap.webdispatcher.host - deprecated - Web dispatcher host must no longer be configured but is determined automatically byWeb Dynpro. Web Dynpro runtime determines a used Web Dispatcher automatically. Ifan explicit configuration is defined, the explicitly configured Web Dispatcher is used tocreate balanced application URLs.

<empty>

sap.webdispatcher.port - deprecated - Web dispatcher port must no longer be configured but is determined automatically byWeb Dynpro.

<empty>


5 of 6 1/23/2013 2:32 PM

sap.webdispatcher.protocol -deprecated -

Web dispatcher protocol must no longer be configured but is determined automaticallyby Web Dynpro.

<empty>


6 of 6 1/23/2013 2:32 PM

sap java web dynpro

Documents