Filter
*************

The widget enables the user to use a dashboard filters and change its value at run mode. To use this widget, the user need to first define filter on the dashboard. Then select a dashboard filter from the Filter Widget.
During run mode, the widget simply changes the value of the filter.

Widget setting 
===============

The following image shows an example of a widget setting.

\ |IMG1|\

It is possible to customize the widget settings from the inspector panel (in edit mode), as shown below:

+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
|Input value                    |Description                                                                                                                       |
+===============================+==================================================================================================================================+
|Title                          |Sets the title displayed for the widget                                                                                           |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
|Filter                         |A dropdown containing all the filters of current dashboard (defined in dashboard configuration)                                   |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
|Filter Values                  |It is used to add predefined values to the filter dropdown (to be shown in run mode)                                              |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------+

*Note: After selecting the filter from the dropdown, the system will pull and show the tag, value & default value of the filter.
``default value`` is set while defining the filter. ``value`` is set from the filter widget during run mode.
Default value would be used if value is empty or not set.*


Now Attribute Display widget is subscribed to MyFilter (tag: [station], value: 2) and its device is test/tarantatestdevice/[station].
More specifically its device is test/tarantatestdevice/2

\ |IMG2|\


During run mode, the Filter widget shows a dropdown with ``Filter Values`` and ``default value`` in its option.
This dropdown can be used to change the value of the filter in run mode.
This change will trigger a change to all the widgets subscribed to this filter.

For eg. in below dashboard, Attribute Display is subscribed to filter ``MyFilter``.
When MyFilter value is changed to **3** by Filter widget, the device field of Attribute Display widget changes to **test/tarantatestdevice/3**.
And its start pulling Power attribute value from it.

\ |IMG3|\


*Notice: Once user changes the value of a filter, it will result in a change of value for all the widgets subscribed to that filter.*

:doc:`/dashboard_filter` explain more about functioning of filters

During run mode, if required value is not present in filter widget dropdown then we can type and select that value from the dropdown.
See below image:

\ |IMG4|\


.. bottom of content

.. |IMG1| image:: _static/img/filter_widget_inspector.png
   :height: 292 px
   :width: 520 px

.. |IMG2| image:: _static/img/filter_runtime.png
   :height: 157 px
   :width: 276 px

.. |IMG3| image:: _static/img/filter_widget_runtime.png
   :height: 225 px
   :width: 441 px

.. |IMG4| image:: _static/img/filter_value_change.png
   :height: 157 px
   :width: 276 px