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
.