Enabling global search for use in an application


End users can use the global search functionality to perform search operations within an application. Global search checks multiple forms for records that match a word or phrase that users type in the search area. 

In addition, it leverages the full text search functionality and searches all fields that have the Full Text Search (FTS) property enabled. For example, if you have multiple record definitions with multiple fields that are FTS-enabled, the global search searches all those fields. 

By default, the Global search option is disabled. You must configure the global search and enable it. 

Before you begin

  • Make sure to enable full text search in fields. For more information, see To enable full text search in fields.
  • Your application must consist of the following elements:
    • Record definition that consists of at least one text field that has the FTS property enabled (search field). You can create multiple record definitions to include in the search.
    • View definition that consists of the record editor component for each record definition that includes search fields. The view needs to have an input parameter that is bound to the ID of the record from the search results, and the Record ID of the record editor should point to that view parameter.

To configure global search 

  1. Log in to the BMC Helix Innovation Studio and navigate to the Workspace tab.
  2. Select the application, and click Navigation.
  3. On the canvas, select the navigation bar, on the Properties tab, select the Enable global search check box.
  4. Click Configure results view.
  5. On Configure results view, add the records to include in the search result, select the view from the Display View When Clicked list.
  6. Click Save.

The following image shows a sample search result with the default configuration:

22_1_Sample search result_default config.png

The annotations in the image are described in the following table:

Annotation

Description

1

Search string used to perform the search.

2

Search results are stored in the order of relevancy. You can use the filter to specify the record definitions that should be included in the search results.

3

Search results have the following format:

  • The record definition name is displayed as static text.
  • The ID is displayed as a clickable link, which when clicked, navigates to the view that is set for the record definition in default search view properties.
  • The second line displays the title of the result.
  • The third line is the hit for the search match. The exact search string is highlighted.

4

Search results are sorted in descending order by relevancy.

5

By default, the first 50 search results are displayed. The search page uses an infinite scroll pattern. When you scroll down, the page loads a chunk of 50 additional search results at the bottom of the page.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*