deregister_portlet procedure

Related topics

Contained in package wwpro_api_provider.

Oracle Portal calls this method when a portlet is removed from a page. The portlet may use this method to perform instance-level cleanup, such as the removal of end-user customizations.

procedure deregister_portlet

(

p_portlet_instance in portlet_instance_record

);

Any user can use this procedure.

Version: Oracle Portal 3.0.6.6.5 or later

Parameters:

p_portlet_
instance

A record containing the properties of a portlet instance.

Datatype: in portlet_instance_record

Exceptions:

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

  • If the provider cannot be located, a PROVIDER_NOT_FOUND_EXCEPTION is raised.
  • If the provider cannot be executed, a PROVIDER_EXECUTION_EXCEPTION is raised.
  • If the provider does not allow the user to run it, a PROVIDER_SECURITY_EXCEPTION is raised.
  • If the provider has given invalid information about the portlet, a PORTLET_VALIDATION_EXCEPTION is raised.
  • If the portlet does not allow the user to run it, a PORTLET_SECURITY_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.

Examples:

Calling code

wwpro_api_provider.deregister_portlet

(

p_portlet_instance => portlet_instance_rec

);

Call to the provider

example_provider.deregister_portlet

(

p_portlet_instance => portlet_instance_rec

);

Notes

  • An audit record is created each time this procedure is used.

  • It is the caller's responsibility to remove the provider schema, if necessary.
  • 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

Back to top

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