Oracle9iAS Portal Developer Kit

open_form procedure

Contained in package wwpro_api_adapter.

Call this procedure to open a form on a portlet's customize page in a manner suitable for use in a portlet which may be deployed using the PL/SQL HTTP Adapter.

This means that customization is performed in the same way as PDK-Java, i.e. via a call to htp.formOpen and then htp.formHidden for these parameter names:

p_action
_dad
_schema
_type
_providerid
_portletid
_backurl
_mode
_referencepath

These parameters are needed by the Parallel Page Engine (PPE) to show the portlet again. This is exactly the same as the parameters on the customization form for PDK-Java portlets. For example, user clicks:

  • OK - PPE shows page again, saves parameters and redirects to the value passed in _backurl.
  • APPLY - PPE shows page again and saves parameters.
  • CANCEL - User goes back to value passed in _backurl
  • RESET - PPE shows page again but parameters are not saved.

Subsequent htp.formHidden calls may be made for other parameter names and values to be saved, e.g. new Title for the portlet.

procedure open_form
(

p_formattr in varchar2,
p_prr in wwpro_api_provider.portlet_runtime_record

);

Version: Oracle9iAS Portal 9.0.2 or later

Parameters:

 p_formattr

The form attributes (equivalent to the cattributes parameter of htp.formOpen).

Datatype: in varchar2

 p_prr

A portlet runtime record containing the parameter values used to populate the form.

Datatype: in wwpro_api_provider.portlet_runtime_record

Exceptions:

  • This procedure raises no user-defined exceptions.

Example:

wwpro_api_adapter.open_form
(

p_formattr => 'NAME="customfolder"',
p_prr => p_portlet_runtime_record

);

Related topics

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