Oracle9iAS Portal Developer Kit

new_instance procedure

Contained in package wwa_app_module.

Call this procedure to start a new session for a form component.

This is the starting point for running a form component in full page mode. This procedure starts a new session for a given p_moduleid and then control is transferred to the show procedure with the session_id of the session.

This URL starts a new session for a form component:

http://HOST:PORT/pls/DAD/PORTAL_SCHEMA.wwa_app_module.new_instance?p_moduleid=MODULE_ID

Where HOST, PORT, DAD, PORTAL_SCHEMA should be replaced with the appropriate values.

procedure new_instance
(
    p_moduleid in number
);

Version: Oracle Portal 3.0.9

Parameters:

p_moduleid

The module ID of the form component.

This value can be obtained from the 'Run' or 'About' link on the form's Manage screen. For example, this is a typical Run link (where p_moduleid is 1080540748):

PORTAL_SCHEMA.wwa_app_module.new_instance?p_moduleid=1080540748

Datatype: number

Exceptions:

None.

Example:

Consider a form component with module ID 1080540748. To start a session for this component, enter the following URL in a browser:

http://HOST:PORT/pls/DAD/PORTAL_SCHEMA.wwa_app_module.new_instance?p_moduleid=1080540748

The above URL displays a:

  • Form based on a table/view in Query and Insert mode
  • Master-detail form in Query and Save mode
  • Form based on a procedure in Submit mode

The above URL can also be used to form an anchor tag which can start a session when a user clicks on the link.

Related topics

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