Oracle9iAS Portal Developer Kit

copy_portlet procedure

Contained in package wwpro_api_provider.

Oracle Portal calls this procedure when copying a portlet. The procedure copies a portlet's customization and default settings from an existing portlet instance to the new portlet instance.

procedure copy_portlet

(

p_copy_portlet_info in copy_portlet_record

);

Any user can use this function.

Version: Oracle Portal 3.0.6.6.5 or later

Parameters:

p_copy_
portlet_info

Specifies the information to be copied:

  • provider_id

  • portlet_id

  • source path

  • destination path

Datatype: copy_portlet_record

Exceptions:

  • If invalid information about the provider is returned, a PROVIDER_VALIDATION_EXCEPTION is raised.

  • If the provider cannot be executed, a PROVIDER_EXECUTION_EXCEPTION is raised.

  • If there is a generic problem with the portlet that prevents the portlet from being executed, a PORTLET_EXECUTION_EXCEPTION is raised.

Example:

example_provider.copy_portlet

(

p_copy_portlet_info => copy_portlet_record

);

Notes

  • The register_portlet procedure is called prior to this procedure.

  • A portlet instance is the display of a portlet on a single page. The same portlet may be displayed multiple times on the same page. Each time a portlet is added to a page, Oracle Portal generates a unique portlet instance ID that is the instance's reference path.

Related topics

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