Show Search Text Option

< appboard | 2.6 | builder | widgets | options

The "Show Search Text" option is provided in most AppBoard Widgets. It allows the Widget administrator to provide a search box to the end-user. If the end-user enters a string in the search box, the data underlying the Widget will be temporarily filtered so that only records containing the text will be displayed. The resulting filter applies only to the Widget containing the search box, and not to any other Widgets, even if they are on the same Board and using the same Data Collection.


The search filter applies to all data in the record, even fields that are not currently displayed in the Widget.


1. Configure the Show Search Text Option

Perform the following steps to configure the Show Search Text Option for a Widget:


  1. Create a Widget and launch the Widget editor.
  2. On the Options tab, check the Show Search Text box.


2. Search Text Delay

A timer is used to defer search processing to avoid unnecessary updates between keystrokes. The timer duration is configurable and by default is set to 1.5 seconds.

To modify this value:

  1. Open [INSTALL_HOME]/server/webapps/enportal/visualizer/assets/config.xml
  2. A default entry should exist from 2.5.2 onwards, but if missing it can be added. Update the value which represents the milliseconds to delay:
    <attribute name="searchTextDelay" value="1500" />
  3. Save and reload the client to test, a server restart is not necessary.