Oracle9iAS Portal Developer Kit

edit_node procedure

Contained in package wwpro_api_node_registry.

Call this procedure to change node properties for a registered node.

Notes:

  • This API modifies the node name only when operating on the local node.

  • Each time the node is edited, the database link is dropped and recreated.
  • Nodes are identified by their node ID.

procedure edit_node

(

p_node_record in node_record

);

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

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

Parameters:

p_node_
record

A node_record structure that contains all the information of the registered remote node.

Notes:

  • The ID field indicates which node to update.

  • It cannot be null.

Datatype: in node_record

Exceptions:

  • If the update of the node fails, a NODE_VALIDATION_EXCEPTION is raised.

  • If a user does not have the appropriate privilege for editing a node, a wwpro_api_provider.PROVIDER_SECURITY_EXCEPTION is raised.
  • If the update of the node fails, a NODE_VALIDATION_EXCEPTION is raised.
  • If the node with the specified node ID is not found, a NODE_NOT_FOUND_EXCEPTION is raised.
  • If an error occurs when connecting to the remote node, a NODE_DB_LINK_EXCEPTION is raised.
  • If an invalid value for a parameter is passed into the API or if an exexpected error occurs, a NODE_VALIDATION_EXCEPTION is raised.

Note: This and other provider node APIs add error messages to the error stack before they raise exceptions. This allows users to interrogate the error stack if a problem occurs.

Example:

wwpro_api_node_registry.edit_node

(

p_node_record => l_node_record

);

Related topics

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