Using the Viewer Control Panel

In this section:

How to:

The Viewer Control Panel, as shown in the following image, (located at the bottom of the window) contains the controls you use to navigate through the report and to search for a string in the report. The Viewer Control Panel navigational controls allow you to display the next or previous page, the first or last page, or a specific page. You use the searching function to have the Viewer locate a search string you specify within all report pages.

The Viewer Control Panel

Note: When specifying a search string, you must specify the actual number of spaces between characters because HTML displays a single space, even when multiple spaces are used between characters.

Procedure: How to Navigate Through a Report

The Viewer Control Panel offers several ways to view pages in your report:

  • To display a specific page:
    1. Enter a page number in the Page input box, as shown in the following image.
      The Page input box
    2. Click Go to Page, as shown in the following image.
      Go to Page image
  • To display the previous or the next page in sequence, click Previous or Next, as shown in the following image.
    Next button
  • To display the first or last page of the report, click First Page or Last Page, as shown in the following image.
    First or Last Page button
  • To download the entire report to the browser as a single document, click All Pages, as shown in the following image.
    All Pages button
  • To close the Viewer, click Close, as shown in the following image.
    Close button

Searching a Report

How to:

The Viewer Control Panel contains controls that offer several ways to search your report. Using the Viewer search controls, you can select a string of information, such as a phrase that occurs in your report or a group of numbers, and search for each occurrence of that string. You can further customize your search by matching capitalization of words exactly (a case-sensitive search) or by controlling the direction of your search (either forward or backward from your starting point in the report). Use these controls to search your report:

Procedure: How to Search the Report

  1. Enter the string in the Search input box.
  2. Click Match Case if you want to perform a case-sensitive search.

    Notice that the Viewer displays the Match Case button with a red line across it to indicate that it is active.

  3. To begin your search, click:
    • Search Backward to search for the string from the current page back to the first page.

      Or

    • Find to search from the current page to the end of your report.

    The Viewer searches the report, underlines the first occurrence of the string, and opens the display to the top of the page on which it appears. If the underlined occurrence of the string is not visible, scroll down the page until it appears in the window of the Viewer.

  4. Click Find again to search for another occurrence of the string.

Example: Using the Viewer Control Panel to Search

You want to use the Viewer Control Panel to navigate a long report called Coffee Sales to find occurrences of the string "Kona," a type of coffee that you sell. After you run the report, WebFOCUS displays the first page of the report in the Viewer.

  1. To search for sales of Kona, type Kona in the input box and click Find, as shown in the following image.
    Find image

    The Viewer returns your report with the first occurrence of your search string underlined, as shown in the following image.

    Viewer returns report
  2. Click Find again to locate the next occurrence of Kona.

Procedure: How to Customize Search Results With a Cascading Style Sheet

The WebFOCUS Viewer searches the report and underlines the first occurrence of the text string found. You may customize the search results by applying a Cascading Style Sheet (CSS) with a color and/or style defined.

  1. Open a new text file by using a third-party text editor, such as Notepad.
  2. Type the following example Cascading Style Sheet (CSS) code:
    BODY {
 font : x-small Verdana, Arial, Helvetica;
 }
 U {
 background : Blue;
 text-decoration : none;
 color : White;
 font : bold;
 }

    In the CSS example code above, underlined text in the body of the report will be changed to set the background color to Blue, set the text to bold, and set the text color to White.

  3. Save the file as a Cascading Style Sheet (.css).

    Note: Type .css as the file extension. For example, findcolor.css.

    The location in which to save the CSS file depends on the WebFOCUS environment you are working in.

    Note: CSS files are accessed from a web accessible location. For WebFOCUS installations, the /ibi_apps/ibi_html alias is a location in which web accessible content can be stored.

  4. Open your report in InfoAssist, or the Text Editor, and apply the Cascading Style Sheet. For information on InfoAssist, see the TIBCO WebFOCUS® InfoAssist User's Manual.

    In the following code, the findcolor.css Cascading Style Sheet file is applied to the report: 

    TABLE FILE CAR
PRINT CAR MODEL SEATS
BY COUNTRY
ON TABLE SET WEBVIEWER ON
ON TABLE SET STYLE *
CSSURL=/ibi_apps/ibi_html/findcolor.css, $
ENDSTYLE
END

    Note: Fully qualify the URL to the CSS file when the CSS file is located on a different web location than the WebFOCUS environment you are running the report from. For example: CSSURL=http://hostname[:port]/ibi_apps/ibi_html/findcolor.css $, where hostname[:port] is the host name and port number of the web or application server the CSS file is accessible from.

  5. Run the report.
  6. Enter the string in the Search input box and click Find.

    The WebFOCUS Viewer searches the report and highlights the first occurrence of the string found in blue. In the example below, a report using the findcolor.css Cascading Style Sheet file searches for and finds DOOR by highlighting the word in blue.

    Report using Cascading Style Sheet