Hyperion Essbase Query Designer User Interface
Reporting Services provides a graphical query designer for building Multidimensional Expression (MDX) queries for a Hyperion Essbase data source. The MDX graphical query designer has two modes: Design mode and Query mode. Each mode provides a Metadata pane from which you can drag members from a cube defined on the data source to build an MDX query that retrieves data when the report is processed.
Important
Users access data sources when they create and run queries. You should grant minimal permissions on the data sources, such as read-only permissions.
For more information about working with a Hyperion Essbase multidimensional data source, see Hyperion Essbase Connection Type (SSRS).
This section describes the toolbar buttons and query designer panes for each mode of the graphical query designer.
Graphical Query Designer in Design Mode
When you edit an MDX query for a dataset that uses a Hyperion Essbase data source, the graphical query designer opens in Design mode.
The following figure labels the panes for Design mode.
The following table lists the panes in this mode.
Pane | Function |
---|---|
Select Cube button | Displays the currently selected cube. |
Metadata pane | Displays a hierarchical list of cubes. |
Calculated Members pane | Displays the currently defined calculated members available for use in the query. |
Filter pane | Displays the filters to apply in the query. |
Data pane | Displays the results of running the query. |
You can drag dimensions and measures from the Metadata pane, and calculated members from the Calculated Member pane onto the Data pane. If the AutoExecute toggle button on the toolbar is on, the query designer runs the query every time you drop an object onto the Data pane. If AutoExecute is off, the query designer does not run the query as you make changes to the Data pane. You can manually run the query using the Run button on the toolbar.
In the Filter pane, you can select dimension values to limit the data retrieved from the data source. Values you define in the filter in Design mode appear in the MDX Where clause in Query mode.
Toolbar for the Graphical Query Designer in Design Mode Toolbar
The query designer toolbar provides buttons to help you design MDX queries using the graphical interface. The following table shows the buttons and describes their functions.
Button | Description |
---|---|
Edit As Text | Toggle between the text-based query designer and the graphical query designer. Not available for this data source type. |
Import | Import an existing query from a report definition (.rdl) file on the file system. For more information, see Report Embedded Datasets and Shared Datasets (Report Builder and SSRS). |
Refresh metadata from the data source. | |
Display the Calculated Member Builder dialog box. Use this to create or edit expressions for a calculated member, including setting the Solve Order property. | |
Switch between showing and not showing empty cells in the Data pane. (This is the equivalent to using the NON EMPTY clause in MDX). | |
Automatically run the query and show the result every time a change is made, for example, deleting a column in the Data pane. Results are shown in the Data pane. | |
Delete the selected item from the query. Use this button to delete selected rows in the Filter pane. | |
Run the query and display the results in the Data pane. | |
Cancel the query. | |
Switch between Design mode and Query mode. |
Graphical Query Designer in Query Mode
To change the graphical query designer to Query mode, click the Design Mode toggle button on the toolbar. The following figure indicates the parts of the query designer in Query mode.
The following table describes the function of each pane.
Pane | Function |
---|---|
Select Cube button | Displays the currently selected cube. |
Metadata/Functions pane | Displays a tabbed window that shows a list of available metadata or functions that can be used to build the query text. |
Query pane | Displays the current query text. |
Result pane | Displays the results of the query. |
From the Metadata pane, you can drag measures and dimensions from the Metadata tab onto the MDX Query pane. You can drag functions from the Functions tab onto the MDX Query pane. When you execute the query, the Result pane displays the results for the current MDX query.
Toolbar for the Graphical Query Designer in Query Mode
The query designer toolbar provides buttons to help you design MDX queries using the graphical interface. The toolbar buttons are identical between Design mode and Query mode, but the following buttons are not enabled for Query mode:
Edit As Text
Add Calculated Member ()
Show Empty Cells ()
AutoExecute ()