Normally, the browse response consists of only information about the starting item set’s items and descendents. However, for some applications, it is useful to also return information on 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.
direct
—The parent and direct ancestors of the starting item set will be returned.full
—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).none
—No ancestry information is returned. The default value isnone
.