Show TOC

Adding Language-Specific URLsLocate this document in the navigation structure

Context

You can define more than one source URL for any URL iView. Apart from the default URL, which is not language-specific, you can define any number of additional URLs; each one corresponding to a different language.

If a portal user's language matches a language defined in the iView, then the corresponding language-specific URL will be executed at runtime. The default URL functions as the fallback URL if no language-specific URL matches the user's language.

Defining multiple URLs per iView is useful for sites that support multiple languages by means of language-specific URLs; for example, you can define URLs that are language variants of the default www.google.com URL of Google, such as www.google.de and www.google.jp . In other cases, you can define in the same iView, variant URLs which reference different Web sites.

Note
  • You must first create the URL iView and then use the editor to use this feature. It is not available in the URL iView Wizard.

  • You cannot apply a different look and feel to language-specific URLs. iView content will be displayed at runtime in its native format as defined in the source Web page. For more information, see the Keep source formatting option in Defining the Look and Feel of the iView Content . The remaining look and feel rendering option are supported by the default URL only.

For information on how the portal runtime determines which URL to execute, see the Result section below.

Procedure


  1. Open the iView in the URL iView Editor.

  2. Select the Language-specific URLs mode.

  3. Click Add . A screen similar to the one you used to set the default URL is displayed. The new options are the Language box and the Copy Parameters from Default URL button.

  4. In the Language box, choose the language of the URL you are defining.

  5. Define all the settings of the language-specific URL in the same way you do for the default URL:

    1. Define the source URL. See Selecting the Source URL .

    2. Choose the area in the targeted Web page to display in the iView at runtime. See Selecting the Capture Area .

  6. (Optional) Configure the parameters in the URL that are passed to the information source at runtime.

    Note
    • If you have already defined the parameters for the default URL you can click Copy Parameters from Default URL to copy the current default URL parameters to the language-specific URL.

    • You can define only one system per iView (see Selecting a System ); therefore you cannot apply a different system per URL in the same iView.

  7. Click OK . You return to the main screen of the Language-specific URLs mode. The language and its corresponding URL are displayed in the table.

    • To modify the settings of a language-specific URL, select it and click Edit .

    • To delete a language-specific URL, select it and click Remove .

  8. Click Save .

Results

The language which the portal uses per user at runtime to compare to the language-specific URLs of defined in the URL iView is taken from the following:

  • The Forced Request Language property defined in the iView, which is defined by the content administrator at design time. This is an optional property.

  • A language request performed by the PRT, which takes into account parameters such as the user's profile language, the user's portal language, and the user's browser language, in this order (see Lookup of Resource Bundle ).

The following flowchart describes the runtime decision-making process that is used to determine if the default URL, or a language-specific URL, is executed:

Note that the priority of URLs in the language-specific URL table is from top to bottom. If a successful match is made, the remaining language-specific URLs in the iView are not checked.