Creating a list view is a three-step process:

  1. Create a component of class FilterableBrowseListViewConfiguration as described below.

  2. Add the view to the task configuration file, so that it is visible to users as described in the Adding Settings to New Resources section of the Creating and Defining a Task Configuration File section. Be sure to map the view name in a resource bundle to a key that you use in the task configuration file. If you skip this step, the view won’t display in the Browse tab Show drop-down list. See Changing UI Labels for instructions.

  3. Customize the list as necessary. You can provide a custom style to the nodes in the Navigation pane, so that, for example, there’s one font for folders and another for manufacturers. The instructions provided in Customizing the Node Style apply for list as well as tree views.

Filterable Browse List View Configuration Component

To organize your items in a list, create a component of class atg.web.assetmanager.configuration.FilterableBrowseListViewConfiguration and save it to the /atg/web/assetmanager/configuration directory. This class creates the list structure used by your view and implements a filtering tool that reduces the list contents to the items that begin with the letters you enter in a textbox only. For instructions on creating Nucleus components in the ACC, see Appendix C: Managing Nucleus Components in the ATG Page Developer’s Guide.

For the purpose of this instruction, assume that you are creating a view that lists manufacturers. You might name the component Manufacturer View Configuration to keep it consistent with similar components. Set the following properties on this component:

Property

Description

assetTypeName=manufacturer

Holds the type of items displayed in the list. Although a list displays one item type only, it will also display that item’s subtypes. Provide the name defined for the item type in the item descriptor.

createableTypesList=/atg/commerce/catalog
/SecureProductCatalog:manufacturer

Holds the type of items you can create in the view. Provide the name defined for the item type in the item descriptor. Note that you can include the item descriptor name only, but you’re encouraged to specify the full path to safeguard against naming conflicts.

itemsPerPage=50

Holds the number of items that are visible in a page. A higher number reduces the number of overflow pages, but may require users to use the scroll bar in order to view all items on a given page. Conversely, a lower number lets users view all items without scrolling, but will generate more overflow pages. You navigate to overflow pages using automatically generated links at the bottom of the Navigation pane.

queryRQL=ALL

Holds the query used to locate items to display in the list. A query for ALL indicates that all items of type manufacturer are returned. For a list of other queries and operators, see the Repository Query Language section of the Repository Queries chapter of the ATG Repository Guide.

repositoryPath=/atg/commerce/catalog
/SecureProductCatalog:manufacturer

Holds the name and path of the repository that contains the manufacturer item descriptor.

 
loading table of contents...