Enabling classes for search indexing
On the Search landing page, for default indexes, you can configure which classes and class instances to index. You can also configure whether to index the contents of attachments. Enable attachment indexing only if your applications provide full-text search of work items. PDF, Microsoft Office, and text attachments are indexed and will be full-text searchable. However, if your application saves work item file attachments in an external enterprise content management system that is accessed through Connect CMS rules, such file attachments are not included in Pega Platform search results.
On the Search landing page, you can also specify the maximum size of attachments to index. Attachments that exceed the threshold are not indexed and are listed in the log file.
You can configure indexing while a Pega Platform server node is operating, however index processing can affect system performance if the indexes are large. As a best practice; choose a time when the server is less busy to perform these one-time processor-intensive operations.
In the header of Dev Studio, click.
In the Search indexing section, click Default.
Toggle Enable indexing.
Select any of the check boxes in front of the class types to enable indexing for that class:
You can skip indexing of specific class instances by clicking Exclude this class from search? on the Advanced tab of the Class form. Excluded instances will not be included in search results.
- Select All rules to turn on indexing for all Rule- classes.
- Select All data to turn on indexing for all
Data- classes.Data- class requires a specified ruleform for indexing.
For more information, see Advanced tab on the Class form
- Select All work to turn on indexing for all Work- classes. Note that work object search is not available in Dev Studio.
Select Index attachments to index attachments.
In the Attachments threshold (MB) field, adjust the maximum size of attachments to be indexed by entering a value, in megabytes.
Click Save Settings.
- Excluding properties with access control policies from search results
You can include or exclude properties with access control policies from search results, which lets you control who can view sensitive data. When you select the option to display properties with access control policies, access control policies are ignored. When you do not select the option to display properties with access control policies, properties with access control policies are excluded from search results, whether or not the access control policies are satisfied.
- Specifying custom search properties
You can specify additional properties to include in the search index for a class by creating a custom search property data instance. Including properties in the search index enables you to reference them and use them in filters in report definition rules that query the search indexes.
- Creating dedicated indexes
Dedicated indexes are property type-aware, per-class indexes that return the data type of each returned property. Default indexes are typeless, that is, all properties are of type string. Dedicated indexes let you execute queries with filters, date calculations, and aggregations directly in the query. Dedicated indexes are displayed on the Search landing page in the Dedicated indexes section.
- Configuring a report definition to run against an Elasticsearch index
To improve report generation performance, you can run report definitions against Elasticsearch indexes instead of using SQL queries directly against the database. Running report definitions against Elasticsearch indexes is disabled by default and does not apply to reports that have features that are not supported by Elasticsearch. If a report query cannot be run against Elasticsearch indexes, Pega Platform automatically uses an SQL query.