Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Understanding rule warning messages

Updated on May 7, 2019

Question

A developer asks: What is the significance the warning messages that appear at the bottom of the form when I save a rule?

When you save a rule form and a warning message appears, one or more warning conditions were detected. Warning conditions do not prevent the rule from saving or working correctly. Warning conditions identify unexpected and possibly unintended situations, practices not recommended, or variances from best practices. Consult the messages for details on the cause of the condition.

Ideally, you can revise the rule or other rules to remove the condition, which may improve performance, maintainability, user productivity, or usability.

Using the Application Preflight tool to report on warnings

Use the Application Preflight tool to list each rule in an application that contains a warning message. The tool reports the results of several checks on the rules in your application RuleSets and the currently selected work pool name.

To the start the tool:

  1. Click the link containing your name at the top of the navigation panel to see the profile display. Review the area titled Application RuleSets to confirm which RuleSets are to be checked by this tool.
  2. Select Application > Preflight. Here is an example of the first chart that appears.
  3. Click All Warnings by Rule Type to open the same chart and a summary report.
  4. Click a Rule Type item in the report to open a list report of the rules with warnings.

    Here is an example list report of Rule Type: Section.
  5. Click on a rule instance (FlowActionHTML in this example) to open the rule form and view the warning message:

High priority warnings

Performance and DataIntegrity warning types are considered to be high priority. They are most likely to degrade system reliability by slowing performance or by violating data integrity. You should correct the warning conditions before you put the rules into a production environment.

If you are using v5.4 sp2 or greater, you can create and download a list report of these warning to an Excel spreadsheets by selecting Download High Priority Warnings in the tool. You can also use this option to create spreadsheets containing all warning types (by access group). The Excel spreadsheet includes links to this article. For more information, see PRKB 25497— How to download a list of high priority rule warnings.

About this article

This article contains a list of rules types and their related warning types. High priority warnings are listed first. Each entry contains the following information:

  • Rule Type
  • Warning Type
  • Name
  • Message
  • Details
  • Severity

Each high priority warning (Performance and DataIntegrity) contains a link to a PDN article, which contains additional diagnostic and troubleshooting information.

Technical note: Process Commander provides a set of CheckForWarnings activity instances, which apply to specific work types (for example, Rule-Declare-Expressions.CheckForWarnings). The activity uses uses a Java method that calls parameters in the addWarning function. The parameter values provide the content of one or more warnings including warning type, warning name, warning message, warning details, and severity. You can create custom warnings as described in PRKB-21872 How to create a rule warning.

Note: Severity is not correlated to priority. There are four severity levels, Severity 1 being the most serious. When remediating warning conditions, it is suggested that you first correct high priority warnings, followed by Severity 1, Severity 2, and so on.

Answer

 

High Priority Warning List

Rule TypeWarning Type
Rule-Performance
NamePRPC_CircumstanceIndexWarning
Message

Can't create Circumstance Index because the following column(s) can't be created: <column name(s)>

Alter table pr_index_circumstance_def. Add   <column name><data type>

Details

(Database-specific message explaining reason for warning condition.)

Severity2

 

Rule TypeWarning Type
Rule-Circumstance-DefinitionPerformance
NamePRPC_CircumstanceIndexWarning
Message

Can't create Circumstance Index because the following column(s) can't be created: <column name(s)>

Alter table pr_index_circumstance_def. Add   <column name><data type>

Details(Database-specific message explaining reason for warning condition.)
Severity2

 

Rule TypeWarning Type
Rule-Declare-ExpressionsPerformance
NameContext Free
Message

For best performance, avoid defining expressions that execute regardless of page context

DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Declare-ExpressionsPerformance
NameWhenever Used
MessageFor best perfomance, avoid the Whenever Used option for change tracking.
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Obj-FlowActionPerformance
NameUsing Whens with Bulk Processing
MessageCheck 'Disqualify this action from bulk processing' whenever you specify Whens to improve the performance of showing the list of bulk processing assignments
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-ListViewPerformance
NameCase Insensitive
MessageCase Insensitive search operation can adversely impact performance.To improve performance create functional index using UPPER() function on the columns that need case insensitive search.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-ListViewPerformance
NameNot column or scalar
Message

These properties are neither database columns nor scalar properties in database tables and can adversely impact performance: <.property (in database table)>.

Read-only mode can not be used.

Details

<n> properties

where n equals the number of properties within a given database table that are causing the warning condition.

Severity2

 

Rule TypeWarning Type
Rule-Obj-ListViewPerformance
NameNot restrictive JOIN condition
MessageOne or more JOIN conditions potentially lead to cartesian product of tables and can adversely impact performance.
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Obj-SummaryViewPerformance
NameCase Insensitive
MessageCase Insensitive search operation can adversely impact performance.To improve performance create functional index using UPPER() function on the columns that need case insensitive search.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-SummaryViewPerformance
NameNot column or scalar
MessageThese properties are neither database columns nor scalar properties in database tables and can adversely impact performance: < .propertyin database table>.

