ステップ1: 絞込みを持つ属性の取得と公開

絞込みの表示の最初のステップは、絞込みを持つ可能性のある属性の取得です。

絞込みは、その属性がグループに含まれるかどうかに応じて、2つの方法で取得できます。

リクエストでは、RefinementGroupConfigまたはRefinementConfigを使用して、それらをNavigationMenuConfigに含めます。その書式の詳細は、「NavigationMenuConfig」を参照してください。

絞込みはNavigationMenuコンテンツ要素で返されます。属性がグループに属する場合、この要素には、絞込みを含む管理属性ごとに、NavigationMenuItem要素を持つNavigationMenuItemGroup要素が含まれます。

属性グループの提案される絞込みの取得

WineType絞込みがリクエストおよび公開される次のリクエストについて考えます。 
<Request xmlns="http://www.endeca.com/MDEX/conversation/3/0">
 <State/>
 <NavigationMenuConfig Id="NavigationMenu" IncludeAllExplicitSelections="false"
IncludeAllImplicitSelections="false">
   <RefinementGroupConfig Name="WineCharacteristics" Expose="true">   
     <RefinementConfig Name="WineType" Expose="true"/>
   </RefinementGroupConfig>
  </NavigationMenuConfig>
</Request>

IncludeAllExplicitSelectionsとIncludeAllImplicitSelectionsがfalseに設定されていることに注目してください。これがデフォルトで、リクエストでは、ナビゲーション用にまだ使用可能な絞込み(提案される絞込み)のみを取得するように要求し、すでに適用済の絞込み(明示的に選択されたものと暗黙的なものを含む)は返されません。絞込みの完全なリストの取得方法の詳細は、「絞込みの完全なリストの取得(適用分と提案分)」を参照してください。

このリクエストは次の問合せ結果を返します。問合せ結果でWineType絞込みとそれに対する絞込み値(Red、WhiteおよびSparkling)が示されていることに注目してください。 
<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">
  <cs:NavigationMenu" Id="NavigationMenu">
    <cs:NavigationMenuItemGroup Name="WineCharacteristics" HasRefinablePRoperties="true">
      <cs:NavigationMenuItem Name="WineType" DisplayName="Wine Type" MultiSelect="None" HasMore="false">
         <cs:ExposureControl Exposed="true"/>
         <cs:Refinement Name="WineType" Spec="Red" Label="Red" Count="31021"/>
         <cs:Refinement Name="WineType" Spec="White" Label="White" Count="23031"/>
         <cs:Refinement Name="WineType" Spec="Sparkling" Label="Sparkling" Count="3020"/>
         <cs:RootDimensionValue DimensionName="WineType" Spec="/"/>
         <cs:FullPath>
           <cs:DimensionValue DimensionName="WineType" Spec="/">WineType</cs:DimensionValue>
         </cs:FullPath>
      </cs:NavigationMenuItem>
    </cs:NavigationMenuItemGroup>
  </cs:NavigationMenu>
</cs:Results>
この例では、NavigationMenuItem要素は、グループに含まれる管理属性に使用されます。 
<cs:NavigationMenuItem Name="WineType" DisplayName="Wine Type" MultiSelect="None" HasMore="false">
   <cs:ExposureControl Exposed="true"/>
ExposureControlタイプに注目してください。 
<cs:ExposureControl Exposed="true"/>
<cs:ExposureControl Exposed=""true">文は、NavigationMenuItemに含まれる最上位レベルの絞込みの現在の公開ステータスを示します。
この例をさらに調べると、Red管理属性値の例に示すように、このグループの各絞込みはRefinement要素で返されます。 
<cs:Refinement Name="WineType" Spec="Red" Label="Red" Count="31021"/>

Count要素は、Red絞込みで絞込みを行った場合の結果セットに31,021のレコードがあることを示します。

グループに含まれない属性の提案される絞込みの取得

Region絞込みの次のリクエストについて考えます。 
<Request xmlns="http://www.endeca.com/MDEX/conversation/3/0">
  <State/>
  <NavigationMenuConfig Id="NavigationMenu" IncludeAllExplicitSelections="false"
IncludeAllImplicitSelections="false">   
    <RefinementConfig Name="Region" Expose="true" IncludeExplicitSelections="false" 
  IncludeImplicitSelections="false"/>
  </NavigationMenuConfig>
</Request>

このリクエストは、値がRegion属性に存在するすべてのレコードをリストするレコード・セットから個々の提案される絞込みを返します。提案される絞込みに加えて、この属性の適用済の絞込みをオプションで返すこともできます。詳細は、「属性ごとの適用済の絞込みの取得」を参照してください。

注意: 優先順位ルールが構成されている場合、優先順位ルールのトリガーが満たされるまで、これらのルールによって、有効な絞込みを持つ属性が抑制されます。優先順位ルールの詳細は、「優先順位ルールの使用」を参照してください。