FetchXml を使用して行を並び替える

テーブルの行の並べ替え順序を指定するには、エンティティ 要素または リンク エンティティ 要素内で 順序 要素を使用します。 規定の並べ替え順序は、昇順 です。

以下のクエリは、createdon、name、accountnumber の値の昇順で アカウント レコードを返します。

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='accountnumber' />
    <attribute name='createdon' />
    <order attribute='createdon' />
    <order attribute='name' />
    <order attribute='accountnumber' />
  </entity>
</fetch>

要素の順序によって、順序付けがどのように適用されるかが決まります。 accountnumber を使用して順序付けを適用するには、その要素を最初の位置に移動します。

<order attribute='accountnumber' />   
<order attribute='createdon' />
<order attribute='name' />

降順

降順 順序を使用する場合は、 descending 属性を true に設定します。 次の例では、最後に作成されたレコードが先頭にある取引先企業レコードを返します。

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='createdon' />
    <order attribute='createdon' descending='true' />
  </entity>
</fetch>

link-entity の注文を最初に処理

Dataverse は常に entity 要素の属性の後に link-entity で指定された属性を並べます。

次の例は、link-entity 属性と entity 属性の両方の従来の順序付けパターンを示しています。

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='accountnumber' />
    <attribute name='createdon' />
    <link-entity name='account'
      from='accountid'
      to='parentaccountid'
      link-type='inner'
      alias='parentaccount'>
      <attribute name='name'
        alias='parentaccount' />
        <!-- The link-entity parentaccount name -->
      <order attribute='name' />
    </link-entity>
    <!-- The entity account name -->
    <order attribute='name' />
  </entity>
</fetch>

この場合、結果は次の属性を使用して順序付けされます。

• 最初 => account.name
• 最後 => parentaccountname.name

link-entity 順序が最初に適用されないようにするには、order 要素を link-entity 要素から他の order 要素の上にある entity 要素に移動し、order 要素の entityname 属性を使用して link-entity alias 値を参照します。

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='accountnumber' />
    <attribute name='createdon' />
    <link-entity name='account'
      from='accountid'
      to='parentaccountid'
      link-type='inner'
      alias='parentaccount'>
      <attribute name='name'
        alias='parentaccount' />
    </link-entity>
    <!-- The link-entity parentaccount name -->
    <order entityname='parentaccount'
      attribute='name' />
      <!-- The entity account name -->
    <order attribute='name' />
  </entity>
</fetch>

以上で、結果は次の属性を使用して順序付けされます。

• 最初 => parentaccount.name
• 最後 => account.name

ルックアップ列と選択列の順序付け

ほとんどの列タイプに含まれるデータは比較的単純なので、意味のある並べ替え操作を実行できます。 データベースに保存されているデータはコンテキストを離れては意味を持たないため、ルックアップ列と選択列はより複雑になります。

検索列

ルックアップ列を使用して並べ替えると、結果は関連テーブルのプライマリ名フィールドを使用して並べ替えられます。 データベースには GUID 値が格納されます。 返される フォーマットされた値 は、対応する主な名前フィールドです。

選択列

選択列の値も、データベースに保存されている値ではなく、フォーマットされた値 を使用して並べ替えられます。 これらの列のデータは整数として保存されます。 フォーマットされた値は、ユーザーの言語に基づいてローカライズされたラベルです。

この動作は、要素を取得 useraworderby (生の並べ替えを使用する) ブール値の属性を設定することで上書きできます。 この属性が設定されている場合、選択列のすべての並べ替えでは代わりに整数値が使用されます。

ページングと並び順

ページの順序は、データをページングする際に大きな違いをもたらします。 結果の順序に関する情報があいまいな場合、Dataverse はページングされたデータを一貫して効率的に返すことができません。

