Property form - Completing the General tab
The General tab for properties has three sections: Property Type, Data Access, and Display and Validation.
Property Type
A property has one of eleven modes. Each is defined in the table below. Three are string-based modes, three are page-based modes, and five are modes used with Java objects. The appearance of the General and Behavior tabs depends on the mode chosen.
Use the Property Mode selection box to choose a mode. The property mode determines how the system represents the property data. After you select a mode, consult these topics to complete the General tab fields:
- Completing the General tab for Value modes
- Completing the General tab for Page modes
- Completing the General tab for Java Object modes
Mode | Description |
Single Value |
Select
Single Value
to create a property that can contain a
single text string value. Text, numbers, dates, Boolean values, and amounts are
stored in
Single Value
mode properties.
The internal value of a
For example, use this mode to create a property that can hold a birth date. The
standard
|
Value List |
Select
Value List
to create a property that can contain an
ordered list of single values.
If you create a Value List property named LetterSent, you can use it to hold a list of values. For example, you can use an activity or an HTML form to set LetterSent(1) to Mom and LetterSent(2) to Dad.
After setting these values, the LetterSent
An example of a standard
|
Value Group |
Select
Value Group
to create a property that can contain an
unordered group of single values. (Rare.)
If you create a Value Group property named Birthday, you can use it in your future configuration to hold a group of values. For example, you can use an activity or an HTML form to set Birthday(Bob) to July and Birthday(Mary) to September. Birthday(Bob) and Birthday(Mary) become elements of the Birthday Value Group. |
Page |
Select
Page
to create a property that can contain an embedded
page as its value.
For example, a Page mode property named Originator can contain information about the originator of a work item, such as the originator's name, account number, and so on.
An example of a standard
|
Page List |
Select
Page List
to create a property that can contain an
ordered list of embedded pages.
For example, a Page List property named Contacts can contain the pages Contact(1), Contact(2), Contact(3), and so on. Work-.pyFlowActionCosts
is an example of a standard
|
Page Group |
Select
Page Group
to create a property that can contain an
unordered group of embedded pages.
For example, the standard
|
Java Object |
Some properties with this mode can be saved as persistent data in the
PegaRULES database. If the Java class of the Java object instance implements the
Serializable
interface, and the value can be validated, the
Pega Platform
can persist instances of the Java class with
other clipboard data.
|
Java ObjectList | |
Java Object Group | |
Java Property | Select Java Property to indicate that this property
represents a single property of a Java class that defines an external Java object.
Typically, properties of this mode are generated by the Import JavaBeans wizard when
you use it to import a Java class and implement in the Pega Platform the data model of an external Java object. |
Java Property List |
Select
Java Property List
to indicate that this property
represents an array property of a Java class that defines an external Java object.
Typically, properties of this mode are generated by the Import JavaBeans wizard.
|
Data Access
Use this section to configure automatic data access and persistence settings.
For all property types except Page and PageList
Section | Controls |
Data Access |
Select a Data Access Type. The options are:
If you choose Automatic Reference to class instance (linked), further fields appear:
|
Data Persistence | The system saves the property data with the work item for which it is used by default. Check the "Don't save property data (transient)" check box to prevent the system from saving the data with the work item. |
For Page and PageList properties
Section | Controls |
Data Access |
Select a data access option from those provided:
If you choose "Refer to a data page", further fields appear:
If you select Copy data from a data page , you can select a data transform in the Data Transform field that appears. This allows you to copy only a subset of the results on a data page into the property. To create a new data transform, specify a name and then click the Edit icon to the right of the field.
|
Data Persistence |
|
Display and validation
In this section, you configure which control displays the property and, optionally, validation of input data.
To configure the UI control:
- In the UI Control field, specify the control that displays the property.
- If the control takes parameters, click the Parameters link and provide values for the parameters in the Parameters dialog.
For information about configuring validation tables, see Property form General tab — Configuring validation.
Other ways to associate values with properties
You can use other methods to associate a value with a property, including:
- Use a Declare expression.
- Use a "set" action in a data transform.
- Apply the value directly from the UI.
- Apply the results of a decision table or a decision tree.
It is also possible to use any of the Property-Set methods in an activity, but it is not recommended to use this method.
Previous topic Properties - Completing the Create, Save As, or Specialization form Next topic Property form - Completing the General tab for Page modes