Using the StyleSheet File Selector

How to:

Reference:

The StyleSheet File Selector enables you to reference or embed an external style sheet, use the default WebFOCUS StyleSheet, or apply no styling to your report. You may also save and include multiple style sheet. The StyleSheet File Selector is accessible from the Style tab of the Report Options dialog box.

The StyleSheet File Selector provides the following capabilities:

To open the StyleSheet File Selector, click Style File Selection from the Report Options Style tab. The StyleSheet Selection dialog box appears as shown in the image below.

Note: The StyleSheet File Selector opens to the Include StyleSheet File section, since every procedure has existing embedded styling by default. You may click Change Options and choose to embed or reference an external StyleSheet, use the WebFOCUS default StyleSheet, or turn off all report styling, as described in the procedures below.


Top of page

x
Procedure: How to Include a StyleSheet in a Report

Since every procedure has existing styling, the Include StyleSheet File section opens by default.

When a StyleSheet is included, part of the styling is embedded to the report. You may include StyleSheets up to an INCLUDE depth of three in your report, with the last selected StyleSheet having precedence.

  1. Click Styling from the Report menu.

    The Report Options dialog box opens at the Style tab.

  2. Click the Style File Selection button.

    The StyleSheet Selection dialog box opens.

  3. Click the Add new item button, as shown in the following image.

    The StyleSheet File Selection dialog box appears.

  4. Select a StyleSheet file and click OK.

    Note: The top half of the StyleSheet File Selection dialog box shows all the StyleSheets that are available from your local path. You may browse to change the location. The bottom half of the StyleSheet File Selection dialog box shows a list of the additional StyleSheets templates that are delivered with Developer Studio, as shown in the following image.

    StyleSheet Templates

    The selected StyleSheet is added to the Include StyleSheet File section.

  5. Optionally, you may select to include additional StyleSheets, up to an INCLUDE depth of three in your report.

    Note: The last selected StyleSheet has precedence in the report. You may use the arrows to reorder the arrangement of StyleSheets.

    For example, the image below shows that the BLACKRED StyleSheet was the last included, so that StyleSheet will take precedence in the report.

    The following syntax will be added to the procedure for the included StyleSheets.

    ON TABLE SET STYLE *
         INCLUDE = problue,
    $
         INCLUDE = citrus,
    $
         INCLUDE = blackred,
    $
    ...

    Note: For details about how reports inherit StyleSheet attributes, see WebFOCUS StyleSheet Attribute Inheritance in the Creating Reports With WebFOCUS Language manual.

  6. Click Finish to close the StyleSheet Selection dialog box.
  7. Click OK to close the Report Options dialog box.

    The selected StyleSheet is added to the list of StyleSheets that are included in the report, as shown in the following image.

  8. Optionally, you may apply styling options from Report Painter and save the StyleSheet code. For more information about saving StyleSheets, see How to Save a StyleSheet.

Top of page

x
Procedure: How to Apply an External Cascading Style Sheet (CSS)

In addition to including StyleSheets to your report, you may apply an external Cascading Style Sheet to your report. An external Cascading Style Sheet (CSS) is an extension to HTML that enables you to specify formatting for an HTML document. To link the CSS to the report, use the External Cascading Style Sheet URL field in the StyleSheet File Selector.

Note: An external Cascading Style Sheet is only applicable when using the HTML report output format.

  1. Click Styling from the Report menu.

    The Report Options dialog box opens at the Style tab.

  2. Click the Style File Selection button.

    The StyleSheet Selection dialog box opens.

  3. Type a name of the customized StyleSheet (.css) in the External Cascading StyleSheet URL input field, as shown in the following image.

    Note: The external CSS (Cascading StyleSheet) file should be saved in an alias on the web server.

  4. Optionally, you may include StyleSheets to be added to the report.

    Note: A CSS file is separate from a StyleSheet file and can exist on its own.

  5. Click Finish to close the StyleSheet Selection dialog box.
  6. Click OK to close the Report Options dialog box.

Top of page

x
Procedure: How to Embed a StyleSheet in a Report

