In order to group similar properties in a Repository user interface, include the category
attribute in their respective <property>
tags and set the attribute to the same value. For example, the <property>
tags that define login and password properties each set their category
attribute to Login
; thus, the login name and password are listed together under the heading Login.
By default, properties with the same category
setting are listed in ascending alphabetical order of their display-name
settings. You can explicitly control the display order of grouped properties by setting their propertySortPriority
attributes to the desired integer values; in that case, the properties are displayed in ascending numeric order. The default propertySortPriority
setting is 0.
For example, Oracle ATG Web Commerce user profile definitions set three name properties (first, middle, last) as follows:
<property category="Basics" name="firstName" data-type="string" display-name="First name"> <attribute name="propertySortPriority" value="-3"/> </property> <property category="Basics" name="middleName" data-type="string" display-name="Middle name"> <attribute name="propertySortPriority" value="-2"/> </property> <property category="Basics" name="lastName" data-type="string" display-name="Last name"> <attribute name="propertySortPriority" value="-1"/> </property>
Given these settings, the Basics category for a user profile the ATG Control Center displays name properties in the following order:
First name
Middle name
Last name
Category Ordering in the ACC
The ACC lists categories in the following order:
All named categories that contain required properties (properties with the attribute
required="true"
).All named categories that do not contain required properties.
A special “anonymous” category containing properties that are not assigned to any category.
A special “Groups” category containing boolean properties that correspond to content or profile groups.
Within each of these four sets, categories are listed in alphabetical order.