Back Forward Property Qualifier form
Completing the Table Edit tab

About Property Qualifier rules
 Expand Show all 

Optionally, you can restrict the values of the property qualifier using information entered into this tab.

NoteIf 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

  Basics

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

NoteAlthough 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

  Selecting a table type

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 None, Local List, Class Key Value, or Remote List:

  • None — No table edits apply.
  • Local List — Values are enumerated in this tab.
  • Class Key Value — Values correspond to the first key part of a known other class.
  • Remote List — Values are enumerated as elements of a List or Group within a single Process Commander object.

  Entering a Local List

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.)

NoteYou 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.

TipIf 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

TipTo 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

SmartPromptSelect a concrete class with two key parts that meets these conditions:

  • The first key part acts to group values for a second key part.
  • The second key part that corresponds to an allowable value of the property you are editing.

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)

SmartPromptOptional. 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.

  Completing Remote List fields

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

SmartPromptSelect 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 Use-Group-Name keyword.

Your choices depend on the property mode of the property in the Reference to List or Group field.

Mode

Choices

Page List or Page Group

Identify a property that contains a value that is an index that identifies the specific page that contains the list.

Value List

Leave blank.

Value Group

Leave this field blank to edit against each value in the Value Group, or enter the keyword Use-Group-Name to indicate that the index values of the Value Group are the allowed values. COLEA 11/7/02

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.

Up About Property Qualifier rules