Show TOC

Configuring ApplicationsLocate this document in the navigation structure

At design time, you can declaratively specify several predefined or self-defined configuration properties that you want to use to configure your WD application. The configuration parameters are assigned to the logical Application unit. The available pre-defined configuration properties include:

  • Authentication

    The configuration property Authentication describes a Boolean value (true or false) that specifies whether or not a WD application requires authentication when started. If you assigned the valuetrue to this parameter, the application requires a user authentication. Default setting isfalse, no authentication is required.

  • LogoffURL

    The configuration property LogoffURL specifies the Web address of a Web page that is displayed when the user terminates the application. If you do not assign a value to this configuration property, a default logoff page is used. Any valid, absolute Web address can be used for logoff. Note that the HTML file that describes the logoff template can be referenced like any other resource - for example,html/myLogoff.htm. Thehtm logoff page is contained in the webdynpro.war archive file.

  • ExpirationTime

    The configuration property ExpirationTime describes the lifetime (in seconds) of a WD application on the server before the application is terminated by the server. A valid value for this setting is any positive integerwhere the value assigned to the DefaultExpirationTime parameter in the system configuration is used as the default value. Therefore, the expiration time configuration setting within the Developer Studio is an optional one for the application.

  • Locale

    The configuration property Locale specifies the language key locale, which is used for the WD application. The value of this property is used if the user does not explicitly specify a property. The default language key locale is specified in the system configuration by the sap.systemLocale parameter. Valid values for language keys comply with the ISO standard 639. An ID is made up of two lower-case letters - for example,de for German oren for English.

  • iViewSplitting

    As a content administrator, you can create individual iViews from each view in an application, in order to rearrange the layout of the application and to incorporate non-Web Dynpro iViews among the Web Dynpro iViews. To do this, the application must be developed to be split up into different iViews. The iView splitting itself is done within SAP NetWeaver Portal; by assigning the iViewSplitting parameter to the Web Dynpro application unit, you would prepare the whole application, or the user interface units respectively, for this splitting process.

  • DomainRelaxation

    Domain relaxation code is required for cross-frame JavaScript; this is particularly important for Portal integration.

Prerequisites

The application has been created and is displayed in the Web Dynpro Explorer. Alternatively, you can configure the application within the same wizard that you would use for creation of the application.

Procedure

Using Pre-defined Configuration Settings

  1. In Web Dynpro Explorer navigate to the application.
  2. In the context menu of the application, choose Open.

    The Component Modeler will open with the application selected.

  3. In the context menu of the application, choose Properties.
  4. Open the Application Properties tab in the Properties view.
  5. Select New  and select one of the pre-defined application configurations DefaultLocale, ExpirationTime, LogoffURL, SuspendExpirationTime, iViewSplitting, or DomainRelaxation.
    Note

    For some properties, the values of the WD runtime configuration are adopted if you have not already set them explicitly with the application configuration. For example, the value of the DefaultExpirationTime parameter of the WD system configuration is used if you have not assigned a value to the ExpirationTime property of the application configuration (see Configuring the Web Dynpro Runtime Environment ).

  6. If the application was already deployed, configure the properties and redeploy the application.

Personalization Persistence API

For personalization persistence purposes, you get a runtime API that lets you determine whether personalization shall run in administrator mode only, or not. And you configure the personalization persistence by using URL parameters or application properties where a URL parameter always overrides an application property.

More information: Personalization Persistence API (P13N)

Using Self-Defined Configuration Settings

You can also create your own application properties as name/value pairs by selecting User defined.

More Information: Configuration Service