Normally, the browse response consists of only information about the starting item set’s items and descendents. However, for some user interface applications, it is useful to also return where in the item set tree the starting set appears. The browse request can return ancestry information about the starting node using the following attribute:

<browse ancestry="mode"

The mode value can be one of three values. A value of direct means that the parent and direct ancestors of the starting item set will be returned. A value of full means that that all item sets within the sub-tree containing the starting set will be returned (for example, /Topics sub-tree if the starting set is a category). A value of none means no ancestry information is returned. The default value is none.

loading table of contents...