Read-only mode can not be used.

Details

<n> properties

where n equals the number of properties within a given database table that are causing the warning condition.

Severity2

 

Rule TypeWarning Type
Rule-Obj-SummaryViewPerformance
NameNot restrictive JOIN condition
MessageOne or more JOIN conditions potentially lead to cartesian product of tables and can adversely impact performance.
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Declare-IndexDataIntegrity
NameNamed Page Reference
Message

If you reference a named page as a source within a Rule-Declare-Index, the value will be correctly read and populate the index. However, changes to that property on the named page will not trigger re-indexing.

DetailsN/A
Severity2

 

 

Rule TypeWarning Type
Rule-Declare-TriggerDataIntegrity
NameNot Trigger Activity
MessageTo ensure transaction integrity, specify an activity that has its type defined as Trigger.
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Obj-ActivityDataIntegrity
NameCommit
MessageUse of the Commit method should be carefully considered to insure data integrity. In most cases, you will want to allow PRPC to handle committing a transaction.
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Obj-ActivityDataIntegrity
NameWrite Now
MessageUse of the write now option should be carefully considered to insure data integrity. In most cases, you will want to allow PRPC to handle committing a transaction.
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Declare-ExpressionsAccidental system damage (DataIntegrity)
NameCannot be a Declarative Target
MessageThe property <target property> cannot be the target of an expression.
DetailsN/A
Severity2

 

 

Standard Priority Warning List

Rule TypeWarning Type
Data-Admin-Connect-Functionality
NameRequestor Login
MessageRequires Authentication in < ServicePackage> Service Package is checked. Please provide Requestor Login user details to do Authentication.
Details

<n> properties

where n equals the number of properties that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Data-Admin-Connect-JMSListenerFunctionality
NameEtier deployment
MessageThis JMS listener is available only when PRPC is deployed as a Web application.
Details

<n> properties

where n equals the number of properties that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Data-Admin-Connect-JMSListenerLogic
NameMessaging Model
MessageYou have configured response for Publish and Subscribe
DetailsN/A
Severity3

 

Rule TypeWarning Type
Data-Admin-Connect-JMSListenerLogic
NameReference Format
MessageResponse destination reference must start with 'java:/comp/env'
DetailsN/A
Severity1

 

Rule TypeWarning Type
Data-Admin-Connect-JMSMDBListenerFunctionality
NameEtier Deployment
MessageThis JMS MDB listener is available only when PRPC is deployed as an Enterprise application.
Details

<n> properties

where n equals the number of properties that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Data-Admin-Connect-JMSMDBListenerLogic
NameReference Format
MessageResponse destination reference must start with 'java:/comp/env'
DetailsN/A
Severity1

 

Rule TypeWarning Type
Data-Admin-Connect-MQListenerFunctionality
NameEtier Deployment
MessageThis MQ listener is available only when PRPC is deployed as a Web application.
Details

<n> properties

where n equals the number of properties that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Data-Admin-Operator-AccessGroupDeprecated
NameProdRSEntryNotInApp
Message

The Production RuleSet entry <RuleSet name> does not exactly match <RuleSet name>,defined in the Application <application name, application version>

Future releases will not support this configuration.

For details, see KB 25289 - How to configure production RuleSets and WorkPools.

DetailsN/A
Severity1

 

Rule TypeWarning Type
Data-Admin-Operator-AccessGroupDeprecated
NameWork Pool Not From Application
Message

The workpool <workpool name> is part of the RuleSet <RuleSet name>, which is not included in the Application RuleSets portion of the < application name, application version> definition. Future releases will not support this configuration.

For details, see KB 25289 - How to configure production RuleSets and WorkPools

DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Agent-QueueBestPractice
NameWhenever Used
MessageOne or more agents are in Legacy Mode. For more information, see KB 25050 How to upgrade a Legacy-mode agent.
DetailsN/A
Severity4

 

Rule TypeWarning Type
Rule-ApplicationCompatibility
NameCompatibility
MessagePlease note that Place properties on thread pages only checkbox on the Manage Tab is unchecked because the Built on Application has it unchecked.
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Circumstance-Logic
NameConflicts
MessageClick Show Conflicts to see details.
Details

<n> conflicts

where n equals the number of conflicts that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Rule-Cirumstance-DefinitionLogic
NameConflicts
MessageClick Show Conflicts to see details.
Details

<n> conflicts

where n equals the number of conflicts that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Rule-Circumstance-TemplateLogic
NameConflicts
MessageClick Show Conflicts to see details.
Details

