List View rules
|
|
NOTE: As a best practice, before creating a new list view rule, it is strongly recommended that you investigate using a report definition instead. The New form displays a message with information about that alternative.
Records can be created in various ways. You can add a new record to your application or copy an existing one. You can specialize existing rules by creating a copy in a specific ruleset, against a different class or (in some cases) with a set of circumstance definitions. You may copy data instances but they do not support specialization as they are not versioned.
Based on your use case, the Create, Save As or Specialization form is used to create the record. The number of fields and available options vary by record type. Start by familiarizing yourself with the generic layout of these forms and their common fields:
This
Create a list view rule by selecting List View
from the Reports
category.
Key parts:
A list view rule has three key parts:
Field |
Description |
Apply to |
Select a class for this list view rule. Choose:
If you are creating a list view rule to report on work items, choose carefully whether you want to save the rule in an implementation class and RuleSet, or in a framework class and RuleSet. At runtime, list view rules with a framework class as the Apply to class can automatically report on work items in the associated implementation class. To enable this feature, select the Report on Descendant Class Instances option on the Contents tab. The list of available class names depends on the ruleset you select. Each class can restrict applying rules to an explicit set of rulesets as specified on the Advanced tab of the class form. |
Identifier |
Enter a purpose to identify this list view rule; the purpose you enter forms a Java identifier. Begin it with a letter and use only letters and digits. See How to enter a Java identifier. In contrast to most rule names, you cannot use a dash (hyphen) in this key part. |
Owner |
By convention, enter the keyword The Owner value of a personal list view rule is an Operator ID name. By convention, such personal rules, are placed in a RuleSet and version designated to this limited purpose; the rules in such RuleSet versions are not typically moved from one PRPC system to another. |
When searching for list view rules, the system:
Circumstance-qualified rule resolution features are available for ListView rules. Time-qualified rule resolution features are not.