Property form - Completing the Advanced tab
Optional. Complete this tab to:
- Define a length in characters (for text properties)
- Prohibit this property from being the target property in Declare expression rules
- Define edits and validation criteria
- Recommend to your database administrator that the property is to be optimized as a separate database column
The format and contents of this tab depend on the Property Mode value selected on the General tab.
Basics
Field | Description |
Max length | Optional. This field is visible only for Value mode
properties of type Password , Text , or
Identifier . You can restrict the value to a specific maximum
number of characters in internal storage. 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. |
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 FixedSizeForInput with this property, the system uses this value to define the size of HTML input textboxes. Use the similar FixedSize control to apply this limit to both input and display presentations of the property. This field is visible only for |
Override sort function | 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. 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
TextEncrypted and the mode is Single Value . 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. 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
Value mode properties. If this property is to hold text that
is composed using the RichTextControl control and so might
contain HTML markup such as |
Use validate | Optional. Validation of a Value mode property always includes testing its
value against the formats allowed by the Type and its maximum length. To provide
stronger validation for this property, identify an edit validate rule. 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. This field is visible only for |
Column inclusion | Optional. If this Single Value property is to belong to a
top-level object (not to an embedded page) in any concrete class, indicate whether
this property is to appear in the Database Class Mappings gadget and Modify Schema
wizard as a candidate for an exposed column:
The other choice See Property optimization using the Property Optimization tool and Data Model category — Classes and Properties landing page. |
Do not save property data | Select to cause the value of this property to be omitted (equivalently, set to
null) when any clipboard page containing this property is committed to the PegaRULES
database. Similarly, the property has no value when an instance containing this
property is opened to the clipboard from the PegaRULES database. Marking a property as transient, when appropriate, improves performance by reducing the size of the Storage Stream property value (the pzPVStream property and column). While on the clipboard, the property can have values of any length. Select only for properties — Single Value or aggregate — that have values thatdo not need to be saved in the database. If you mark a property as transient, but saved instances of objects already exist in the PegaRULES database, the values of this property are removed only when and if those objects are later opened and then recommitted. |
Optimized for classes | 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
Single Value properties that have been exposed through the
Property Optimization tool. See Property optimization using the Property Optimization tool. |
Cannot be declarative target | Select to prevent this property from being the target of a Declare Expression
rule. This restriction is meaningful only for |
Cannot be included as 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. 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. |
Allow use as reference property in activities | 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. |
Cannot be localized in UI controls | Select to exclude this property from being localized if the property will not appear in the UI nor have a field value. Excluding such properties increases localization performance. |
Property Qualifiers
Optional. Complete this array to associate one or more property qualifier rules ( Rule-Obj-Property-Qualifier rule type) with this property.
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.
Field | Description |
Qualifier | Optional. For a permanent qualifier, enter the value in a pop-up dialog box:
|
Property Explorer
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.
Previous topic Property form: General tab — Configuring validation Next topic More about Properties