Before you begin: The following restrictions apply when selecting a property for optimization:

• You cannot optimize a transient property, because the column values would all be null.

• You cannot optimize properties in classes mapped to pr_other.

• You can only expose properties that are of a Single Value type.

To use the Property Optimization tool your environment must meet these prerequisites:

• Your access group must have the SchemaPropertyOptimization privilege.
• The dynamic system setting database/AutoDBSchemaChanges must be true.
• The Pega-RulesEngine agent System-Job-PropertyOptimizationpyOptimization must be enabled for background processing.
• The Data-Admin-DB-Name data instance named PegaRULES must identify the credentials, for either the primary database username and password, or the alternate Admin username and password, that allow the ALTER TABLE and CREATE TABLE functions for the database.

You can also use this tool to expose the values of an embedded property by automatically creating a concrete Index- class, properties for the new class, and a Declare Index rule that maintains the indexes. A background process creates the instances of the new Index- class.

When you meet the prerequisites you can use the Property Optimization tool using the Application Explorer. Note: Background processing to populate the new column data might take some time, depending on volume, and cause computations in your applications that cause the property value to fail or produce incorrect results until all background processing is complete.

You can view the classes for which a property has been optimized on the Advanced tab of the Property form. To optimize a selected property, complete the following steps.

1. Using the Application Explorer, enter the class for the property you want to optimize and then expand the Data Model node and the Property list.
2. Right-click a property name and click Optimize for reporting.
3. Select the tables in which you want to create a dedicated database column for this property. You must select at least one table.
4. If the property is embedded, specify the RuleSet and Version to contain the new Index- class, the properties in that class, and the Declare Index rule.
5. Select whether to optimize the property now or later. If you select later, click the calendar icon to select a date within seven days of the current date to optimize the property.
6. Click Next.
7. Review the tables to which the property column will be added and the classes that will be mapped to each table.
8. Click Next.
9. Click Finish.

Result: You can view the status of your background job by clicking ConfigureSystemDatabaseColumn Population Jobs.