TechNet
Export (0) Print
Expand All

Report Model Query Designer User Interface

 

Applies To: SQL Server 2016

Report Designer provides two query designers to help you specify which data from a Report Server Model data source you want to use in a report. Use the graphical query designer to explore and choose model entities and entity fields. Use the text-based query designer to work directly with a Semantic Model Definition Language (SMDL) specification in XML format.

System_CAPS_ICON_important.jpg 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.

Report Designer provides a graphical query designer that you can use to design and run SMDL queries that, during report processing, populate the field collection for a report dataset. The graphical query designer is divided into three areas, or panes.

The following figure labels each pane.

Semantic Model Query Designer UI

The following table describes the function of each pane.

PaneFunction
Explorer paneDisplays graphic representations of the entities and entity fields in the model. Use this pane to explore entities, their related entities, and fields.
Design AreaDisplays a list of fields from the model. Use this pane to arrange the layout of the fields you've chosen.
Results paneDisplays the results of the query. To run the query, right-click in any pane, and then click Run, or click the Run (Run the query) button on the toolbar.

Changing information in the Explorer or Design Area panes will affect the contents of the Result pane when you click Run.

To perform actions within a certain pane, such as deleting a column in the design area, right-click on the column and then click the command on the menu.

Graphical Query Designer Toolbar

You can also use toolbar buttons when designing your query. The following table lists the buttons on the toolbar and what they can be used for.

ButtonDescription
Edit As TextToggle between the text-based query designer and the graphical query designer. The query for a Report Server model data source is a Semantic Model Query Language (SMQL) specification in XML.
ImportImport 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).
Undo actionUndo the last action.
Redo actionRedo the last action.
Run the queryRun the query and display the resulting rows in the Result pane.
Filter graphic next to selected filter columnOpen the Filter Data dialog box, which allows you to specify which data you would like to filter on. You can specify filters independently of data currently in the Design Area.

When you create a Report Server Model dataset query, the graphical query designer is the default. To switch to the text-based query designer, click the Edit As Text toggle button on the toolbar.

The text-based query designer consists of two panes: an SMQL query pane and a Result pane. This query designer view is primarily useful when you already have an SMQL query specification from some other source and would like to paste it in the query pane. Unlike the graphical query designer, the text-based query designer does not check query syntax or restructure the query. When you click Run on the toolbar, the query runs on the data source and the results are displayed in the Result pane.

The following figure labels each pane.

Generic Semantic Model Language Query Designer

The following table describes the function of each pane.

PaneFunction
Query paneDisplays the SMQL specification text.
Result paneDisplays the results of the query. To run the query, right-click in any pane, and then click Run, or click the Run button on the toolbar.

Text-based Query Designer Toolbar

You can also use toolbar buttons when designing your query. The following table lists the buttons on the toolbar and what they can be used for.

ButtonDescription
Edit As TextToggle between the text-based query designer and the graphical query designer.
ImportImport a query from an existing report.
Run the queryRun the query text and display the resulting row set in the Result pane.

Query Design Tools (SSRS)
Add Data from External Data Sources (SSRS)
Report Model Connection (SSRS)
RSReportDesigner Configuration File

Community Additions

ADD
Show:
© 2016 Microsoft