Retrieving breadcrumbs in a navigation query

An initial Conversation Web Service request that is made in response to a user-initiated navigation query (in which no selections have been made in the navigation state) does not yet return breadcrumbs. However, a subsequent request (in which the user made selections within the available attribute values) returns breadcrumbs, which represent explicitly-selected refinements.

In the Conversation Web Service request, make sure you specify the selection for a specific refinement, as well as the BreadcrumbConfig type.

In this example, the navigation state includes a selection of the WineType refinement, as well as the BreadcrumbConfig type:

<Request xmlns="http://www.endeca.com/MDEX/conversation/3/0">
   <State>
      <Name>Breadstate</Name>
      <SelectedRefinementFilter Name="WineType" Spec="/" Id="MyWines">
      </SelectedRefinementFilter>
   </State>
   <BreadcrumbConfig Id="BreadcrumbInfo" ReturnFullPath="true">
      <StateName>Breadstate</StateName>
   </BreadcrumbConfig>
</Request>

The Conversation Web Service result includes the original State request, followed by the Breadcrumbs type that lists attribute values identified as breadcrumbs, based on the user-selected navigation state, as in this sample result:

<cs:Results xmlns:cs="http://www.endeca.com/MDEX/conversation/3/0" 
            xmlns:mdex="http://www.endeca.com/MDEX/XQuery/2009/09">
   <State xmlns="http://www.endeca.com/MDEX/conversation/3/0" 
          xmlns="http://www.endeca.com/MDEX/eql_parser/types">
      <Name>Breadstate</Name>
      <SelectedRefinementFilter Name="WineType" Spec="/" Id="MyWines"/>
   </State>
   <cs:Breadcrumbs Id="BreadcrumbInfo">
      <cs:RefinementBreadcrumb Name="WineType" DisplayName="Wine Type" Spec="/">
         <cs:DimensionValue DimensionName="WineType" Spec="/">WineType</cs:DimensionValue>
      </cs:RefinementBreadcrumb>
   </cs:Breadcrumbs>
</cs:Results>