Skip to content

Commit

Permalink
fix links
Browse files Browse the repository at this point in the history
  • Loading branch information
pollyndos committed Sep 25, 2024
1 parent 7955a92 commit b366a91
Show file tree
Hide file tree
Showing 8 changed files with 100 additions and 93 deletions.
2 changes: 1 addition & 1 deletion dashboard-for-desktop/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -475,7 +475,7 @@
- name: Create Dashboard Parameters
href: articles/dashboard-designer/data-analysis/using-dashboard-parameters/creating-parameters.md
- name: Create Cascading Parameters
href: articles/dashboard-designer/data-analysis/using-dashboard-parameters/creating-parameters.md
href: articles/dashboard-designer/data-analysis/using-dashboard-parameters/create-cascading-parameters.md
- name: Reference Dashboard Parameters
href: articles/dashboard-designer/data-analysis/using-dashboard-parameters/passing-parameter-values.md
- name: Specify Parameter Values
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,11 @@ author: Natalia Kazakova
legacyId: 117711
---
# Dashboard Parameters

You can use **dashboard parameters** when it is necessary to pass data of a certain type to a dashboard (e.g., to pass a specific value to the data source filter string or a calculated field).

These topics describe how to use dashboard parameters.
* [Creating Parameters](dashboard-parameters/creating-parameters.md)
* [Passing Parameter Values](dashboard-parameters/passing-parameter-values.md)
* [Requesting Parameter Values](dashboard-parameters/requesting-parameter-values.md)
* [Create Dashboard Parameters](dashboard-parameters/creating-parameters.md)
* [Create Cascading Parameters](dashboard-parameters/create-cascading-parameters.md)
* [Reference Dashboard Parameters](dashboard-parameters/passing-parameter-values.md)
* [Specify Parameter Values](dashboard-parameters/requesting-parameter-values.md)
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@ author: Polina Tyureva

Create cascading parameters to filter a list of predefined parameter values based on values of another parameter. The following image illustrates cascading parameters where **Products** parameter values are filtered by the selected **Category**:

![Dashboard for Web - Cascading Parameters](~/images/cascading-parameters-web.gif)
![Dashboard for Web - Cascading Parameters](../../../../images/cascading-parameters-web.gif)

