Working With Amper Auto-Prompting

In this section:

The WebFOCUS amper auto-prompting facility enables you to create a launch page that prompts users for the amper variables necessary to execute a procedure. You can also customize launch pages, display or hide parameters, and add descriptions of procedures, variables, default variable values, headings, and more. For more detailed information, see the Developing Reporting Applications manual.


Top of page

x
Customizing the Amper Auto-Prompting Facility

You can customize the look and feel of the amper auto-prompting facility by editing the launch page template file you are using. All of the available launch page templates are located in the ibi\WebFOCUS77\ibi_html\javaassist\ibi\html\describe directory. The default template is autoprompt_top.css.

If you want to customize the banner, create an image, save it in the describe directory, and change the background-image property, which is shown in bold type in the following Cascading Style Sheet (CSS) code:

#idBannerDiv {
height:41px; 
background-image:url(style/logo_banner_TOP.gif); 
background-position:top left;
background-repeat:no-repeat; 
margin:0px;
margin-top:0px;
cursor:pointer; }

The option to select different launch page templates can be set in the WebFOCUS Administration Console using the Parameter Prompting selection under Client Settings, where you can set the IBIF_describe_xsl value to one of the launch page templates.

You can also enter the name of the desired launch page template in a FOCEXEC using the following code:

<describe_xsl>template</describe_xsl>

where:

template

Is set to one of the following launch page template values:

  • autoprompt_top - Displays the parameters horizontally at the top of the page and is the default template value.
  • autoprompt_top_checked - Same as autoprompt_top, but the Run in a new window check box is preselected.
  • autoprompt - Displays the parameters vertically at the left side of the page.
  • autoprompt_checked - Same as autoprompt, but the Run in a new window check box is preselected.
  • autoprompt_simple - Basic input form.


x
Amper Auto-Prompting Considerations

The following are important amper auto-prompting issues to consider:

  • When a Managed Reporting procedure issues a –INCLUDE statement of another Managed Reporting procedure, the procedure referenced by the –INCLUDE statement inherits the main procedure Prompt for Parameters property setting.
  • Amper auto-prompting does not support the following:
    • Parameters in an INCLUDE file when it is coded as –INCLUDE &FILENAME.
    • A parameter coded in a procedure that is referenced by an EX or EXEC command is not processed by parameter prompting. If you must reference a parameter in a procedure, use a –INCLUDE statement.
    • A parameter prompt string containing the ampersand (&) character.
    • Amper variable names that exceed 12 characters when the variable is included between –HTMLFORM BEGIN and –HTMLFORM END statements. (The variable is not resolved.)
  • Amper auto-prompting ignores:
    • Amper variables created with the –SET command. A value has been explicitly specified.
    • Global amper variables (&&NAME).

For more information about amper auto-prompting, see Amper Auto Prompting of the Coding a User Interface section in the Developing Reporting Applications manual.



x
Selecting All Values for Amper Auto Prompt Reports

For reports that utilize the amper auto-prompting facility and have a:

  • Static multi-select list, the output includes an option for the user to "Select All" values.
  • Dynamic multi-select list, the output includes an option for the user to select "No Selection". This option essentially selects all values by removing the selection test containing the field from the report request.

Note: If the selection test is a complex WHERE statement testing multiple fields, the entire WHERE statement is removed from the report request.



x
Variables for Managed Reporting Amper Auto-Prompting

How to:

You can set the options for amper auto-prompting. The setting you select is for the entire site. When you turn off amper auto-prompting, Managed Reporting Publish Utility functionality is also turned off even though the option still appears on the toolbar in Developer Studio and the Managed Reporting Domain Builder Applet.

You can modify these settings from the WebFOCUS Administration Console. You must be an administrator to change these settings.



x
Procedure: How to Set Options for Amper Auto-Prompting
  1. Select Configuration.
  2. Select Managed Reporting.
  3. Set IBIMR_prompting to one of the following:
    • XMLPROMPT prompts for amper variables created with –DEFAULT and any other amper variable that does not have a value. This is the default value.
    • XMLRUN only prompts for amper variables created with –DEFAULT when there is another amper variable that does not have a value assigned and, therefore, will be prompted for.
    • OFF turns off amper auto-prompting at the site level.

Note: This setting was implemented so that Managed Reporting prompting (IBIMR_prompting) would be mutually exclusive from the amper autoprompt feature (specified by using IBIF_wfdescribe).

For more information about these settings, see the WebFOCUS Security and Administration manual.


WebFOCUS