SEARCH SubSystem

ADEI has a modular search subsystem. The search capabilities are provided by the search engines which providing one-or-more search modules. Besides the search term, the search string may specify the search modules to perform search and number of limits to filter results. The module parameters could be specified along with the modules.

Format of search string

The search string consists of four components:

• The first component defines type of the search. Examples are item search, channel value search, datetime search.
• Second component provides some options. For example, demands exact or fuzzy match
• Third and fourth components are type-dependent and containing search string and additional limits

The format is as follows:

[type/module specification] [global flags] <search string> [limits]

Everything besides search string is optional. By default if the type is not specified, the search string is analyzed. Analysis routine guesses the type of search and executes a default set of modules for this type. The default behavior is to search for channel and group names. See String Analysis section for details.

The search type is specified in the curly brackets in the beginning of the search string. The search module available in the classes/search should be indicated (name of the class should be specified). Optional options for the class constructor could be indicated as well. If multiple modules are specified, the multiple searches are performed sequentially. The following format is expected:

{module_name(opt1=value1,opt=value2), another_module(...)}

The global options are going next to the search type and specified in the square brackets. This options then passed to the search modules with the search string and handled by the module code. The following options are supported:

• = - Exact match, for most modules this means what the search string is matched completely without splitting into the phrases
• w - Word match,
• ~ - Fuzzy match

Then the search string is follows. If the Exact match flag is not specified, it consists of the phrases.

Filters are implemented as classes

Implementation

The following procedure is executed for each module:

• Search function of Search Engine is executed with four parameters: module, search string, search filter, global options.
• GetList? function is called to get complete associative list of elements. In this list the key is element identificator and value contains an associative array with terms to check against the search terms
• CheckString? function is called on each element of the list, the elements for which the non-zero value is returned are added to the search results

The CheckString? is working in following way:

• The search string is splited in phrases and for each phrase CheckPhrase? function is called. *

Providing New Search Engine

INTERVALSearch Engine

Provided Modules:

• interval -

Supported Filters:

• interval

ITEMSearch Engine

Provided Modules:

• channel - Searches items by uid only
• item - Searches items by uid and name
• group - Searches groups by name
• mask - Searches masks by name
• control - Searches controls by uid only
• control_item - Searches controls by uid and name
• control_group - Searches control groups by name

PROXYSearch Engine

Provided Modules:

• proxy -

Supported Filters:

• interval

String Analysis