In case of two parameters, the first parameter is used to filter the data source for the second parameter with [dynamic list](creating-parameters.md#look-up-settings) settings.

## Create Cascading Parameters

The dashboard in this example is connected to a Northwind database (an SQL Database) and contains three [queries](provide-data/working-with-sql-data-sources/manage-sql-queries.md): *Categories*, *Products*, and *OrderReports*. The Grid item visualizes data from the *OrderReports* query.
The dashboard in this example is connected to a Northwind database (an SQL Database) and contains three [queries](../../provide-data/working-with-sql-data-sources/manage-sql-queries.md): *Categories*, *Products*, and *OrderReports*. The Grid item visualizes data from the *OrderReports* query.

In this tutorial, you will create two dashboard parameters:
* The **categoryDashParam** parameter filters the *Products* query. The *Products* query is a data source for the **productsDashParam** parameter.
Expand All @@ -24,68 +24,68 @@ The steps below create cascading parameters in the Web Dashboard:

The parameter settings may look as follows:

![|Dashboard for Web - Create Dashboard Parameter](~/images/web-category-parameter-cascading.png)
![|Dashboard for Web - Create Dashboard Parameter](../../../../images/web-category-parameter-cascading.png)

2. [Filter](provide-data/working-with-sql-data-sources/filter-queries.md) the *Products* query.
2. [Filter](../../provide-data/working-with-sql-data-sources/filter-queries.md) the *Products* query.

To do this, click the **Edit** button next to the query on the **Data Sources** page of the [dashboard menu](ui-elements/dashboard-menu.md).
To do this, click the **Edit** button next to the query on the **Data Sources** page of the [dashboard menu](../../ui-elements/dashboard-menu.md).

![Dashboard for Web - Filter Query](~/images/filter-sql-query.png)
![Dashboard for Web - Filter Query](../../../../images/filter-sql-query.png)

Click **Run Query Builder** in the opened window.

In the invoked [Query Builder](ui-elements/dialogs-and-wizards/query-builder.md), click the ellipsis button next to the **Filter** field in the **Query Properties** section:
In the invoked [Query Builder](../../ui-elements/dialogs-and-wizards/query-builder.md), click the ellipsis button next to the **Filter** field in the **Query Properties** section:

![Dashboard for Web - Filter Query](~/images/web-filter-properties.png)
![Dashboard for Web - Filter Query](../../../../images/web-filter-properties.png)


In the [Filter Editor](ui-elements/dialogs-and-wizards/filter-editor.md), specify the filter criteria. From the drop-down list select *Parameter* and create a new [query parameter](provide-data/working-with-sql-data-sources/pass-query-parameters.md) called **categoryQueryParam**:
In the [Filter Editor](../../ui-elements/dialogs-and-wizards/filter-editor.md), specify the filter criteria. From the drop-down list select *Parameter* and create a new [query parameter](../../provide-data/working-with-sql-data-sources//pass-query-parameters.md) called **categoryQueryParam**:

![Dashboard for Web - Filter Query](~/images/web-category-parameter-filter-cascading.png)
![Dashboard for Web - Filter Query](../../../../images/web-category-parameter-filter-cascading.png)

The resulting filter looks as follows:

```
[Products.CategoryID] = ?categoryQueryParam
```
3. [Bind](creating-parameters.md#specify-a-dynamic-value) the **categoryQueryParam** query parameter to the **categoryDashParam** dashboard parameter.
3. [Bind](creating-parameters.md#look-up-settings) the **categoryQueryParam** query parameter to the **categoryDashParam** dashboard parameter.
To do this, in the **Parameters** section of the [Query Builder](ui-elements/dialogs-and-wizards/query-builder.md) change the parameter’s type to *Expression*. Click the **Value** property’s ellipsis button to specify the dashboard parameter.
To do this, in the **Parameters** section of the [Query Builder](../../ui-elements/dialogs-and-wizards/query-builder.md) change the parameter’s type to *Expression*. Click the **Value** property’s ellipsis button to specify the dashboard parameter.
The query parameter settings look as follows:
![Dashboard for Web - Query Parameter Settings](~/images/web-category-query-parameter-setting.png)
![Dashboard for Web - Query Parameter Settings](../../../../images/web-category-query-parameter-setting.png)
4. Create a dashboard parameter called **productsDashParam** with dynamic list settings. Use the *Products* query as a data member and the *ProductID* field as a value member.
The parameter settings may look as follows:
![|Dashboard for Web - Create Dashboard Parameter](~/images/web-products-parameter-cascading.png)
![|Dashboard for Web - Create Dashboard Parameter](../../../../images/web-products-parameter-cascading.png)
5. [Filter](provide-data/working-with-sql-data-sources/filter-queries.md) the *OrderReports* query.
5. [Filter](../../provide-data/working-with-sql-data-sources/filter-queries.md) the *OrderReports* query.
To do this, click the **Edit** button next to the query on the **Data Sources** page of the [dashboard menu](ui-elements/dashboard-menu.md), then click **Run Query Builder**. In the invoked [Query Builder](ui-elements/dialogs-and-wizards/query-builder.md), click the ellipsis button next to the **Filter** field in the **Query Properties** section.
To do this, click the **Edit** button next to the query on the **Data Sources** page of the [dashboard menu](../../ui-elements/dashboard-menu.md), then click **Run Query Builder**. In the invoked [Query Builder](../../ui-elements/dialogs-and-wizards/query-builder.md), click the ellipsis button next to the **Filter** field in the **Query Properties** section.
In the [Filter Editor](ui-elements/dialogs-and-wizards/query-builder.md), specify the filter criteria. From the drop-down list select *Parameter* and create a new [query parameter](provide-data/working-with-sql-data-sources/pass-query-parameters.md) called **productsQueryParam**:
In the [Filter Editor](../../ui-elements/dialogs-and-wizards/query-builder.md), specify the filter criteria. From the drop-down list select *Parameter* and create a new [query parameter](../../provide-data/working-with-sql-data-sources/pass-query-parameters.md) called **productsQueryParam**:
![Dashboard for Web - Filter Query](~/images/web-products-parameter-filter-cascading.png)
![Dashboard for Web - Filter Query](../../../../images/web-products-parameter-filter-cascading.png)
The resulting filter looks as follows:
```
[OrderReports.ProductID] In(?productsQueryParam)
```
6. [Bind](creating-parameters.md#specify-a-dynamic-value) the **productsQueryParam** query parameter to the **productsDashParam** dashboard parameter.
6. [Bind](creating-parameters.md#look-up-settings) the **productsQueryParam** query parameter to the **productsDashParam** dashboard parameter.
To do this, in the **Parameters** section in the [Query Builder](ui-elements/dialogs-and-wizards/query-builder.md) change the parameter’s type to *Expression*. Click the **Value** property’s ellipsis button to specify the dashboard parameter.
To do this, in the **Parameters** section in the [Query Builder](../../ui-elements/dialogs-and-wizards/query-builder.md) change the parameter’s type to *Expression*. Click the **Value** property’s ellipsis button to specify the dashboard parameter.
The query parameter settings look as follows:
![Dashboard for Web - Query Parameter Settings](~/images/web-products-query-parameter-setting.png)
![Dashboard for Web - Query Parameter Settings](../../../../images/web-products-query-parameter-setting.png)
7. Create a Grid item to visualize data from the filtered *OrderReports* query.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,10 @@ This topic shows how to add a dashboard parameter and specify its settings in th

To create a dashboard parameter, follow the steps below.

1. Invoke the [dashboard menu](ui-elements/dashboard-menu.md) and select **Parameters**.
1. Invoke the [dashboard menu](../../ui-elements/dashboard-menu.md) and select **Parameters**.
2. In the **Parameter List**, click the **Add** button. The parameter's settings form appears as follows:

![Web Dashboard - Add a New Dashboard Parameter](~/images/img126106.png)
![Web Dashboard - Add a New Dashboard Parameter](../../../../images/img126106.png)

3. Specify the parameter's settings.

Expand All @@ -36,7 +36,7 @@ When you create and modify parameter names, follow the rules below:

Specifies the parameter description displayed in the **Parameter** column of the [Dashboard Parameters](requesting-parameter-values.md) dialog:

![Dashboard Parameter with Description](~/images/dashboard-parameter-description.png)
![Dashboard Parameter with Description](../../../../images/dashboard-parameter-description.png)

### Visible

Expand All @@ -50,8 +50,9 @@ Specifies whether a null value can be passed as a parameter value.

Specifies whether multi-selection is enabled for the current parameter.

[!include[allow-multi-select-limitation-parameters](~/templates/allow-multi-select-limitation-parameters.md)]

* Use the **Is any of** or **Is none of** operators to pass a multi-select parameter to a filter criteria or to the Expression format condition.
* Use the **In** or **Not In** operators to pass a multi-select parameter to a calculated field expression.

### Select All Values
Specifies whether all parameter values should be selected in the initial state of the dashboard.
Expand Down Expand Up @@ -86,30 +87,32 @@ Specifies the parameter's look-up editor settings.

The following **Look-up Settings** are available in the Web Dashboard:

No Look-Up
: An end user specifies the parameter value in the **Dashboard Parameters** dialog.
#### No Look-Up

An end user specifies the parameter value in the **Dashboard Parameters** dialog.

Static List
: An end user selects a parameter value from a static list. To add predefined parameter values, use the plus button.
#### Static List

An end user selects a parameter value from a static list. To add predefined parameter values, use the plus button.

Dynamic List
#### Dynamic List
: An end user selects a parameter value defined in a data source.
>[!TIP]
>You can also create cascading parameters in the Web Dashboard. For more information, refer to the following topic: [Cascading Parameters](create-cascading-parameters.md).
You can specify a data source as a source for dashboard parameter values. To provide access to data source values, specify the following options:

|UI Settings|Description|
|--------|-----------|
|**Data Source**| Specifies the data source for the dashboard parameter.|
|**Data Member**| Specifies the name of the data member with the parameter values for SQL and Entity Framework data sources.|
|**Value Member**|Specifies the name of the data field for the parameter values.|
|**Display Member** (optional)| Specifies the name of the data field displayed in the **Dashboard Parameters** dialog as a value description.|
|**Sort By** (optional)|Specifies the data member used to sort parameter values.|
|**Sort Order** (optional)|Specifies the sort order.|

>[!NOTE]
>You cannot use an OLAP data source as the data source for a dashboard parameter.
An end user selects a parameter value defined in a data source.

>[!TIP]
>You can also create cascading parameters in the Web Dashboard. For more information, refer to the following topic: [Cascading Parameters](create-cascading-parameters.md).
You can specify a data source as a source for dashboard parameter values. To provide access to data source values, specify the following options:

|UI Settings|Description|
|--------|-----------|
|**Data Source**| Specifies the data source for the dashboard parameter.|
|**Data Member**| Specifies the name of the data member with the parameter values for SQL and Entity Framework data sources.|
|**Value Member**|Specifies the name of the data field for the parameter values.|
|**Display Member** (optional)| Specifies the name of the data field displayed in the **Dashboard Parameters** dialog as a value description.|
|**Sort By** (optional)|Specifies the data member used to sort parameter values.|
|**Sort Order** (optional)|Specifies the sort order.|

>[!NOTE]
>You cannot use an OLAP data source as the data source for a dashboard parameter.
Loading

0 comments on commit b366a91

Please sign in to comment.