To summarize, the KEYED (BY) clause specifies how the key components of a referenced objects can be found. It provides these benefits:
•The user does not have type the fully qualified name of a reference value (with periods separating qualifiers). For example, for a property that references a class attribute named email of the class Customer of the package "Order System", instead of typing "Order System".Customer.email, the end user types only email.
•It can be used to ensure that all key components of a reference value are the same. For example, the LISTOF "Class Attribute" property in a Class definition contains a list of attributes that all belong to the same class and to the same package.
A KEYED BY clause typically contains a specification of how each of the key components of the referenced objects can be found. The KEYED BY clause contains a portion for each key component separated by a comma.
Example
The following example shows a KEYED BY clause of the Class’s “Attributes” property. The three key components (separated by commas) are: Package:Package, "Class Name":Name, and Name:*. These components refer to the three parts needed to identify the referenced Class Attribute definitions: the Package name, the Class name, and the Class Attribute name. Taking them in reverse order, it states that:
•The name of the Class Attribute is in this property (* means “here”):
Name:*
•The value of the key property “Class Name” in the Class Attribute definition is in this object’s name:
"Class Name":Name
•The value of the key property Package in the Class Attribute definition is in this object’s Package property:
The following diagram shows how the KEYED BY clause is used in the example, and might be useful in understanding the KEYED BY clause generally.
The diagram shows that in the definition of a class, a class attribute is entered by specifying:
•its package (stored in the class attribute's Package property and obtained from the Package value of the class you are in)
•its class name (stored in the class attribute's “Class Name” property and obtained from the class’s actual name)
•its name (stored in the class attribute's “Name” property and obtained from itself).
Summary
1 For each key component of the reference object, the KEYED BY clause has a component.
2 The components of the KEYED BY clause are separated by commas.
3 Each component has two parts, separated by a colon:
•The first part identifies the key component of the reference object.
•The second part states where the value of that component is to be found.
However, certain default values can be assumed to simplify the KEYED BY clause. If the two parts of the component are the same, the second part can be omitted and if the second part of the last component is omitted, it assumed to be “here”: that is, the asterisk. In practice the KEYED BY clause of the Class's “Attributes” property is coded:
KEYED BY {Package, "Class Name":Name, Name }
All the properties used in the KEYED BY statement must exist. System Architect checks that there is a “Package” property and a “Class Name” property in the “Class Attribute” definition and that they are both KEY.
Besides saving the end user all the effort of typing in common key components in a LISTOF property like this one (for example, "Order System".Customer.email), using a KEYED BY clause using other properties to provide common values ensures the same values are used for each reference. Thus, in the preceding example, all the Class Attributes referred to in the “Attributes” property of the Class are forced to belong to the same class in the same package: a desirable characteristic in this case.
At other times it is convenient to have the key components of the referenced object separated for reasons of clarity and simplicity. Under such circumstances a KEYED BY clause is used to designate the properties supplying the separate components. Indeed, for these reasons, when a property is KEY and refers to an object with KEY properties, System Architect requires that the components are in separate properties.
