Oracle9iAS Portal Developer Kit

set_string procedure (multiple parameters)

Contained in package wwnls_api.

Call this procedure to modify an existing message string or to add a translation for a string.

Note: If p_sub_domain is not specified, then a value of 'all' is assumed. Here, 'all' is the name of a single subdomain. It does not refer to all subdomains.

procedure set_string

(

p_domain in wwnls_strings$.domain%type,

p_sub_domain in wwnls_strings$.sub_domain%type default 'all',

p_name in wwnls_strings$.name%type,

p_language in wwnls_strings$.language%type,

p_text in wwnls_strings$.text%type

);

Version: Oracle Portal 3.0.6.6.5 or later

Parameters:

p_domain

The domain in which the message string should be found.

Example: WWS

Datatype: in wwnls_strings$.domain%type

p_sub_
domain

The subdomain in which the message string should be found.

Example: TEXT, NAVBAR

Datatype: in wwnls_strings$.sub_domain%type
Default: 'all'

p_name

The unique name of the message string.

Datatype: in wwnls_strings$.name%type

p_language

The NLS language name constant for the language of the string to be added.

Example: wwnls_api.JAPANESE

Datatype: in wwnls_strings$.language%type

p_text

The message text to replace the existing text for the specified string.

Datatype: in wwnls_strings$.text%type

Exceptions:

  • If a validation error occurs, an NLS_VALIDATION_EXCEPTION is raised.

  • If this function fails to execute, an NLS_EXECUTION_EXCEPTION is raised.

Example:

This example creates a string in Japanese in the 'all' subdomain of the Oracle Portal domain.

wwnls_api.set_string

(

p_domain => 'IPORTAL',

p_sub_domain => 'ALL',

p_name => 'TEST',

p_language => wwnls_api.JAPANESE,

p_text => 'THE JAPANESE TEXT STRING'

);

Related topics

The PL/SQL API Reference is part of the Portal Developer Kit on Portal Studio