順序要素をクエリに追加します。 クエリに順序要素を追加しない場合、Dataverse はテーブルの主キーに基づいた順序を追加します。 しかし、クエリが distinct 属性を使用する場合、主キー値は返されないので、Dataverse はこの既定順序を追加することはできません。 ページングの順序を指定してください。 順序を指定しないと、distinct クエリの結果がランダムな順序で返される可能性があります。 明確な結果の返送についての詳細について解説します

ページングは動的です。 各リクエストは受信時に独立して評価されます。 ページング Cookie は Dataverse に前のページを伝えます。 このページング Cookie データを使用すると、Dataverse は前のページの最後のレコードの次のレコードから開始できます。

ページングは​​今後も最適に機能します。 以前に取得したページに戻って取得すると、最後にページを取得してからの間にレコードが追加、削除、または変更されている可能性があるため、結果が異なる可能性があります。 つまり、ページ サイズが 50 で前に戻ると、50 レコードが取得されますが、それらは同じ 50 レコードではない可能性があります。 データ セットのページを進め続けると、すべてのレコードが一貫した順序で返されることが期待できます。

決定論的な順序付けが重要となります

決定的順序付け とは、順序を一貫して計算する方法があることを意味します。 指定されたレコードのセットでは、レコードは常に同じ順序で返されます。 一貫した順序とページングが必要な場合は、いくつかの一意または半一意の列値を含めて、それらが評価される順序を指定する必要があります。

非決定的な例

ここで nondeterministic のサンプルを見てみましょう。 このデータセットには 状態 と ステータス の情報のみが含まれ、オープン 状態 のレコードのみを返すようにフィルターされています。 結果は、ステータス によって次のように並べ替えられます。 最初の 3 ページが要求されます。 結果はこのようになります:

ページング Cookie は、ページ上の最後のレコードに関する情報を保存します。 次のページが要求された場合、最初のページの最後のレコードは含まれません。 ただし、非決定的なデータを考えると、最初のページの他の 2 つのレコードが 2 番目のページに含まれていないという保証はありません。

決定的な順序付けを実現するには、一意の値または半一意の値を含む列に順序を追加します。

決定的な例

このクエリは非決定的なクエリと似ていますが、一意な値を含むケース ID 列を含んでいます。 ステータス順でもありますが、ケース ID の使用用途順でもあります。 結果はこのようになります:

次のページでは、cookie は最初のページの最後のレコードとして Case-0032 を保存しているので、2 ページ目はそのレコードの次のレコードから始まります。 結果はこのようになります:

このクエリは一意の列値を順序付けするため、順序は一貫しています。

データをページングするときの注文のベスト プラクティス

アプリケーションで表示するために限られたデータセットを取得する場合、または 5,000 行以上のデータを返す必要がある場合は、結果をページングする必要があります。 結果の順序を決定する際の選択によって、取得するデータの各ページの行が他のページと重なるかどうかが決まります。 適切に順序付けしない場合、同じレコードが複数のページに表示される可能性があります。

同じレコードが複数のページに表示されないようにするには、次のベスト プラクティスを適用します:

一意の識別子を持つ列を含めることをお勧めします。 例:

• テーブルの主キー列
• オートナンバー列
• ユーザー/連絡先 ID

一意の識別子を持つ列を含めることができない場合は、一意の組み合わせになる可能性が最も高い複数のフィールドを含めます。 例:

• 名 + 姓 + メールアドレス
• 姓名 + メールアドレス
• メールアドレス + 会社名

データをページングする際の注文のアンチパターン

避けるべき順序の選択肢は次のとおりです:

• 一意識別子を含まない並び順

• 計算フィールドの注文

• 次のような一意性を提供する可能性が低い単一または複数のフィールドを持つ並び順:

  • 状態と進捗状況
  • 選択肢または、はい/いいえ
  • 値自体に名前を付けます。 例: name、firstname、lastname。
  • タイトル、説明、複数行テキストなどのテキスト フィールド
  • 一意でない数値フィールド

次の手順

行をフィルター処理する方法について説明します。