<n> conflicts

where n equals the number of conflicts that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Rule-Connect-HTTPBestPractice
NameAn explicit URL is not recommended
MessageAn explicit URL is not recommended. Provide the URL as a parameter in the connect calling activity instead.
DetailsProvide the URL as a parameter in calling activity.
Severity2

 

Rule TypeWarning Type
Run-Connect-JMSLogic
NameReference Format
MessageResponse destination reference must start with 'java:/comp/env'
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Declare-DecisionTableLogic
NameConflicts
MessageClick Show Conflicts to see details.
Details

<n> conflicts

where n equals the number of conflicts that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Rule-Declare-DecisionTreeLogic
NameConflicts
MessageClick Show Conflicts to see details.
Details

<n> conflicts

where n equals the number of conflicts that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Rule-Declare-ExpressionsFunctionality
NameChange Tracking
MessageChange tracking will not occur on named-page references either as an input or as an additional dependency such as < property >.
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Declare-ExpressionsLogic
NameExpression Overridden
Message

There is another expression using 'value of first matching property' with the same property name defined on ancestor class < AppliesTo class name>. This expression will never be evaluated.

DetailsOverriding ancestor expression: <first matching property instance>
Severity1

 

Rule TypeWarning Type
Rule-Declare-ExpressionsLogic
NameNo Source Property Defined
MessageNone of the ancestors of this expressions' Applies To class have a property named < target property > defined. This expression will never be evaluated.
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Declare-ExpressionsBestPractice
NameWhen
MessageAs best practice, ensure that the Pages & Classes definition for Top <current class name> matches the top level class of this rule < top level class name>.
DetailsTop page class mismatch
Severity3

 

Rule TypeWarning Type
Rule-Edit-Java Warning
NameAnalyze Java
Message<Java code warning> <error line > <error line number>
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-File-TextJavaScript Compacting Disabled
NameJavaScript Performance
MessageFor performance reasons, it is recommended to enable JavaScript compacting.
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-File-TextJavaScript Syntax Errors
NameJavaScript Validation
Messagereporter (0)
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-HTML-HarnessDeprecated
NameHTML Directives
MessageHTML Directives are deprecated. Please use JSP for new rule instances.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-HTML-SectionDeprecated
NameHTML Directives
MessageHTML Directives are deprecated. Please use JSP for new rule instances.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-HTML-SectionDeprecated
NameMode Display
MessageThe 'when' tag keyword '$mode-display' is deprecated. Please use '!$mode-input' instead.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-HTML-SectionBestPractice
NameNot Auto-Generated
MessageWhenever possible, use the Auto-Generated HTML option for ease of maintenance.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-ActivityJava Warning
NameAnalyze Java
Message<Java code warning> <error line > <error line number>
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Obj-ActivityDeprecated
NameAPI v02
MessageAPI version 02 is deprecated . Use 03-02 instead.
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NameHistory-Add
MessageEntering a simple text message in the Message field means that this information will not be localizable.
PegaRULES Best Practice recommends that the data in the MessageKey field be a reference to a Field Value, so it will not be necessary to find this message and rewrite it later for a localization effort.
DetailsN/A
Severity 

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NameJava
MessageReduce or eliminate Java steps whenever possible for ease of maintenance. This activity contains <n> lines of Java.
Details

<n> lines

where nis the number of lines causing the warning condition.

Severity3

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NameObj-List
MessageThe Obj-List activity method is deprecated. Please use Obj-Browse or Obj-List-View instead.
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NameObj-Open
MessageIf the Step Page field of Obj-Open method is blank, this method opens the object into the primary page of the current activity, replacing the current contents of the primary page and changing the class of the primary page to match the class of the object.
DetailsBlank Step Page
Severity3

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NameObj-Open-By-Handle
MessageIf the Step Page field of Obj-Open-By-Handle method is blank, this method opens the object into the primary page of the current activity, replacing the current contents of the primary page, and changing the class of the primary page to match the class of the object.
DetailsBlank Step Page
Severity3

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NamePage-New
MessageIf the Step Page field of Page-New method is blank, this method create a page of the class specified in NewClass parameter, replacing the current contents of the primary page, and changing the class of the primary page to match the class of the new page.
DetailsBlank Step Page
Severity3

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NamePage-Set-Messages
MessageEntering a simple text message in the Message field means that this information will not be localizable. PegaRULES Best Practice recommends that the data in the Message field be a reference to a Field Value, so it will not be necessary to find this message and rewrite it later for a localization effort.
DetailsText Message
Severity3

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NameProperty-Set-Messages
MessageEntering a simple text message in the Message field means that this information will not be localizable. PegaRULES Best Practice recommends that the data in the Message field be a reference to a Field Value, so it will not be necessary to find this message and rewrite it later for a localization effort.
DetailsText Message
Severity3

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NameRDB-Open
MessageIf the Step Page field of RDB-Open method is blank, this method opens the object into the primary page of the current activity, replacing the current contents of the primary page and changing the class of the primary page to match the class of the object.
DetailsBlank Step Page
Severity3

 

