Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
The Global Search global search allows users to search for the information with specific word parts, information by words, parts of words, and even phrases.
not applyBefore sending a query to the database, the search engine gets the available Search Groups along with the portal URL if it is specified. Within each group, when the search query performs is performed through the Search Table included, they are checked by the against the ACL Rules, and then through the Search Indices. ThusThus, the query processing is processed, and the result outputting results are performed displayed only by for the fields available to a particular user.
.
Tip |
---|
Role required: admin. |
Search configuration guide
title | To index table columns, follow the steps below: |
---|
To configure global search in the agent interface, complete
To index table columns, followthe steps below:
- Create a
- search group.
- Create
- a search table.
Configure search indices.
To configure global search on the self-service portal, complete the same steps, but select the required portal in the Portal field of the Text search group form.
Note |
---|
If there are no active records in the Text Search Group (ts_group) or Text Search Table (ts_table) tables, the search is not performed portal users with the Search Groups settings. |
Create a
Search Grouptext search group
The search groups are intended to categorize tables by in which the search is performed.
To create a search group, follow complete the steps below:
- Navigate to System Definition Settings → Text Search Groups.
- Click New and fill in the fields.
- Click Save or Save and Exitexit to apply the changes.
Search Group formText search group form fields
Field | Mandatory | Description |
---|---|---|
Name | Y |
Specify the name of |
the group displayed in the search results panel. | |
Portal | N |
Select a portal to make the search group available |

to its users. The search group |
will only be available on the selected Portal. To make the search |
group available in the agent interface, leave this field empty. | ||
Order | N | Enter |
an integer |
to set the relative position of the group in the search results |
panel. Groups are displayed in ascending order. | |
Description | N |
Add a description of the search group. | |
Active | N |
Select this checkbox |
to make the group available and visible |
to users in the search results panel. | |
Opened by default | N |
Select this checkbox |
to make the group |
expanded by default in the search results |
Image Removed
Default group configuration
The out-of-the-box tables categorization is provided as listed below:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
= Tasks:
Change Request
Change Task
Incidents
Incident Task
Inquiry
Service Request
Requests Task
= People & Companies:
Employee
Company
= Configuration:
Business Rule
Client Script
UI Action
ACL
Includes Script
Notification Rule
Dynamic Filter
Scripted Related List
Widget
Property
= Knowledge Base:
Articles
= CMDB:
Configuration item |
That is, your search request is processed against these tables, and the result may look as shown on the screenshot in the table above.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
= Task
= Knowledge Base |
Create a Search Table
panel. |
Create a text search table
Search Search tables specify data sources for text search indexing. Within the groups, these tables also collect the search results, determining its their categories. The system property search_text_service.excluded_tables allows you to specify tables not appeared as options when setting up the Search tables.
To create a search table, follow complete the steps below:
- Navigate to System Definition Settings → Text Search Tables.
- Click New and fill in the fields.
- Click Save or Save and Exitexit to apply the changes.
Search Table Text search table form
Field | Mandatory | Description |
---|---|---|
Name | Y | Enter the name of |
the table displayed in the search results panel. | |
Table | Y |
Select the source table |
that contains data indexed for search. |

Assign a group to the table for displaying the search results.
| ||||
Search group | Y | Select a search group in which the table search results will be displayed. | ||
Displayed fields | N | Select the table fields to display in the search results if the values in those fields match the search query.
| ||
Subinfo fields | N | Select the table fields that are always displayed in the search results. | ||
Filter | N | Use the condition builder to filter and sort the search results |

. | ||
Order | N | Enter |
an integer |
to |
set the relative position of the table within its search group. The tables are displayed in |
ascending order. | |
Active | N |
Select this checkbox |
to |
activate the search table |
and make it visible |
Configure Search Indices
The Search Indices table contains every value of the columns indexed that are automatically added to the table after the search tables records creation. The search is performed through these search indices.
to the users in the search results. |
Default search groups and tables
The following search groups and tables are configured out-of-the-box:
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Configure search indices
The Search Indices (sys_search_index) table contains text values of the indexed columns. These values are used for the global search. The records in this table are automatically created when a new record is created in a table containing an indexed column. Empty fields are ignored.
Note |
---|
You cannot create, edit, or delete records in the Search Indices |
Note |
Only users with the admin role can read the Search Index (sys_search_index) table records. Only users with the admin role can read them. |
To make index a table column indexed, follow complete the steps below:
The reference columns are also available for search indexing. The system adds to the Search Indices table the reference table column values that are marked with the Display by Ref flag.
To make a reference column indexed, follow the steps below:
- Navigate to System Definition → Settings → All Columns.
- Open the desired Column record of your search table. Use filter options or Condition Builder if you need to find Find the required column in the list and open it.
On the record formrecord form, set select the Full Text Search checkbox to the active state.
Note The Search Indexes include only those records that were created after enabling the Full Text Search option of the table column.
Image Removed
- Click Save or Save and Exit to apply changes. Subsequently, the system will automatically add the field values of this table column to Search Indices when creating new table records.
title | Reference column indexing |
---|
If the column is of the Reference type, ensure that the Display by ref checkbox is selected. If not, select it. Otherwise, the column values will not be indexed.
- Click Save or Save and
- exit to apply the changes.
To create a search index, follow the steps below:
As a result:
- All existing records are indexed.
- All new records will be indexed when they are created
- .
Search Index form fields
Field |
---|
Description | |
---|---|
Record |
The ID of the record that contains the indexed field. |
Table |
/
Reference to the table that contains the indexed column. | |
Column | Reference to the indexed column of the Table. |
Text | The text value of the indexed field. It is automatically updated if the value of the indexed field changes. |
Table of Contents | ||||||
---|---|---|---|---|---|---|
|