-
Notifications
You must be signed in to change notification settings - Fork 65
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
github-actions
committed
Sep 25, 2024
1 parent
55b8352
commit 683ddd4
Showing
63 changed files
with
3,179 additions
and
2,161 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
165 changes: 165 additions & 0 deletions
165
...hboard-designer/data-analysis/using-dashboard-parameters/create-cascading-parameters.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,165 @@ | ||
<!DOCTYPE html> | ||
<html> | ||
<head> | ||
<meta charset="utf-8"> | ||
<title>Cascading Parameters | DevExpress End-User Documentation </title> | ||
<meta name="viewport" content="width=device-width, initial-scale=1.0"> | ||
<meta name="title" content="Cascading Parameters | DevExpress End-User Documentation "> | ||
|
||
|
||
<link rel="icon" href="../../../../../favicon.ico"> | ||
<link rel="stylesheet" href="../../../../../public/docfx.min.css"> | ||
<link rel="stylesheet" href="../../../../../public/main.css"> | ||
<meta name="docfx:navrel" content="../../../../../toc.html"> | ||
<meta name="docfx:tocrel" content="../../../../toc.html"> | ||
|
||
<meta name="docfx:rel" content="../../../../../"> | ||
|
||
|
||
<meta name="docfx:docurl" content="https://github.com/DevExpress/dotnet-eud/blob/24.1/dashboard-for-desktop/articles/dashboard-designer/data-analysis/using-dashboard-parameters/create-cascading-parameters.md/#L1"> | ||
<meta name="loc:inThisArticle" content="In this article"> | ||
<meta name="loc:searchResultsCount" content="{count} results for "{query}""> | ||
<meta name="loc:searchNoResults" content="No results for "{query}""> | ||
<meta name="loc:tocFilter" content="Filter by title"> | ||
<meta name="loc:nextArticle" content="Next"> | ||
<meta name="loc:prevArticle" content="Previous"> | ||
<meta name="loc:themeLight" content="Light"> | ||
<meta name="loc:themeDark" content="Dark"> | ||
<meta name="loc:themeAuto" content="Auto"> | ||
<meta name="loc:changeTheme" content="Change theme"> | ||
<meta name="loc:copy" content="Copy"> | ||
<meta name="loc:downloadPdf" content="Download PDF"> | ||
|
||
<script type="module" src="./../../../../../public/docfx.min.js"></script> | ||
|
||
<script> | ||
const theme = localStorage.getItem('theme') || 'auto' | ||
document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light') : theme) | ||
</script> | ||
|
||
<!-- Matomo Tag Manager --> | ||
<script> | ||
var _mtm = window._mtm = window._mtm || []; | ||
_mtm.push({'mtm.startTime': (new Date().getTime()), 'event': 'mtm.Start'}); | ||
var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; | ||
g.async=true; g.src='https://matomo.devexpress.com/js/container_kE7MWPi0.js'; s.parentNode.insertBefore(g,s); | ||
</script> | ||
<!-- End Matomo Tag Manager --> | ||
</head> | ||
|
||
<body class="tex2jax_ignore" data-layout="" data-yaml-mime=""> | ||
<header class="bg-body border-bottom"> | ||
<nav id="autocollapse" class="navbar navbar-expand-md" role="navigation"> | ||
<div class="container-xxl flex-nowrap"> | ||
<a class="navbar-brand" href="../../../../../index.html"> | ||
<img id="logo" class="svg" src="../../../../../logo.svg" alt="DevExpress EUD"> | ||
DevExpress EUD | ||
</a> | ||
<button class="btn btn-lg d-md-none border-0" type="button" data-bs-toggle="collapse" data-bs-target="#navpanel" aria-controls="navpanel" aria-expanded="false" aria-label="Toggle navigation"> | ||
<i class="bi bi-three-dots"></i> | ||
</button> | ||
<div class="collapse navbar-collapse" id="navpanel"> | ||
<div id="navbar"> | ||
<form class="search" role="search" id="search"> | ||
<i class="bi bi-search"></i> | ||
<input class="form-control" id="search-query" type="search" disabled="" placeholder="Search" autocomplete="off" aria-label="Search"> | ||
</form> | ||
</div> | ||
</div> | ||
</div> | ||
</nav> | ||
</header> | ||
|
||
<main class="container-xxl"> | ||
<div class="toc-offcanvas"> | ||
<div class="offcanvas-md offcanvas-start" tabindex="-1" id="tocOffcanvas" aria-labelledby="tocOffcanvasLabel"> | ||
<div class="offcanvas-header"> | ||
<h5 class="offcanvas-title" id="tocOffcanvasLabel">Table of Contents</h5> | ||
<button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#tocOffcanvas" aria-label="Close"></button> | ||
</div> | ||
<div class="offcanvas-body"> | ||
<nav class="toc" id="toc"></nav> | ||
</div> | ||
</div> | ||
</div> | ||
|
||
<div class="content"> | ||
<div class="actionbar"> | ||
<button class="btn btn-lg border-0 d-md-none" type="button" data-bs-toggle="offcanvas" data-bs-target="#tocOffcanvas" aria-controls="tocOffcanvas" aria-expanded="false" aria-label="Show table of contents"> | ||
<i class="bi bi-list"></i> | ||
</button> | ||
|
||
<nav id="breadcrumb"></nav> | ||
</div> | ||
|
||
<article data-uid=""> | ||
<h1 id="cascading-parameters">Cascading Parameters</h1> | ||
|
||
<p>Create cascading parameters to filter a list of predefined parameter values based on another parameter's values. The following image illustrates cascading parameters where the <strong>pProducts</strong> parameter values are filtered by the selected category:</p> | ||
<p><img src="../../../../images/cascading-parameters-winforms.gif" alt="Dashboard for WinForms - Cascading Parameters"></p> | ||
<p>In case of two parameters, the first parameter is used to filter the data source for the second parameter with <a href="creating-parameters.html#dynamic-list">dynamic list</a> settings.</p> | ||
<h2 id="create-cascading-parameters">Create Cascading Parameters</h2> | ||
<p>The dashboard in this example is connected to a Northwind database (an SQL Database) and contains three <a href="../../work-with-data/manage-sql-queries.html">queries</a>: <em>Categories</em>, <em>Products</em>, and <em>OrderReports</em>. The Grid item visualizes data from the <em>OrderReports</em> query.</p> | ||
<p>In this tutorial, you will create two dashboard parameters:</p> | ||
<ul> | ||
<li>The <strong>pCategory</strong> parameter filters the <em>Products</em> query. The <em>Products</em> query is a data source for the <strong>pProducts</strong> parameter.</li> | ||
<li>The <strong>pProducts</strong> parameter filters the <em>OrderReports</em> query.</li> | ||
</ul> | ||
<p>The steps below create cascading parameters in the WinForms Dashboard Designer:</p> | ||
<ol> | ||
<li><p>Create a dashboard parameter called <strong>pCategory</strong> with dynamic list settings. Use the <em>Categories</em> query as a data member and the <em>CategoryID</em> as a value member.</p> | ||
<p>The parameter settings may look as follows:</p> | ||
<p><img src="../../../../images/category-parameter-cascading.png" alt="Dashboard for WinForms - Create Dashboard Parameter"></p> | ||
</li> | ||
<li><p>Use the created <strong>pCategory</strong> parameter to <a href="../../work-with-data/filter-queries.html">filter</a> the <em>Products</em> query.</p> | ||
<p>To do this, invoke the <a href="../../work-with-data/using-the-query-builder.html">Query Builder</a> and click the <strong>Filter...</strong> button to specify the filter criteria in the <strong>Filter Editor</strong>. Choose the <strong>Bind To</strong> option to automatically bind a <a href="../../work-with-data/pass-query-parameters.html">query parameter</a> to the created dashboard parameter:</p> | ||
<p><img src="../../../../images/category-parameter-filter-cascading.png" alt="Dashboard for WinForms - Filter Query"></p> | ||
<p>The resulting query looks as follows:</p> | ||
<pre><code>[Products.CategoryID]=?pCategory | ||
</code></pre> | ||
</li> | ||
<li><p>Create a dashboard parameter called <strong>pProducts</strong> with dynamic list settings. Use the <em>Products</em> query as a data member and the <em>ProductID</em> as a value member.</p> | ||
<p>The parameter settings may look as follows:</p> | ||
<p><img src="../../../../images/products-parameter-cascading.png" alt="Dashboard for WinForms - Create Dashboard Parameter"></p> | ||
</li> | ||
<li><p>Use the <strong>pProducts</strong> dashboard parameter to filter the <em>OrderReports</em> query.</p> | ||
<p>To do this, invoke the <a href="../../work-with-data/using-the-query-builder.html">Query Builder</a> and click the <strong>Filter...</strong> button to specify the filter criteria in the <strong>Filter Editor</strong>. Choose the <strong>Bind To</strong> option to automatically bind a <a href="../../work-with-data/pass-query-parameters.html">query parameter</a> to the created dashboard parameter:</p> | ||
<p><img src="../../../../images/products-parameter-filter-cascading.png" alt="Dashboard for WinForms - Filter Queries"></p> | ||
<p>The resulting query looks as follows:</p> | ||
<pre><code>[OrderReports.ProductID] In ?pProducts | ||
</code></pre> | ||
</li> | ||
<li><p>Create a Grid item to visualize data from the filtered <em>OrderReports</em> query.</p> | ||
</li> | ||
</ol> | ||
<div class="TIP"> | ||
<h5>Tip</h5> | ||
<p>When using a <a href="creating-parameters.html#allow-multiselect">multi-value</a> parameter to filter a query, create the condition with the <code>Is any of</code> or <code>Is none of</code> operator.</p> | ||
</div> | ||
|
||
</article> | ||
|
||
<div class="contribution d-print-none"> | ||
<a href="https://github.com/DevExpress/dotnet-eud/blob/24.1/dashboard-for-desktop/articles/dashboard-designer/data-analysis/using-dashboard-parameters/create-cascading-parameters.md/#L1" class="edit-link">Edit this page</a> | ||
</div> | ||
|
||
<div class="next-article d-print-none border-top" id="nextArticle"></div> | ||
|
||
</div> | ||
|
||
<div class="affix"> | ||
<nav id="affix"></nav> | ||
</div> | ||
</main> | ||
|
||
<div class="container-xxl search-results" id="search-results"></div> | ||
|
||
<footer class="border-top text-secondary"> | ||
<div class="container-xxl"> | ||
<div class="flex-fill"> | ||
Copyright (c) 1998-2024 Developer Express Inc. All rights reserved. | ||
</div> | ||
</div> | ||
</footer> | ||
</body> | ||
</html> |
Oops, something went wrong.