対話Webサービスでのグループのリストの取得

グループのリストを取得するには、ContentElementConfig複合タイプの拡張として属性グループに関する情報を提供するAttributeGroupListConfigとともにリクエストを使用します。

グループのリストの取得の手順:
次の例のようなリクエストを使用します。
<Request xmlns="http://www.endeca.com/MDEX/conversation/2/0">
   <State/>
   <ContentElementConfig xsi:type="AttributeGroupListConfig"
     Id="AttributeGroupList"
     HandlerFunction="AttributeGroupListHandler" 
     HandlerNamespace="http://www.endeca.com/MDEX/conversation/2/0" 
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   </ContentElementConfig>
</Request>

対話Webサービス・リクエストには、各グループの表示名と各グループ内の属性の数を指定する、現在定義されているグループのリストが含まれます。各グループに関する情報は、ContentElementレスポンスのGroupSummary要素内に返されます。

次の例では、Sale-GeographyおよびSales-Transactionという2つのグループが返されます。属性Cardinalityは、各グループの属性の数を指定します。各グループの属性もリストされます。

レスポンスの前半はリクエストの反復です。
<cs:Results xmlns:cs="http://www.endeca.com/MDEX/conversation/2/0" 
  xmlns:mdex="http://www.endeca.com/MDEX/XQuery/2009/09">
   <cs:Request>
     <ns3:State xmlns:ns2="http://www.endeca.com/MDEX/lql_parser/types" 
        xmlns:ns3="http://www.endeca.com/MDEX/conversation/2/0" 
        xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"/>
     <ns3:ContentElementConfig 
        xsi:type="ns3:AttributeGroupListConfig" Id="AttributeGroupList" 
        HandlerNamespace="http://www.endeca.com/MDEX/conversation/2/0" 
        HandlerFunction="AttributeGroupListHandler" 
        xmlns:ns3="http://www.endeca.com/MDEX/conversation/1/0" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </cs:Request>
レスポンスの後半にはグループとその内容に関する情報が含まれます。
<cs:ContentElement 
     xsi:type="cs:AttributeGroupList" 
     Id="AttributeGroupList" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <cs:GroupSummary Key="Sale-Geography" Cardinality="7">
       <cs:Record>
         <system-group_DisplayName type="mdex:string">
            Sale Geography
         </system-group_DisplayName>
         <system-group_Key type="mdex:string">
            Sale-Geography
         </system-group_Key>
       </cs:Record>
       <cs:GroupMembers>
         <mdex-property_Key>DimGeography_CountryRegionName</mdex-property_Key>
         <mdex-property_Key>DimGeography_StateProvinceName</mdex-property_Key>
         <mdex-property_Key>DimGeography_City</mdex-property_Key>
         <mdex-property_Key>DimGeography_PostalCode</mdex-property_Key>
         <mdex-property_Key>DimSalesTerritory_SalesTerritoryCountry</mdex-property_Key>
         <mdex-property_Key>DimSalesTerritory_SalesTerritoryGroup</mdex-property_Key>
         <mdex-property_Key>DimSalesTerritory_SalesTerritoryRegion</mdex-property_Key>
       </cs:GroupMembers>
    </cs:GroupSummary>
    <cs:GroupSummary Key="Sales-Transaction" Cardinality="15">
       <cs:Record>
         <system-group_DisplayName type="mdex:string">Sales Transaction</system-group_DisplayName>
         <system-group_Key type="mdex:string">Sales-Transaction</system-group_Key>
       </cs:Record>
       <cs:GroupMembers>
         ...
         <mdex-property_Key>FactSales_CarrierTrackingNumber</mdex-property_Key>
         <mdex-property_Key>FactSales_CustomerPONumer</mdex-property_Key>
       </cs:GroupMembers>
    </cs:GroupSummary>
  </cs:ContentElement>
</cs:Results>
注意: レスポンスには、他のどのユーザー作成グループのメンバーでもないすべての属性を含むグループsystem-navigation_InternalGroup (この例では示されていません)があることにも注意してください。このグループはOracle Endeca ServerとStudioで使用されるもので、アプリケーションで使用されることは意図していません。