About the Rules Inspector tool

03-02 C-311 R-6115 R-5643Use the Rules Inspector tool to:

Learn the name of the top-level harness rule or HTML rule (Rule-Obj-HTML rule type) that produced any window or form you are viewing.
Learn the names of section rules, flow action rules, paragraph rules B-20751 and HTML rules that the top-level rule incorporates through the pega:include JSP tag, the HTML-based rules referenced by these and so on.
Learn the name of properties referenced in any of these rules.
Identify properties displayed that are computed automatically by Declare Expression rules.
Find labels and other elements on harness, section, and flow action rules marked for localization, for which field value rules are defined.PROJ-212
Start the Style Discovery tool, to identify and experiment with changes to the CSS styles that are applied to a part of a form. GRP-262

Identifying these rules and other elements can be valuable as you update harness, section, flow action and HTML rules to evolve the user interface of your application.

To turn on rules inspection

Four menu settings set or remove rules inspection. When these menu items are set, a check mark appears before the menu item. Select the Run icon to access the Run menu.

> Rules Inspector > HTML RulesBYRNB 2/17/10 to turn on marking of harness, section, and flow action rules with an icon. The icon appears above the visible presentation of the HTML in the rule. This menu selection also marks HTML rules with an H icon. GENTJ 6/14/06 The keyboard shortcut is CTRL+ALT+Y.PROJ-340
> Rules Inspector > Property RulesBYRNB 2/17/10to turn on the marking of visible properties. A small red P identifies each property reference. The keyboard shortcut is CTRL+ALT+X.
> Rules Inspector > Declarative RulesBYRNB 2/17/10to turn on the marking of properties computed by Declare Expression rules. A small red D identifies such properties. The keyboard shortcut is CTRL+ALT+V.
> Rules Inspector > Field Value RulesBYRNB 2/17/10 to turn on the marking of portal, harness, section, and flow action elements that are marked for localization and supported by field value rules (Rule-Obj-FieldValue rule types). This option is most useful when testing a localized application. See Localizing with the Field Values Inspector. Proj-212 The keyboard shortcut is CTRL+ALT+w. Proj-787
> Rules Inspector > Styles to turn on the Style Inspector, allowing you to determine which CSS styles apply to elements of a form, and experiment with style changes.GRP-262

Working while rules inspection is on

Rules Inspector settings affect all work object forms presented after you turn on the settings.

To see the enhanced display for a form that's already displayed:

Right-click anywhere in the form.
Click the Refresh icon ( or ) on your portal. (If this icon isn't visible, save your work and choose Refresh from the right-click context menu presented by Internet Explorer.)

Understanding the H, P, D, and A icons

Rules Inspector settings affect all forms presented after you turn on the settings. The enhanced display contains up to four types of icons:

A top-left yellow icon () identifies the harness rule. Additional icons identify the start of the visible presentation of a section rule or flow action rule. B-2100 R-11601 GROVS 2/26/04 12/9/03
A small H identifies the visible presentation of an HTML rule or HTML fragment rule.
A small red P identifies a property reference.
A small red D identifies a property computed by a Declare Expression rule.
Any of the following four globe icons may appear at points on a harness, section, or flow action rule for which the Localized checkbox (on the HTML tab) is selected and a language-specific RuleSet is in use: PROJ-212
- — A field value rule exists for ToolTip text (in the language-specific RuleSet).
- — No field value rule exists for ToolTip text.
- — A field value rule exists for the text label, caption, or value.
- — No field value rule exists for the text label, caption, or value.

Interacting with the H, D, P and A results

You can use work object forms while rules inspection is enabled. In addition, you can identify the rules that make up a work object form:

Place and hold your mouse pointer over the, H, D, or P to display in ToolTip text, the rule type and the full name of the rule.
Click an H, P, or mark to open the referenced section, HTML, fragment, or property rule.
Click a D mark to view the dependency network for that property. B-20490 The network shows the current values of other properties that contribute to the current property computation. To understand the computation, you can alter selected input values to see the effect on the computation. Your changes do not alter the value on the form. GAGNP 10/5/04
Click any field value icon (,,, or) to access the Field Value Manager, which lets you review, add or update a language-specific field value to the current language-specific RuleSet. See Localizing forms and reports with the Field Value Inspector. PROJ-212

Working with the Style Discovery tool

The Style Discovery toolbar appears whenever the Styles option is checked and a report display or work object form is visible. Select > Rules Inspector > StylesBYRNB 2/17/10again to disable the Style Discovery toolbar. GRP-262

See Rules Inspector — Working with the Style Discovery tool.

To turn off rules inspection

Using this facility slows your session; enable it only when needed.

To turn off rules inspection, select each > Rules Inspector menu item again to remove the check marks.

Notes

Some standard rules have Availability set to Final (and so cannot be overridden by your application). These rules are not marked when rules inspection is enabled.
A few properties and HTML rules marked as "internal-only" are not marked when rules inspection is enabled.

	dependency network, fragment, harness form, internal rule, language-specific RuleSet, locale, section
	Understanding CSS styles About Field Value rules

Tools, accelerators, and wizards