Embedding a StyleSheet stores your style information within the report, from which you can read an existing file as a starting point, start with a empty style, or leave the current StyleSheet contents without any modifications.

  1. Click Styling from the Report menu.

    The Report Options dialog box opens at the Style tab.

  2. Click the Style File Selection button.

    The StyleSheet Selection dialog box opens.

  3. Click Change Options to change the StyleSheet File Selector options.
  4. Keep Normal Embedded Styling selected and click Next.

  5. To read an existing file as a starting point:
    • Select Initialize with the contents of a pre-existing file, as shown in the following image.

      Note: Preserve referenced StyleSheets so any “INCLUDE=name” will not be deleted is selected by default. When a StyleSheet is included, a reference of the StyleSheet is added to the report syntax as INCLUDE=name. This reference is added to the existing style information already in the TABLE request.

    • Click Next.

      The StyleSheet Selection dialog box appears.

    • Select an internal StyleSheet file to use as your starting point and click OK.

      The selected StyleSheet file is shown as the origin embedded StyleSheet file. Optionally, you may include additional StyleSheets or add an External Cascading StyleSheet (CSS). The StyleSheet Selection dialog box is shown in the following image.

    • Click Finish to close the StyleSheet Selection dialog box.
    • Click OK to close the Report Options dialog box.

    The selected StyleSheet code is imported into the procedure and overwrites any existing styling in the report.

  6. To start with an empty style:
    • Click Change Options to change the StyleSheet File Selector options.
    • Keep Normal Embedded Styling selected and click Next.
    • Select Start fresh with an empty StyleSheet, as shown in the following image.

      Note: Preserve referenced StyleSheets so any INCLUDE=name is selected by default. When a StyleSheet is included, a reference of the StyleSheet is added to the report syntax as INCLUDE=name. This reference is added to the existing style information already in the TABLE request.

    • Click Next.

      The Include StyleSheet File section, shown in the following image, opens indicating that the origin of the embedded StyleSheet file is unknown.

      Tip: You may select StyleSheet files to embed to your currently empty style.

    • Click Finish to close the StyleSheet Selection dialog box.
    • Click OK to close the Report Options dialog box.

    Starting with an empty style clears any styling from the report and initializes a procedure with the WebFOCUS default style code (basic styling that is used when styling is not specified).

  7. To leave Report Painter generated styling untouched:
    • Click Change Options to change the StyleSheet File Selector options.
    • Keep Normal Embedded Styling selected and click Next.
    • Select Leave current StyleSheet contents without modification, as shown in the following image.

      Note: Preserve referenced StyleSheets so any INCLUDE=name is selected by default. When a StyleSheet is included, a reference of the StyleSheet is added to the report syntax as INCLUDE=name. This reference is added to the existing style information already in the TABLE request.

    • Click Next.

      The Include StyleSheet File section opens indicating that the origin of the embedded StyleSheet file is unknown.

      Tip: You may include StyleSheets to be added to the report.

    • Click Finish to close the StyleSheet Selection dialog box.
    • Click OK to close the Report Options dialog box.
  8. Optionally, you may apply styling options from Report Painter and save the StyleSheet code.

Top of page

x
Procedure: How to Apply the Default WebFOCUS StyleSheet

The WebFOCUS Default Styling section applies the default StyleSheet to your report, with no styling visible in the procedure.

Note: The default WebFOCUS StyleSheet disables any styling options in the report. No further styling options of any kind can be applied to the report.

  1. Click Styling from the Report menu.

    The Report Options dialog box opens at the Style tab.

  2. Click the Style File Selection button.

    The StyleSheet Selection dialog box opens.

  3. Click Change Options to change the StyleSheet File Selector options.
  4. Select WebFOCUS Default Styling and click Finish, as shown in the following image.

    The Style tab shows that styling is disabled since you are using the WebFOCUS default stylesheet, as shown in the following image.

    Tip: To remove the default WebFOCUS StyleSheet and enable styling, click Style File Selection to open the StyleSheet File Selector and select the Normal Embedded Styling option.

  5. Click OK to close the Report Options dialog box.

Top of page

x
Procedure: How to Reset the Default Report Painter Styling

To reset the default Report Painter styling in the StyleSheet File Selector:


Top of page

x
Procedure: How to Turn Off All Report Styling

You may turn off all report styling in your report from the StyleSheet File Selector.

  1. Click Styling from the Report menu.

    The Report Options dialog box opens at the Style tab.

  2. Click the Style File Selection button.

    The StyleSheet Selection dialog box opens.

  3. Click Change Options to change the StyleSheet File Selector options.
  4. Select No Styling and click Finish, as shown in the following image.

    Note: This option disables all styling in your report. Any feature that uses styling will be unavailable. For example, Data Visualization, Drill Downs, and so on.

    The Style tab shows that styling is turned off in your report, as shown in the following image.

    Tip: To turn on styling again, click Style File Selection to open the StyleSheet File Selector and choose a styling option.

  5. Click OK to close the Report Options dialog box.

Top of page

x
Procedure: How to Save a StyleSheet

After including StyleSheets and applying styling options from Report Painter, you may save the StyleSheet as a new StyleSheet file (.sty).

  1. Click Save StyleSheet from the File menu in Report Painter.

    The Save As dialog box opens.

  2. Type a name for the StyleSheet in the File name input field and click Save, as shown in the following image.

    The .sty file is saved in the working directory. You may browse to select a different location.

Tip: The saved StyleSheet is available to be included in other reports from the StyleSheet File Selector, as shown in the example image below.

Note: The top half of the StyleSheet File Selection dialog box shows all the StyleSheets that are available from your local path. You may browse to change the location. The bottom half of the StyleSheet File Selection dialog box shows a list of the additional StyleSheets templates that are delivered with Developer Studio.


Top of page

x
Reference: Usage Notes for the StyleSheet File Selector

The following apply when using the StyleSheet File Selector in Report Painter:


WebFOCUS