Creating Filtered Dashboard Pages

In this section:

In Release 8.2 Version 01, WebFOCUS App Studio has a new Filter Panel option in the Requests & Data Sources tab, which lets you pick the Reporting Object and then streamlines the workflow for creating a filter panel to be used in a portal. This includes setting up a responsive layout with a single row of filter controls. It also sets the Load in iFrame Object property on the file to No, so that the portal creates an HTML DIV for the filter panel instead of an iFrame. This is important so that custom jQuery controls on the filter panel, such as the multi-select drop-down list and the calendar control, will be able to overlap the filter panel boundary.

An example of a filtered dashboard page, displayed on multiple devices, is shown in the following image.

Filtered Dashboard Page

To build a filtered dashboard page, you need to perform the following steps.

Step One: Creating a Parameterized Reporting Object

How to:

In this step, you create a Reporting Object and populate it with the Where statements that you will use for building a filter panel.

Procedure: How to Create a Parameterized Reporting Object

  1. Create a Reporting Object using the wf_retail_lite Master File.
  2. In the Reporting Object tool, right-click Where Statements and click New.

    The Create a filtering condition dialog box opens.

  3. Create WHERE statements that you will use as parameters in a filter panel. In this example, we are creating the following five WHERE statements.
    • Store,Business,Region Equal to Optional Static Parameter
    • Product,Category Equal to Optional Multiselect Parameter
    • Store Type Equal to Optional Static Parameter
    • Sale,Date Greater than or equal to Optional Simple Parameter
    • Sale,Date Less than or equal to Optional Simple Parameter

    Follow the steps below to create these.

    Store,Business,Region Equal to Optional Static Parameter

    1. Set the Field to Store,Business,Region, set the expression to Equal to, and set the Value to Parameter.
    2. Select the Static radio button, and then select the Optional check box.
    3. In the Value field, type _FOC_NULL, and click the Add to List button.
    4. Click Get Values and then click All.
    5. Multi-select all values and click the Add to List button.
    6. Click OK.
    Product,Category Equal to Optional Multiselect Parameter
    1. Click New Filter.
    2. Set the Field to Product,Category, set the expression to Equal To, and set the Value to Parameter.
    3. Select the Dynamic radio button, and then select the Optional check box.
    4. Select the Select multiple values at runtime check box.
    5. Click OK.
    Store Type Equal to Optional Static Parameter
    1. Click New Filter.
    2. Set the Field to Store,Type, set the expression to Equal To, and set the Value to Parameter.
    3. Select the Static radio button, and then select the Optional check box.
    4. In the Value field, type _FOC_NULL, and click the Add to List button.
    5. Click Get Values and then click All.
    6. Multi-select all values and click the Add to List button.
    7. Click OK.
    Sale,Date Greater than or equal to Optional Simple Parameter
    1. Click New Filter.
    2. Set the Field to Sale,Date, set the expression to Greater than or equal to, and set the Value to Parameter.
    3. Select the Simple radio button, and then select the Optional check box.
    4. Click OK.
    Sale,Date Less than or equal to Optional Simple Parameter
    1. Click New Filter.
    2. Set the Field to Sale,Date, set the expression to Less than or equal to, and set the Value to Parameter.
    3. Select the Simple radio button, and then select the Optional check box.
    4. Click OK.

    The following image shows the completed WHERE statements.

  4. Click OK to close the Create filtering condition dialog box.
  5. Save and close the Reporting Object tool.

Step Two: Creating Parameterized Content Using a Reporting Object

How to:

In this step, you use your newly created Reporting Object to generate analytical content. This procedure provides a fast and easy way to ensure the uniformity of the parameters used across the content.

Procedure: How to Create Content Using a Reporting Object

  1. Edit the Reporting Object that you created in the previous step, by creating a new report or chart.

    InfoAssist opens. The Master File that you used to build your reporting object is automatically selected.

  2. Drag fields of your choice from the Data pane to the Query pane to build a report or chart.
  3. Save your item and close InfoAssist.

    Note: Repeat these steps to create more content.

Step Three: Building Filter Controls

How to:

In this step, you create an HTML document with the filter controls that can be used to filter content on a page.

Procedure: How to Build Filter Controls in WebFOCUS App Studio

  1. Launch WebFOCUS WebFOCUS App Studio.
  2. In the Environments tree, right-click a domain or folder, point to New, and then click HTML/Document.

    The HTML/Document Wizard opens.

  3. Click Next.

    The Templates, Settings, and Themes screen appears.

  4. Keep the default settings and click Finish.
  5. In the Requests & Data Sources panel, click the arrow next to the New button, and then click Requests->Parameters->Filter Panel.

    The Open File dialog box opens.

  6. Navigate to the reporting object that you created in Step 1 and click OK.

    The New Parameters dialog box opens, as shown in the following image.

  7. Right-click the control type for the STORE_TYPE field and select Radio Button from the list of options.
  8. Keep the remaining default options and click OK.

    The filter controls appear in the HTML canvas.

  9. Perform the following actions to visually streamline the controls:
    1. Multi-select two date fields, right-click either one of them, point to Html object manipulation, and then click Merge containers.
    2. Change _FOC_NULL to All wherever applicable. To do so, select a control, open the Settings panel, double-click the Display value and modify the entry.
    3. Optionally, edit the titles of the controls. To do so, double-click the title of a control and modify the entry.

      An example of completed filter controls is shown in the following image.

  10. In the Tasks & Animations panel, under Tasks, click the New button.
  11. From the Trigger Type drop-down list, select Selection Changed.
  12. In the Trigger Identifier field, select check boxes next to all controls.
  13. In the Requests/Actions section, click the arrow next to the Requests Selections button, and then click Refresh.

    The Target type automatically changes to Refresh BI Portal and the Current page only radio button is automatically selected.

  14. Save the page and close WebFOCUS App Studio.

Step Four: Combining the Filter Panel and the Content

How to:

In this step, you build a responsive portal page and add your new filter panel to create a filtered dashboard.

Procedure: How to Use a Filter Panel in a Portal

  1. Create a new basic or collaborative portal and build a responsive portal page.
  2. Add your new filter panel to the responsive portal page, as described in Building a Basic Responsive Portal.
  3. Once you finished customizing your filtered dashboard page, click Save and close the Portal Designer.
  4. Run the portal.

    The completed filtered dashboard page at run time is shown in the following image.

  5. Manipulate the filter controls to see the content refresh, change the browser width to observe the responsive behavior.
  6. Optionally, publish your portal to make it available to other users and groups.