Property form
|
|
Optional. Complete this tab to:
Page
and Page List
properties,
define auto-population mechanisms.The format and contents of this tab depend on the Property Mode value (on the General tab).
Field |
Description |
Max Length |
Optional. This field is visible only for
Enter the number here. If a user or activity attempts to assign a longer value to the property, the clipboard does contain the longer value, but also has an associated message. R-5480Bug? If you leave this blank, Process Commander does not limit the length of values of the property. However, operational considerations and system performance considerations may apply. For example, database software supporting the PegaRULES database may limit the size of the column to no more than 255 characters, or 1023 characters, or another value; this applies if the property is to be exposed. Even when the property is not exposed as a database column, sizes larger than 1,000 bytes may adversely add to the memory demands on the server and JVMs, depending on how many instances contain the large property and how often they are accessed on requestor clipboards. CLINIC 5/13/05 When updating or overriding a property rule that has a Max Length defined, you can enter a smaller Max Length value, but not a larger value. PASSM VIDOD 11/1/06 |
Expected Length |
Optional. Enter the typical length in characters expected for the property being defined, as entered into a form. This does not affect the number of characters that can be stored internally in the property value. If you associate the standard control rule FixedSizeForInput with this property, the system uses this value to define the size of HTML input textboxes. Use the similar FixedSize control rule to apply this limit to both input and display presentations of the property. R-5265Bug? This field is visible only for |
Override Sort Function |
03-02 R-6098 Optional. Use to this field in special situations, to compare and sort values of this property in ways other than the natural sort sequence for the Type. If you leave this blank, the system uses a built-in sort order based on the Type. R-6098 Identify here a function rule in the Pega-RULES:Sort library or a custom function in a custom Sort library. For a custom function, enter the RuleSet name, a colon and the sort function name. This field is visible only for |
Access When |
Optional. This field is meaningful only when the
Type is Identify the second key part of an access when rule (Rule-Access-When rule type) that controls whether or not the clear-text or encrypted value appears in reports and forms. Design the access when rule to be true for those operators, situations, and times when the clear text of the property value is to appear, and false otherwise. PROJ-466 See Implementing and using the TextEncrypted type. |
Edit Input |
Optional. To convert data entered by a user into
another format, identify an edit input rule to perform the
conversion. This field is visible only for |
Validate |
Optional. Validation of a Value mode property always includes testing its value against the formats allowed by the Type and its maximum length. R-6239 To provide stronger validation for this property, identify an edit validate rule. Q-391 DOYLJ When users complete and submit a form containing a value for this property, the system first applies the edit input rule. This rule may transform the input text. Next, it applies the edit validate rule, which may cause a message to be added to the property indicating that the property value has failed validation. To restrict this value to a (Process Commander) Java identifier, enter JavaIdentifier. 5/8/09 KHATV Many standard edit validate rules are emulated by an equivalent JavaScript function that can be run on the client workstation before users submit a work object form or flow action form. See client-side validation. Removed per B-13473 ERNSGLeave this blank if information using the Table Type on the General tab is to provide validation. You can complete this field or the Table Type information, but not both. This field is visible only for |
Column Inclusion |
Optional. If this
The other choice Your choice in this field only conveys advice to a database administrator; it does not cause the schema to change. You can update a property rule to revise this selection at any time. (Changes to this field are reflected in the Modify Database Schema wizard only after you next log in.) REALLY? See How to expose a property as a database column.
If the property is not a
|
Optimized for Filtering |
A list of the classes containing this property that have values as an exposed column in the PegaRULES database. This read-only list appears only for |
Cannot Be Declarative Target |
Select to prevent this property from being the target of a Declare Expression rule. This restriction applies to Declare Expression rules created after you save the Property form; it is not applied retroactively. This restriction is meaningful only for |
Cannot be included as an input field |
Select to turn on the pySpecial restriction for this rule. If selected, users cannot directly enter a value for this property on an HTML form. B-24220 BUG-559 This restriction improves system security and reduces the chance of errors that can occur when one property is in some cases computed and in other cases directly input. Such properties are sometimes called special properties. Choose a naming convention for special properties, to help everyone on your team remember them. (Standard special properties have a property name starting with the letters px.) |
Reference Property |
Select to make this property a reference property, a property that can link to a source property. Reference properties can reduce the need for duplicating data values on multiple pages or objects, and can simplify lengthy property references. Use the Property-Ref method in an activity to establish the contents of a reference property. proj-1292 5.4
If this property
is of mode |
Optional. If the mode of this property is Page
or
Page List
and the Page Class identifies a concrete class,
your application can automatically retrieve, compute, or references
values for the property by defining a source of page data. If
configured, then Process Commander at runtime, when the page or page
is accessed, retrieves data for the page or pages based on the value
of specified properties. GRP-498 5.5
Use of auto-populated Page
or Page List
properties can simplify your application by eliminating the need to
write an activity to populate the properties, or by eliminating a
routine step in an activity. The content of the page or pages can be
copied from:
If the Reference Property option is selected, the data is retrieved and copied to a temporary page (or a Code Pega-List page, for Page List properties), rather than copied to the property.
Auto-populated pages are analogous to backwards-chaining Declare Expression rules, in that the value of a property is computed only when the value is needed. However, Declare Expression rules compute only scalar properties; this feature computes entire pages or lists of pages.
Auto-population occurs only when at least one embedded property on the page or pages is accessed, for example displayed on a work object form or used in an activity.
To debug auto-populated properties, start the Tracer tool, open the Tracer Options form, and select the Auto Populate Properties event type.
For an example, see Pega Developer Network article PRKB-25624 Automatically populating a Page or Page List property.
Field |
Description |
Auto-populate Property |
Select to indicate that values of this This field is visible only for properties of type
|
Use Declare Page to Perform Load |
Available when Auto-populate Property is checked. Select to indicate that values for this property are to be populated by a declare pages rule. When this checkbox is selected, a field appears in which you specify the declare pages rule. Select the Page
Name (key) of a declare pages rule that starts with
the prefix Declare_Ref_. At runtime, the value of the
If this property has mode |
Advanced Auto-population Options |
Typically, you can cause auto-population of this property by
For example, to populate a page of class Data-Admin-Operator-ID, set a value to the property Data-Admin-Operator-ID.pyUserIdentifier. On the Basic tab of the Class form, pyUserIdentifier is listed as the key to these objects. In less typical situations, the key value is as the value
of a separate property in the current object, or is computed
from multiple separate properties each providing one key
part. Select this option to record how Process Commander obtains the key to an object (or keys to a list of objects). You can load a Page mode property, with an object from the PegaRULES database. Select:
|
Autopopulate using instance handle from parent page | These fields are displayed when the Advanced Auto-population Options checkbox is checked and Load Using Instance Handle is selected. |
Get handle of associated instance from |
Select the property
that, when not blank, holds the pzInsKey value
of an object of the appropriate class. This field appears
when you select At runtime, when this |
Autopopulate using class keys from parent page | These fields are displayed when the Advanced Auto-population Options checkbox is checked and Load Using Class Keys is selected. Indicate the source of values for each key part that
makes up the class key. |
Key of associated Instance |
Read-only. Identifies a property that forms the key, or part of the key, of instances of the Page Class class. |
Value from Property |
Select a property on the parent page that, when not blank, holds a value for this key part. At runtime, when this |
Auto-Populate List using Conditions | For each row of this array, identify match conditions for a key or part of a key. XXXXXX (kowal) Does this choice still exist? I'm not sure how to display it in Build 313. And it's not listed above with the other choices for the 'Advanced Auto-population Options' checkbox. |
List Condition for Associated Instance |
Read-only. Identifies a property that forms the key, or part of the key, of instances of the Page Class class. |
Value from Property |
Select property on the parent page that, when not blank, holds a value for this key part Enter at least one nonblank value. When the |
03-02 C-237 Optional. Complete this array to associate one or more property qualifier rules (Rule-Obj-Property-Qualifier rule type) with this property. B-12210 only if property not in locked RuleSet version
Each property qualifier you list here provides additional information at runtime about the property, and may alter the behavior in computations or presentation of the property.
C-1916 You can provide a value for the qualifier on this tab, thereby defining a permanent value. Or when desired, you can leave the value blank and use Java methods in the PublicAPI to set or test values dynamically. For details, see More about Property Qualifier rules.
Field |
Description |
Qualifier |
Optional. For a permanent qualifier, enter the value in a pop-up dialog box: B-17493
To allow the value of a qualifier to be set dynamically and temporarily at runtime, leave this field blank. C-1916 now optional B-22424l |
Click Explore after you save the form if you completed the Table Type field on the General tab and want to preview the presentation of choices for this property when presented in input mode. This display also identifies any Declare Expression rules that reference the property, and dependencies among expressions. See Properties — Working with the Explore Window.