Publishing Reports to the Web - Downloads - Oracle

17.1.3 How to Submit a Job
The Event-Driven Publishing API
The ADD_PARAMETER function has a third—optional—attribute, called MODE. MODE
determines whether a parameter will be overwritten or an error raised in the event
that a parameter with the same name already exists. To specify that an error will be
raised in the event of duplicate names, use the constant CHECK_FOR_EXISTANCE.
This is the default value for the MODE attribute. To specify that a parameter will be
overwritten in the event of duplicate names, use the constant OVERWRITE_IF_
EXISTS.
17.1.2.2 Remove_Parameter
Use REMOVE_PARAMETER to remove a parameter from a parameter list. Call the
procedure, and pass the parameter list from which you want to remove a parameter
along with the name of the parameter you want to remove.
For example:
DECLARE
myPlist SRW_PARAMLIST;
BEGIN
myPlist := SRW_PARAMLIST(SRW_PARAMETER('',''));
srw.add_parameter(myPlist,'myParameter','myValue');
srw.remove_parameter(myPlist,'myParameter');
END;
17.1.2.3 Clear_Parameter_List
To remove ALL parameters from your list, use CLEAR_PARAMETER_LIST. For
example:
DECLARE
myPlist SRW_PARAMLIST;
BEGIN
myPlist := SRW_PARAMLIST(SRW_PARAMETER('',''));
srw.add_parameter(myPlist,'myParameter','myValue');
srw.clear_parameter_list(myPlist);
END;
This will remove all parameters from your list.
A parameter list contains all vital parameters for submitting a job. The job type
determines which parameters are required on the list to enable the Reports Server to
process the request.
The listed parameters are the same ones that you must specify when you submit a job
from a browser to the Reports Servlet. In such a case, if the job is a report you will need
at least the following parameters but may have more:
■ GATEWAY provides the URL to the Reports Servlet you will use to process the
request.
■ SERVER identifies the Reports Server to be used in conjunction with the servlet.
■ REPORT identifies the report file to be run.
■ USERID identifies the name and user ID of the person running the report.
■ AUTHID provides authorization information in the event you are running against a
secured server.
Using Event-Driven Publishing 17-3