Log in as an administrator to Oracle Portal.

Deploying Reports in Oracle Portal 16-11 ■ Enter the name or user parameter to restrict the values available to users in the Name field. For example, SALES_REGION or COPIES. ■ Enter the display name of the system or user parameter. This name will be used to identify the parameter on the runtime parameter form. ■ Enter the name of the list of values, or select the values from a predefined list of values. The list must already exist. For information on creating a list of values, see the OracleAS Portal online Help. ■ Enter the lowest value that you wish to set for a range of values in the Low Value field. ■ Enter the highest value that you wish to set for a range of values in the High Value field. ■ Click More Parameters if you wish to add more rows for additional parameters and values.

14. Click Next.

15. Optional Enter the Availability Calendar name or click the list button to select an existing Availability Calendar. Use the availability calendar to limit the days and times this report can be run.

16. Click Next.

17. Optional Enter a validation trigger to create a programmatic restriction. Use validation triggers to create conditional restrictions that cannot be defined on either the Required Parameters page or the Optional Parameters page. Validation triggers are PLSQL functions. The function that you specify as a validation trigger must return a boolean value TRUE or FALSE. If the function returns TRUE, the job is run. If the function returns FALSE, an error message is displayed and the job is not run.

18. Click Finish to close the wizard and complete report registration.

The resulting page summarizes your registration information and provides the opportunity to perform additional actions on your report.

19. Click the Access tab and select the Publish as Portlet box. This adds the report to

the Portlet Repository, allowing you to add it to a page and publish your report as a portlet.

20. Click Customize to view the reports Runtime Parameter Form.

Table 16–3 summarizes the options available on this page. See Also: Section 16.2.4, Creating an Availability Calendar See Also: Section 16.3, Publishing Your Report as a Portlet for more information on how to run your report from Oracle Portal. Table 16–3 Options on the Runtime Parameter Form Option Description Run Report Click to run this report with the specified parameter values. Save Parameters Click to save the parameter value selections. 16-12 Publishing Reports to the Web with Oracle Reports Services

16.2.3 Registering a Printer

It is not required that you register a printer within the security framework of Oracle Portal. You can run a report on any printer as long as it is available to the Reports Server. However, you might want to confine Oracle Portal users to a subset of those Server Select the Oracle Reports Server that you want to receive this report request. Only the servers that you chose at the time of registering the Report are displayed in this list box. Printer Select the printer that you want to print your report output. Only the printers that you chose at the time of registering the report are displayed in this list box. Destype Select the destination type. Only the destination types that you chose at the time of registering the report are displayed in this list box. Desformat Select the destination format. Only the destination format that you chose at the time of registering the report are displayed in this list box. Desname Enter the name of the output file when DESTYPE=FILE, or enter the e-mail addresses when the DESTYPE=MAIL. Separate multiple addresses with commas. The destination name is required when you choose FILE or MAIL as the DESTYPE. SSOCONN Enter one or more Single Sign-On connection strings. Separate multiple strings with a comma but no spaces. For more information on SSOCONN, refer to Section 17.3.3.1, SSOCONN . Visible to user Check each parameter that you want to make available in the runtime parameter form when users run this report request. If the box in not checked, then the parameter is not displayed to users. Servlet Command Key Optionally, enter the key from the cgicmd.dat key map file for more information, see Section 18.13, Using a Key Map File that identifies the command line to run for this report. Portlet Width Use this field to control the width of the portlet. You can enter the value as a percentage of the page for example, 90 or in pixels e.g, 700. If no value is specified, Oracle Reports Services uses its default value 640 pixels wide. Portlet Height Use this field to control the height of the portlet. You can enter the value as a percentage of the page for example, 50 or in pixels e.g, 400. If no value is specified, Oracle Reports Services uses its default value 320 pixels high. Additional User Parameters Use this field to enter additional user parameters. For example, you can use this field to enter the path and name of the distribution XML file that defines how this report should be distributed. Use the same syntax you would use to specify these values in a command line request or within the cgicmd.dat key map file file for more information, see Section 18.13, Using a Key Map File . If you wish to enter multiple additional parameters, simply separate each entry with a space. For more information on the distribution XML file, see Chapter 20, Creating Advanced Distributions . Table 16–3 Cont. Options on the Runtime Parameter Form Option Description