Oracle9iAS Portal Developer Kit

copy_string function

Contained in package wwnls_api.

Call this method to copy all language strings given a string ID. The name of the new strings will be their newly generated ID.

function copy_string
(

p_source_nls_id nls_string_id_type

)

return nls_string_id_type;

Version: Oracle9iAS Portal 9.0.2 or later

Parameters:

 p_source_nls_id

The ID of the source string

Datatype: nls_string_id_type

Returns:

This function returns

Exceptions:

  • If the string cannot be copied, NLS_EXECUTION_EXCEPTION is raised.
  • If the message string ID is not found, NLS_ID_NOT_FOUND_EXCEPTION is raised.
  • If a validation error occurs, NLS_VALIDATION_EXCEPTION is raised.

Example:

declare

l_string_id number;
l_new_id number;

begin

l_string_id := wwnls_api.get_id(

p_domain => 'MAP_PROVIDER',
p_sub_domain => 'MAP_PORTLET',
p_name => 'PORTLET_TITLE',
p_language => wwnls_api.AMERICAN);

l_new_id := wwnls_api.copy_string(

p_source_nls_id => l_string_id);

end;

Related topics

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