Oracle9iAS Portal Developer Kit

remove_node procedure

Contained in package wwpro_api_node_registry.

Call this procedure to delete a remote node's registration entry from the local node. Both the node record and provider records are removed. All providers from the specified node are deleted.

Notes:

  • After the node is removed from the node registry, any portlets that reference providers from the deregistered node will not be functional.

  • This procedure does not update the portlet registry.

procedure remove_node

(

p_id in integer

);

Deleting a node disables all portlet instances for that provider. To reinstate a deleted node, use wwpro_api_node_registry.register_node function with the original node ID. The deleted node's disabled portlets are restored.

A user must have the All Provider Manage or All Provider Publish privilege to remove a remote node.

Version: Oracle Portal 3.0.6.6.5 or later
Deprecated: Oracle9iAS Portal 9.0.2

Parameters:

p_id

The ID of the remote node to be deregistered.

Exceptions:

  • If the node record deletion fails, a NODE_REMOVAL_EXCEPTION is raised.

  • If a provider record deletion fails, a PROVIDER_REMOVAL_EXCEPTION is raised.

Example:

wwpro_api_node_registry.remove_node

(

p_id => 2456

);

Notes

  • 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.

  • A node is an Oracle Portal installation.

Related topics

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