Configuring categories for mobile search

Provide mobile app users with more comprehensive search results by limiting the scope of the search to the categories that you define. For example, you can add a search category that displays the name and email of a person that matches the search parameters.

When you configure search categories for mobile search, you reference data pages as sources for the categories. The mobile client pulls these references as large data pages and stores them in separate SQL tables to facilitate search.

Add the pyModificationDateTime and pyIsRecordDeleted properties to the data source of the data page that you want to use as the source for a search category so that the mobile client recognizes it as a large data page. For more information about using large data pages effectively, see Creating and sourcing large data pages to store large reference data in offline-enabled applications.
If you do not define any categories, the system searches all content in the Work- and Data- instances.
  1. In Dev Studio, search for and open the pySearchConfiguration rule.
  2. On the Editor tab, in the Search categories section, click Add category.
  3. Optional: To add a specific icon for the category, perform the following steps:
    1. In the new category row, click Select icon, and then click the Show image viewer icon.
    2. In the Image catalog window, enter an image name, and then click Find.
    3. Select an image that you want to use for the search category, click OK, and then click Submit.
  4. Optional: To set a new default icon for search categories, perform the following steps:
    1. In the Advanced section, click the Show image viewer icon.
    2. In the Image catalog window, enter an image name, and then click Find.
    3. Select the image that you want to use as default for new search categories, and then click OK.
  5. In the new category row, define the parameters of the search category:
    1. In the Source data page column field, enter the name of the data page that you want to use as the source.
      Enter the name of the data page that contains a list of contacts that you want to use as a source for the search.
    2. In the Category display name column field, enter the display name for the category.
      Enter Contacts as the category name.
    3. In the Title source property column field, enter a property that displays the title of the search result.
      Add the property that contains the name and surname of a contact.
    4. In the Description source property column field, enter a property that displays the description of the search result.
      Add the property that contains the email of a contact.
  6. Optional: To define an action that occurs when users click a search category item, perform the following steps:
    1. Click Configure action.
    2. Click Add an action > All actions, and then select an action that you want to use.
      Add the Open work by handle action that opens the object of the class by using a unique identifier.
    3. Specify additional settings for the action that you selected.
      In the Handle field, enter pzInsKey as the unique identifier for the Open work by handle action to enable users to display the contact details by clicking the search result.
      For more information, see Available actions and conditions.
    4. Click Submit.
  7. Optional: To add more categories to the list, repeat steps 2 through 6.
  8. Click Save.
When the users of your mobile app perform a search, the app displays the results grouped by the categories that you defined. Each result has a title and a description that help users choose the best search result.