This tag uses the category attributes in the repository XML definition file to sort the property descriptors for each property defined in the given repository. If you have access to the RepositoryItem itself, use the repositoryItem and itemDescriptor attributes. Otherwise, you need to specify the repositoryPath and itemDescriptorName attributes.

After the tag is executed, the property descriptors are stored in an array result object named by the var attribute. The result object has properties that other tags can access.

Attributes

The following attributes are defined for the pws:categorize tag:

Attribute

Description

Required?

id

Returns the instance of the tag. Call getItems() to return a collection of atg.beans.DynamicPropertyDescriptors for properties to display.

no

var

Names the Array result object to contain the sorted property descriptors.

no

repositoryItem

The RepositoryItem with properties that you want to sort.

no

itemDescriptor

The itemDescriptor for the RepositoryItem.

no

repositoryPath

The Nucleus path to the itemDescriptor.

no

itemDescriptorName

The name of the itemDescriptor.

no

hidden

Indicates whether properties that are designated as hidden properties are included in (true) or excluded from (false) the sorted collection. Hidden properties hold information that is not directly applicable to your user interface. The default value is false.

no

expert

Indicates whether properties that are designated as expert properties are included in (true) or excluded from (false) the sorted collection. Expert properties hold information that is useful for only some technical ACC users. The default value is false.

no

specificProperties

A comma-separated list of properties to which the result object should be restricted. Can also be used to override the categories attribute for given properties (see below).

no

excluded

A comma-separated list of properties that should be excluded from the result object. Can also be used to override the excludedCategories attribute for given properties (see below).

no

categories

A comma-separated list of categories. Only properties that have these category values are included in the result object.

no

excludedCategories

A comma-separated list of categories. Properties that have these category values are excluded from the result object.

no

hideSingleCategoryDescriptor

If only one category exists, indicates that the category descriptor should not be returned (true).

no

For an example of this tag in use, see oneColumnEdit.jsp, located in:

<ATG9dir>/PubPortlet/PubPortlets.ear/portlets.war/html/views/item/gsa/

 
loading table of contents...