This widget belongs to the EasyVista category in the widget library. Connected to one or more data sources linked to , it enables you to filter data using a dynamic search field linked to one or more columns in the data source. 

• The search is run on  menu items, in discussions and in the knowledge base.
• The widget applies the search criteria to the different data sources simultaneously.
• You can define an app page specifically for displaying search results.

Notes

   See General remarks on widgets.

• The widget can point to the following data sources:
  • EasyVista: Search run on  menu items.
  • EasyVista Knowledge Base: Search run in the knowledge base.
  • EasyVista Discussions: Search run in discussions.
• You can select up to five search fields in each data source linked to the widget. The list of columns in the data source that can be used as search criteria is defined by . You cannot modify it.
• In execute mode, the search will apply to all widgets in the app using the same EasyVista data sources as the those defined for the Search Filter widget, e.g. Dashboards widget or Data Viewer widget.

Best practice

• You should use the Search Filter widget to enable users to filter  data using a dynamic search field and a Filter List widget to enable users to consult the data using a list of dynamic filters. You can combine these two widgets when they are both linked to the same EasyVista data source.
• You can modify the graphic properties of the different widget elements, e.g. font, size, alignment, or color, using the Theme section and the Theme > Search section for the overall configuration.

Examples

• Run a search in the employee directory using several search criteria, e.g. login, email, function and department.
           

• Run a search using several data sources.
  

  (1) Bar Chart and Data Viewer widgets pointing to an EasyVista data source called All Problems. (2) Data Viewer widget pointing to an EasyVista data source called All Incidents.

  Search using the Open filter for all records from both data sources.

Example2

• Run a search combining a Search Filter widget and a Filter List widget pointing to the same EasyVista data source.

Enter the keyword, failure, to search for incidents using the Search Filter widget (1). The Bar Chart widget and Data Viewer widget pointing to the same EasyVista data source will automatically be refreshed.	Select the Open filter in the list of incidents to display only those that are open using the Filter List widget (2). Both widgets will automatically be refreshed.

Example2_End

List of properties

Content

DeviceNativeStyle

Box is checked (smartphone mode: Android or iPhone)	Box is not checked (standard mode)

SearchPlaceholder

Clear Search Input: Used to indicate (box is checked) or not (box is not checked).

Target Page: Page defined specifically for displaying search results.

• Click  to open the page in the Design pane.
• Click  to cancel the page selection.

Data Source And Fields: List of data sources and fields where the search will be run.
         

• To add a data source, click [ ADD ITEM ].
•  : Used to modify or view the contents of the data source.
•  : Used to remove the data source. All previously selected fields will be cleared from the search criteria.
•  : Used to modify the order of data sources when running the search.

• Search Fields: List of data source columns in which records are searched.
  • Click  to delete one of the selected columns.

Theme

 See the description of properties.
 

Display	Configurable element	Properties to specify
	(1) Background color of the widget	General properties > Background Color list 2
	(2) Background color of the search field	General properties > Background Color list 1
	(3) Rounded corners of the search field	Search section > Radius Note: Apply a radius of 0 if you want a border with right angles.
	(4) Search icon Note: The search icon is defined by . You cannot modify it.	Search section Icon Size: Size of the icon Search Icon Color: Color of the icon Search Icon Background Color: Background color of the icon
	(5) Text displayed in the search field when the page is opened	General properties > Element = PlaceHolder
	(6) Font color during data entry	General properties > Element = Text Before Search
	Display after the search is run (7) Font color (8) Background color of the search field	General properties > Element = Text After Search

Procedure: How to implement a Search Filter widget

1. In the drop-down list found below the Data Source And Fields property, select the EasyVista data source from which you want to select the widget's search criteria.

2. Click Search Fields and select each data source field to be used as a search criterion. Click  next to the name to delete one of them.

3. If you want to run a search on data from another data source, click [ ADD ITEM ] and select the relevant data source and its fields.

4. Define the graphic properties of the widget by selecting the required elements in the Theme section.

5. Define the widgets for displaying the search results. If you want to insert them in a different page, select the page from the Target Page list.

6. Switch to execute mode and check the workability of the widget.