Property Qualifier
form
|
Optionally, you can restrict the values of the property qualifier using information entered into this tab.
If you define Table Edits for a property qualifier rule, leave the Edit Validate field on the General tab of the Property form blank. R-6495
Table editing is part of property and page validation. If an input value for a property doesn't match the table edits, the property name and the invalid value remain on the clipboard, but during validation the system adds a message and error text to the clipboard page that contains the property. The presence of the message ordinarily prevents the system from saving the clipboard page (which contains invalid data) into the database. The message does not prevent an activity from reading or using the (invalid) property value.
Table Edit comparisons require an exact
text match except for case. Use Table Edits carefully if the
Type of the property is not Identifier
or Text
. For example, a value of 23.0 does not match a
list entry of 23. ERNSG 4/12/05 B-13029
Although the value is compared with the
table elements a case-insensitive way, the system corrects the case.
For example, if the values recorded in a Local List
on
this tab are all lowercase, a user can enter at runtime the value in
uppercase, mixed case, or lowercase letters. The system accepts a
matching value but converts it to lowercase. R-5957
03-02 new checkbox?The fields on the Table Edit tab change after you select the Type of Table field.
Field |
Description |
Type of Table |
Select
|
Choose Local List
as the Type of
Table if your property value is permanently limited to a
modest number of known values in a single language. (Use a
Prompt List
, not a Local List
, to accomplish
a similar localized presentation.)
You cannot
use a Local List
if the Type of the
property is Password
, True or False
,
Date
, or DateTime
. R-5870
A Table Values array appears. Complete the array listing each possible value as a literal. Order is not significant.
Field |
Description |
Table Values | |
Table Values |
Enter into this array each explicit value to be accepted for this property. Enter one or more literal values (without quotes) that are appropriate input for the Type. R-5667 You need not leave a blank entry to allow the property value to be empty. If you enter a value in the first row, it appears at runtime as a default value, and may be too easy for users to overlook. To encourage users to make a non-blank selection at runtime, leave the first entry blank. To require users to make an explicit choice, leave the first row entry and mark the corresponding field on a work object form as required. GRIFK 3/27/07 To encourage users to make accurate, fast selections, list the values in a meaningful order, such as alphabetically or in a natural sequence such as S, M, L, XL, XXL. |
R-5543 Not working?If, at runtime, a user input or other processing assigns a non-null value to the property that is not on this list, the value is accepted but, when the page is later validated, the system adds an error message to the page.
For properties using this Table Edit option, a standard HTML Property rule named PromptSelect or RadioButtonsPROJ-183 is often used to present a selection list.
Completing Class Key Value fields
Select Class Key Value
when a concrete class has
either
The system uses that concrete class rather than field value rules as the source of allowable values for the property.
When you select Class Key Value
, Table
Description fields appear. Complete them to identify a range
of keys in another class.
Field |
Description |
Table Description | |
Validation Class |
Select a concrete class with two key parts that meets these conditions:
You can use a concrete class with three key parts here, if the first key part is a class (property pyClassname) and the middle and third key parts meet the above restrictions.BUG-12565 |
Subset Name (when appropriate) |
Optional. Enter the value of the key part in the Validation Class that represents the subset that contains the list of acceptable values. If you leave this field blank, the system uses the Property Name (the second key part of this property rule) as a default. If the class contains only one key part, you don't need to enter a Subset Name. |
For example, assume that the class Data-CustomerTerritory class has key parts for state code and county name. Enter Data-CustomerTerritory as the Validation Class and "NY" as the Subset Name, to restrict the property to the county names in New York state.
The Class Key Value
facility is a generalization of
the Field Value
case. For example, fifty-one standard
field value rules have Data-Party as the first key part
and pyState as the second key part (the Field
Name key part). Values for the third key part range from
AK
(for Alaska) to WY
(for Wyoming),
identifying codes for 50 states and the District of Columbia. Two
standard properties, Data-Party.pyHomeState and
Data-Party.pyWorkState, use these field values through
the Class Key Values. They use:
At runtime, if your system contains other field value rules in this key range (in an application RuleSet) such as PR for Puerto Rico, they also are acceptable values for pyHomeState and pyWorkState.
Choose Remote List
when the set of valid values is not
constant or not short, but is available at runtime as the keys of a
certain known class.
Complete the fields that appear:
Field |
Description |
||||||||
Table Identification | |||||||||
Class of Instance |
Select the class of the instance. After entering the class, you can skip to the Keys of Instance fields and then return to the Reference To List or Group field. |
||||||||
Reference To List or Group |
Identify a property that is either a list or a group. |
||||||||
Reference in Each to Scalar property |
COLEA 11/7/02 Optional. Enter either an index
value, a reference to one element of an aggregate property,
or the Your choices depend on the property mode of the property in the Reference to List or Group field.
|
||||||||
Reference to Localized Value |
Leave blank. NOT IMPLEMENTED 04-01 STEWS 4/2004 |
||||||||
Keys of Instance |
This array identifies the instance that contains the property value that contains the set of values. Identify keys in the correct order, matching the class definition. |
||||||||
Key Field |
Enter the name of a property that is a key part of the class. |
||||||||
Value |
Enter the value for this key part for the instance. |