Rule TypeWarning Type
Rule-Obj-ActivityBestPractice
NameUnused Precondition
MessagePrecondition filled in step <step number>, but not used
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-ClassBestPractice
NameBad class name
MessageThe name of class <class name> should not start with the name of classgroup <classgroup name> unless the class belongs to the classgroup
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-ClassLogic
NameSaves to tableName
MessageInstances of this class save to the pr_other table which has few properties exposed as columns. Consider mapping to a different table.
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Obj-FlowBestPractice
NameOverloaded assignments
Message<n> overloaded assignment(s) in this flow.
Details

<n> assignments

where n equals the number of assignments that are causing the warning condition

Severity3

 

Rule TypeWarning Type
Rule-Obj-FlowBestPractice
NameToo many shapes
MessageFor clarity and ease of maintenance, limit the flow to no more than 15 shapes. This flow contains <n> shapes.
Details

<n> shapes

where n equals the number of shapes that are causing the warning condition

Severity3

 

Rule TypeWarning Type
Rule-Obj-FlowActionDeprecated
NameHTML Directives
MessageHTML Directives are deprecated. Please use JSP for new rule instances.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-FlowActionDeprecated
NameMode Display
MessageThe 'when' tag keyword '$mode-display' is deprecated. Please use '!$mode-input' instead.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-FlowActionBestPractice
NameNot Auto-Generated
MessageWhenever possible, use the Auto-Generated HTML option for ease of maintenance.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-Obj-MapValueLogic
Conflicts Conflicts
MessageClick Show Conflicts to see details
Details

<n> conflicts

wheren equals the number of conflicts that are causing the warning condition

Severity2

 

Rule TypeWarning Type
Rule-Obj-PropertyDeprecated
NameReserved Property Name
MessageThe property name matches a reserved keyword.
DetailsN/A
Severity1

 

Rule TypeWarning Type
Rule-Service-BestPractice
Name1 ambiguous parse rule definition
MessageThis configuration is acceptable if the parse rule to be called is of DOM type. If it is a SAX type parse you will get a failure unless you specify the element name. To avoid the difference in behavior we recommend you always provide the "element name."
DetailsSpecifying the full "element-name" is recommended
Severity2

 

Rule TypeWarning Type
Rule-Service-BestPractice
Name<n> ambiguous parse rule definitions
MessageThis configuration is acceptable if the parse rule to be called is of DOM type. If it is a SAX type parse you will get a failure unless you specify theelement name. To avoid the difference in behavior we recommend you always provide the "element name."
DetailsSpecifying the full "element-name" is recommended"
Severity2

 

Rule TypeWarning Type
Rule-Service-HTTPBestPractice
NameCustom Cookies may interfere with stateful sessions
MessageSetting custom cookies may interfere with stateful session management
DetailsSetting custom cookies may interfere with stateful session management
Severity2

 

Rule TypeWarning Type
Rule-StreamDeprecated
NameHTML Directives
MessageHTML Directives are deprecated. Please use JSP for new rule instances.
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-StreamLogic
NameHTML Generation
MessageJSP generation selected but no Pega JSP tags found and possible HTML directives detected. Should this instance use HTML generation?
DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-StreamDeprecated
NameMode Display
Message

The 'when' tag keyword '$mode-display' is deprecated. Please use '!$mode-input' instead.

DetailsN/A
Severity3

 

Rule TypeWarning Type
Rule-StreamDeprecated
NameStream Version Conflict
Message

This unqualified rule is generated for JSP but a qualified version of the same rule is generated for HTML

(or)

This unqualified rule is generated for HTML but a qualified version of the same rule is generated for JSP

Note: It is suggested that you not use directive-based streams and JSP-style streams for the same rule (for example, a rule that is qualified by multiple circumstances or date ranges).

Details

This Rule <rule using JSP tag> conflicts with <rule using HTML directive >

(or)

This Rule <rule using HTML directive > conflicts with <rule using JSP tag>

Severity1

 

Rule TypeWarning Type
Rule-Utility-FunctionJava Warning
NameAnalyze Java
Message<Java code warning> <error line > <error line number>
DetailsN/A
Severity2

 

Rule TypeWarning Type
Rule-Utility-FunctionJava Warning
NameFunction Not Compiled
MessageCompile Checkbox Not Checked
DetailsN/A
Severity2

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us