Dashboard - Parameters and Filters

modules/ROOT/content-nav.adoc

@@ -98,8 +98,8 @@ Generic Start
 *** xref:dashboards/visualizations/table.adoc[Table]
 *** xref:dashboards/visualizations/linechart.adoc[Line chart]
 *** xref:dashboards/visualizations/barchart.adoc[Bar chart]
-//** xref:dashboards/advanced-features/index.adoc[Advanced features]
-//*** xref:dashboards/advanced-features/parameters.adoc[Parameters and interactivity]
+** xref:dashboards/advanced-features/index.adoc[Advanced features]
+*** xref:dashboards/advanced-features/filters-and-parameters.adoc[Filters and parameters]
 //*** xref:dashboards/advanced-features/rule-based-styling.adoc[Rule-based styling]
 //*** xref:dashboards/advanced-features/report-actions.adoc[Report actions]
 //** xref:dashboards/integrations.adoc[Integrations]

modules/ROOT/pages/dashboards/advanced-features/filters-and-parameters.adoc

@@ -0,0 +1,87 @@
+= Filters and parameters
+:description: Use parameters in your dashboards to further customize queries or use them in filters for node and relationship properties.
+
+
+== Parameters
+
+Parameters are associated with a specific dashboard.
+Each parameter has a value and type both of which you can set initially. 
+
+Display the parameters of a dashboard by using the parentheses button to show the **Parameters** drawer.
+
+.The parameters drawer
+image::dashboards/parameters-drawer.png[]
+
+The drawer shows the dashboard parameters in alphabetical order.
+Each parameter has an icon next to it hinting at its data type:
+
+* A text icon for strings,
+* A hashtag icon for numbers,
+* A calendar icon for dates,
+* A filter icon for unspecified data types. 
+
+
+=== Creating a parameter
+
+. From the **Parameters** drawer, use the **Add** button.
+. In the dialog, enter a parameter name, select a data type and optionally an initial value for the parameter, then **Save**.
+
+
+=== Editing a parameter
+
+. From the **Parameters** drawer, hover over the parameter you wish to edit.
+. Use the pen button that appears.
+. In the dialog, edit the parameter name, data type and/or initial value, then **Save**.
+
+
+=== Using a parameter in a query
+
+To use a parameter in a query, use the parameter name prefixed with `$`, for example `$example_number_param` for the parameter with name "example_number_param".
+
+.Using a parameter in a query
+image::dashboards/parameter-in-query.png[]
+
+
+=== Deleting a parameter
+
+. From the **Parameters** drawer, hover over the parameter you wish to edit.
+. Use the trash bin button that appears.
+
+
+== Filters
+
+Filters are special xref:dashboards/working-with-dashboards/managing-dashboards.adoc#_dashboard_cards[cards] and you can add them to your dashboards in a similar fashion.
+
+You can use a filter to dynamically set parameter values inside queries. 
+
+
+== Adding a filter
+
+. In the **Dashboards** page, use **Add filter** at the bottom right.
+. In the **Add filter** dialog, select a filter type: a node or relationship type, and a property.
+. Use either an existing parameter or create a new one, then **Save**.
+
+
+== Editing a filter
+
+. In the **Dashboards** page, use the three dots icon of the filter you wish to edit and select **Edit filter**.
+. Edit your filter and **Save**.
+
+
+== Deleting a filter
+
+In the **Dashboards** page, use the three dots icon of the filter you wish to edit and select **Delete**, then confirm.
+
+
+//== Highlight all cards using a filter
+//
+//In the **Dashboards** page, use the target icon of a filter to highlight all cards that make use of this particular filter.
+
+// screenshot
+
+////
+== Use a filter in a card
+
+Lorem ipsum.
+////
+

modules/ROOT/pages/dashboards/advanced-features/index.adoc

@@ -1,4 +1,4 @@
 = Advanced features
-:description: The advanced features of Neo4j dashboards.
+:description: Advanced features of Neo4j dashboards.
 
-Coming soon.
+Explore the advanced features offered by Neo4j dashboards.

modules/ROOT/pages/dashboards/working-with-dashboards/managing-dashboards.adoc

@@ -12,13 +12,13 @@ In Neo4j Aura, click **Dashboards** under **Tools** in the left-side navigation
 
 == Editing a dashboard
 
-. Select a dashboard tile from the the **Dashboards** page.
+. Select a dashboard tile from the **Dashboards** page.
 . To change the title, select the title text and edit it, then confirm.
 
 
 === Dashboard pages
 
-Select a dashboard tile from the the **Dashboards** page.
+Select a dashboard tile from the **Dashboards** page.
 Dashboard pages are organized as tabs.
 A new dashboard contains a single page "Main page".
 You can edit or duplicate the page via hovering the page name and using the three dots icon.
@@ -28,13 +28,28 @@ Additional pages can also be deleted from the three dots menu.
 
 === Dashboard cards
 
-A dashboard page consists of cards.
+A dashboard page can hold any number of cards.
 Each card can hold a xref::/dashboards/visualizations/index.adoc[visualization], also referred to as the **Chart type**.
-To add a card, use **Add card* at the bottom right.
+To add a card, use **Add card** at the bottom right.
 Use the three dots at the top right of a card to edit the card.
 Click the six dots at the top left of a card to drag and drop it within the grid of the page.
 
 
+=== Dashboard filters
+
+A dashboard page can hold filters.
+A filter is a special type of card reserved for parameters used to filter data retrieved from your database.
+See xref:dashboards/advanced-features/filters-and-parameters.adoc#_filters[filters] for more information.
+To add a filter, use **Add filter** at the bottom right.
+Use the three dots at the top right of a filter to edit the filter.
+Click the six dots at the top left of a filter to drag and drop it within the grid of the page.
+
+
+=== Dashboard parameters
+
+See xref:dashboards/advanced-features/filters-and-parameters.adoc#_parameters[parameters].
+
+
 ////
 == Loading a dashboard