Example: Report with Variables

This article offers an example of how to create a report using variables.

  1. In Reports switch to Design view:


  2. Start by creating a new report group called Marketing:


  3. Next step is creating a new report hierarchy called Units:


  4. Create a new folder called Regions:


  5. Switch to the Variable mapping tab and select the type OLAP list:

    The following dialog is displayed:

  6. Enter Europe as Fallback value; this value will be used if a mapping is not possible.
  7. Select Regions in the Demo database and click Apply mapping.
  8. Create the folder Years as a sub-folder of Regions.
  9. Set the variable mapping to OLAP list.
  10. From the List Selector, click on the Demo database and select Years.
  11. Enter All Years in the Fallback value field and click Apply mapping.

Important: Make sure you follow the naming conventions for folders.

Now switch to the Designer. Recreate the following Jedox view in a new workbook called Units Hardware:

For the following steps, we have to detach this view to replace the PALO.ENAME functions with the corresponding PALO.ESELECT functions. To detach a view, click the Detach button in the toolbar.

  1. In order to work with Regions and Years as variables, we will replace "=PALO.ESELECT(…)" in cell C6 with "=@Regions" and "=PALO.ESELECT(…)" in cell E6 with "=@Years":



    Note: variables used in Jedox views are always defined by =@[Name].

  2. Save and close this file.
  3. Switch back to the Reports module and click on the Files tab (Design view should be selected).
  4. Drag Units Hardware over to the Years folder in the Navigation pane and click on this report.
  5. For the Regions variable, double click on any of the fields in the Regions row to open the dropdown menus.
  6. Under List type, select Report list from the menu.
  7. Under the column List/dynamic folder, select Regions(/). Click Apply to confirm the changes.


  8. For the Years variable, double click on any of the fields in the Years row to open the dropdown menus.
  9. Under the column List type, select Report list from the menu.
  10. Under the column List/dynamic folder, select Years (/Regions). Click Apply to confirm the changes.

Once the variable settings have been accepted, the variables are entered by clicking on the User Preview icon in the Navigation pane, as indicated below:

Navigate to Regions > Europe > West > France > Years > 2014 in the Navigation pane and double click on the file Units Hardware. Your view should appear as follows:

Instead of an entire dimension (e.g. Regions above), you can also select a Jedox subset list for variable mapping. Then the resulting dynamic folders are all displayed on the same level, not indented on the basis of their hierarchical levels.

If you select the list type OLAP list, then the variables come directly from the list (parent folders should have no mapping). In this case, it is possible to determine whether the variables in Reports are displayed or not. This display is typically not needed if the variables are mapped for batch printing purposes. By deactivating Expand, the variables are not displayed in Reports, but they are still available for batch processing. This gives you a better overview and saves a lot of computation time.

Back to top

Updated June 5, 2023