Facilitating Report Manipulation

In this section:

Normally, a Web server returns an entire report to a browser. The browser waits until it receives all of the report before displaying it.

On-demand paging allows you to download one page of a report to a browser instead of the entire report. The Web server holds the remaining pages until the user requests them. This feature shortens the time the user waits to see the first page of a report. It is especially effective for long reports.

On-demand paging is implemented in the WebFOCUS Viewer. It requires that report output be formatted as HTML, which is the default setting for a request submitted through the WebFOCUS Client.

The following is a report displayed in the WebFOCUS Viewer.

WebFOCUS viewer report diagram


Top of page

x
Using the WebFOCUS Viewer

How to:

The WebFOCUS Viewer is a browser window divided into two frames:

The Report Frame is the larger upper frame that contains one page of output.

The Control Frame contains the controls used to navigate the report and to search for a string in the report. The navigational controls allow you to display the next or previous page, the first or last page, or a specific page.



x
Syntax: How to Enable the WebFOCUS Viewer
SET WEBVIEWER = {OFF|ON}
ON TABLE SET WEBVIEWER {OFF|ON}

or

ON TABLE SET WEBVIEWER {OFF|ON}

where:

OFF

Disables on-demand paging; WebFOCUS downloads the entire report to a standard browser window. OFF is the default value.

ON

Enables on-demand paging. WebFOCUS downloads the first page of a report to the browser in the WebFOCUS Viewer. The number of lines displayed at one time depends on Windows desktop settings (resolution).



Example: Enabling the WebFOCUS Viewer

The procedure and launch page for this example are run in WebFOCUS. They must be tested and run in this environment.

  1. Create a procedure named ONDEMAND, which displays an order report for a store in the WebFOCUS Viewer.

    Procedure:

    SET WEBVIEWER=ON
    TABLE FILE CENTORD
    PRINT ORDER_NUM ORDER_DATE
    BY STORE_CODE
    WHERE STORE_CODE EQ '1003DC'
    ON TABLE SET PAGE-NUM OFF
    ON TABLE SET STYLE *
    TYPE=REPORT, GRID=OFF,$
    ENDSTYLE
    END
  2. Create a launch page from which a user can run the report.
  3. Run the launch page, and click the link. The report displays in the WebFOCUS Viewer.

    WebFOCUS Viewer diagram


Top of page

x
Opening and Closing the WebFOCUS Viewer

How to:

Reference:

You can specify a target frame in which to open the WebFOCUS Viewer, and a home page that displays when you close the WebFOCUS Viewer.



x
Syntax: How to Open the WebFOCUS Viewer in a Target Frame
SET WEBVIEWTARG = {target_frame|OFF}

where:

target_frame

Is the name of an existing frame in the browser or one of the following reserved HTML target frames:

_blank opens the WebFOCUS Viewer in a new browser window. This is the default for reports that do not have accessibility enabled.

_self opens the WebFOCUS Viewer in the same frame as the anchor.

_parent opens the WebFOCUS Viewer in the immediate parent frame that contains the anchor.

_top opens the WebFOCUS Viewer in the current browser window.

OFF

Opens the WebFOCUS Viewer in the frame from which you ran the report. This is the default for reports that have accessibility enabled.

Note: For more information on enabling accessibility, see ACCESSPDF.



x
Syntax: How to Display a Home Page When You Close the WebFOCUS Viewer
SET WEBVIEWHOME = {home_URL|OFF}

where:

home_URL

Is a valid URL that displays an HTML page when you close the WebFOCUS Viewer.

OFF

Displays a blank browser window when you close the WebFOCUS Viewer. You must enter another URL to run another report. OFF is the default value.



x
Reference: Closing the WebFOCUS Viewer

The Close button, located on the Control Frame, closes the WebFOCUS Viewer and removes the report from the Web server. The page the browser displays next depends on the WEBVIEWTARG and the WEBVIEWHOME settings, as follows:


Top of page

x
Controlling Button Display on the WebFOCUS Viewer

How to:

You can issue commands that specify whether the WebFOCUS Viewer displays the All Pages, Help, and Close buttons.

The following image shows the WebFOCUS Viewer Control Bar:

The All Pages button is the second button to the right of the Page number information. The Help and Close buttons are the last two buttons.



x
Syntax: How to Control Whether the All Pages Button Displays
SET WEBVIEWALLPG = {OFF|ON}

or

ON TABLE SET WEBVIEWALLPG {OFF|ON}

where:

ON

Displays the All Pages button. ON is the default value.

OFF

Does not display the All Pages button.



x
Syntax: How to Control Whether the Help Button Displays
SET WEBVIEWHELP = {OFF|ON}

or

ON TABLE SET WEBVIEWHELP {OFF|ON}

where:

ON

Displays the Help button. ON is the default value.

OFF

Does not display the Help button.



x
Syntax: How to Control Whether the Close Button Displays
SET WEBVIEWCLOSE = {OFF|ON}

or

ON TABLE SET WEBVIEWCLOSE {OFF|ON}

where:

ON

Displays the Close button. ON is the default value.

OFF

Does not display the Close button.


Top of page

x
Printing With On-Demand Paging

How to:

You must clear the browser cache before printing a report locally using the Print button on the browser toolbar. You must also activate the window by clicking it before using the Print button.

Use the procedure that applies to your browser to clear the cache.



x
Procedure: How to Clear the Cache in Microsoft Internet Explorer
  1. Select Internet Options from the Tools menu.
  2. On the General tab, for Temporary Internet Files, select Delete Files.

Top of page

x
WebFOCUS Viewer Navigation

How to:

To enable the Goto Last Page button in the WebFOCUS Viewer with certain versions of Microsoft Internet Explorer, complete the following procedure.



x
Procedure: How to Enable the Goto Last Page Button
  1. From Internet Explorer, click the Tools menu and select Internet Options.
  2. The Internet Options dialog box opens.
  3. From the Temporary Internet files box, click Settings.

    The Settings dialog box opens.

  4. Click the Every visit to the page radio button.
  5. Click OK to apply the change and exit the Settings dialog box.
  6. Click OK to exit the Internet Options dialog box.

WebFOCUS