RecordListの結果について

問合せから返されるレコードは、RecordList要素に含まれます。

レコードのリストは、Oracle Endeca Serverから受信したすべての問合せ結果とともに返されます。レコードのリストは、対話WebサービスによってResultsレスポンスで返されるRecordList複合タイプとして表されます。各レコードは、Record要素で返されます。

次のサンプル・スニペットは、1つのレコード、1つのページ区切りコントロール、および1つの列があるRecordListを示します。
<cs:Results 
    xmlns:cs="http://www.endeca.com/MDEX/conversation/2/0" 
    xmlns:mdex="http://www.endeca.com/MDEX/XQuery/2009/09">
   <cs:Request>
      ...
   </cs:Request>
   <cs:ContentElement xsi:type="cs:RecordList" Id="RecordList" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <cs:NumRecords>2231</cs:NumRecords>
      <cs:TotalPages>224</cs:TotalPages>
      <cs:RecordRange First="1" Last="10"/>
      <cs:RecordListEntry>
        <cs:Record>
            <cs:attribute name="AFFINITY_CARD" type="mdex:boolean">false</cs:attribute>
            <cs:attribute name="AMOUNT_SOLD" type="mdex:double">550.370000</cs:attribute>
             ...
            <cs:attribute name="WEEK_ENDING_DAY" type="mdex:dateTime">2000-03-26T00:00:00.000Z
            </cs:attribute>
         </cs:Record>
         <cs:ComputedProperties/>
      </cs:RecordListEntry>
      <cs:DimensionHierarchy>
         <cs:DimensionValueWithPath>
            <cs:DimensionValue DimensionName="Channel" Spec="3">Direct Sales</cs:DimensionValue>
            <cs:DimensionValue DimensionName="Channel" Spec="Direct">Direct</cs:DimensionValue>
            <cs:DimensionValue DimensionName="Channel" Spec="/">Channel</cs:DimensionValue>
         </cs:DimensionValueWithPath>
      </cs:DimensionHierarchy>
      ...
      <cs:PaginationControl Label="First" Active="false">
         <cs:Operator OwnerId="RecordList" Page="0" xsi:type="cs:PageOperator"/>
      </cs:PaginationControl>
      ...
      <cs:Column ColumnKey="AMOUNT_SOLD" DisplayName="Amount Sold" SpecColumn="false">
         <cs:SortControl Key="AMOUNT_SOLD" Direction="Ascending" Active="false" 
           xsi:type="cs:SortControl">
            <cs:Operator OwnerId="RecordList" xsi:type="cs:SortOperator" Key="AMOUNT_SOLD" 
              Direction="Ascending"/>
         </cs:SortControl>
         <cs:SortControl Key="AMOUNT_SOLD" Direction="Descending" Active="false" 
           xsi:type="cs:SortControl">
            <cs:Operator OwnerId="RecordList" xsi:type="cs:SortOperator" Key="AMOUNT_SOLD" 
              Direction="Descending"/>
         </cs:SortControl>
      </cs:Column>
      ...
</cs:ContentElement>
</cs:Results>
RecordListの要素には、次の情報が含まれます。
  • NumRecordsは、問合せから返されたレコードの総数(Record要素)を指定します。
  • TotalPagesは、レコードのページ総数をリストします。
  • RecordRangeは、このページ・セットの開始および終了レコードをリストします。
  • DimensionHierarchyは、リクエストされたレコード・リストの割当てを値に持つ管理属性のパスをリストします。これにはDimensionValueWithPathも含まれます。
  • RecordListEntry属性には、Record要素と、そのレコードについて計算された属性(ジオコード距離やスニペットなど)を持つComputedProperties要素内の特定のレコードが含まれます。
  • PaginationControlは、特定のレコード・ページの制御(PageOperator)です。
  • SortControlは、属性のソート順序(AscendingまたはDescending)を識別します。
また、Column要素の属性には、レコードの特定の標準属性または管理属性に関する次の情報が含まれます。
  • ColumnKeyは、属性の名前(NCName書式)を識別します。
  • DisplayNameは、属性の名前をわかりやすい形式で指定します(表示名を定義すると、それがフロントエンド・アプリケーションに表示されます)。
  • SpecColumnは、属性がレコードの主キーかどうかを識別します。trueに設定されている場合は、このプロパティをレコードの主キー属性として識別します。SpecColumnでは、レコード詳細を表示するレコードを選択できます。