Dynamics CRM 2015/Online 2015 更新プログラム 階層化の新機能 その２

みなさん、こんにちは。

前回に引き続き、Dynamics CRM 2015/Online 2015 更新プログラムの階層化に関する新機能を紹介します。
前回の記事を見られていない方は合わせてご確認ください。
- Dynamics CRM 2015/Online 2015 更新プログラム 階層化の新機能 その１

Dynamics CRM 2015 更新プラグラムでは階層構造を検索する機能が追加されています。
この機能は開発者向けとエンドユーザー向けの２つの機能に分類出来ます。

- エンドユーザー向け機能
- 開発者向け機能

エンドユーザー向け機能

高度な検索で階層構造をクエリーする為に、「未満」と「以上」の新しいオペレーターが使用出来るようになりました。
それぞれ、指定した値に一致するレコードの「未満」、「以上」で階層構造が検索されます。

取引先企業エンティティでは、取引先企業の親会社というフィールドで参照できます。このフィールド名は階層設定で使用された 1:N の自己参照関係の名前です。

開発者者向け機能

(*1) 階層セキュリティモデルについては別の回で紹介します。

Above, AboveOrEqual, Under, UnderOrEqual, NotUnder オペレーターを使用する階層クエリーはリソース消費制限の為、上限が既定では 100 階層に設定されています。この制限は管理者用の PowerShell で変更する事が出来ます（詳細は Windows PowerShell を使用した展開の管理を参照下さい）。

FetchXMLクエリの説明

例として以下の階層構造を使用したクエリの動作を説明します。

NotUnder - 自己レコード以外のすべての子レコードを除外する

NotUnder は他のオペレーターと組み合わせると動作が理解しやすい為、eq-or-under, under, not-under の順で 3 段階に分けて説明します。

eq-or-under : アドベンチャーワークス

このクエリーではアドベンチャーワークスを含め、子レコードがすべて返ります。

<fetchversion="1.0" output-format="xml-platform" mapping="logical" distinct="false">
  <entity name="account">
    <attribute name="name" />
    <attributename="accountid" />
    <orderattribute="name" descending="false" />
    <filter type="and">
      <condition attribute="accountid" operator="eq-or-under"
                          value="{7696AC99-3E76-E411-810A-E83935C2E3BA}" />
    </filter>
  </entity>
</fetch>

実行結果

under : ファブリカム

このクエリーではファブリカム以外のすべての子レコードが返ります。

<fetchversion="1.0" output-format="xml-platform" mapping="logical" distinct="false">
  <entity name="account">
    <attribute name="name" />
    <attributename="accountid" />
    <orderattribute="name" descending="false" />
    <filter type="and">
      <condition attribute="accountid" operator="under"
                          value=”{7896AC99-3E76-E411-810A-E83935C2E3BA}" />
    </filter>
  </entity>
</fetch>

実行結果

eq-or-under : アドベンチャーワークス と
not-under : ファブリカム の組み合わせ

このクエリーではアドベンチャーワークスを含むすべての子レコードの中から、ファブリカムの下のレコードが除外された結果が返ります。

<fetchversion="1.0" output-format="xml-platform" mapping="logical" distinct="false">
  <entity name="account">
    <attribute name="name" />
    <attributename="accountid" />
    <orderattribute="name" descending="false" />
    <filter type="and"> 
      <condition attribute="accountid" operator="eq-or-under"
                          value="{7696AC99-3E76-E411-810A-E83935C2E3BA}" />
      <condition attribute="accountid" operator="not-under" 
                          value=”{7896AC99-3E76-E411-810A-E83935C2E3BA}" />
    </filter>
  </entity>
</fetch>

実行結果

rowaggregate - 階層構造で一致するレコード数の取得

条件に一致する子レコードが何件あるか件数を取得するには、FetchXML の rowaggregate 属性を使用します。この属性の値が CountChildren に設定されている場合、この属性の値は EntityCollection に含まれる合計の子レコード数を表します。

under : アドベンチャーワークス
rowaggregate CountChildren

以下のクエリーは AccountChildlen 集計値を持ち、「アドベンチャーワークス」が親であるレコードが持つ子レコードの件数を返します。

<fetchdistinct='false' no-lock='false' mapping='logical'>
  <entityname='account'> 
    <attributename='name' /> 
    <attribute name='accountid' />
     <attributename='accountid' rowaggregate='CountChildren' alias='AccountChildren'/>
      <filtertype='and'> 
        <conditionattribute='accountid' operator='under'
         value='{7696AC99-3E76-E411-810A-E83935C2E3BA}' /> 
      </filter> 
  </entity>
</fetch>

実行結果

OData Endpoint について

階層構造クエリーをサポートする為の変更は行われていません。

まとめ

階層構造を検索する為の機能が追加され、階層構造が扱いやすくなりました。是非お試し下さい。

- Kensuke Kitazawa

参照情報
Query hierarchical data
https://msdn.microsoft.com/en-us/library/dn817893.aspx