属性の要素

クエリで返す エンティティ または リンク エンティティ の列を指定します。

FetchXml を使用して列を選択する方法について説明します。

例

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <link-entity name='contact'
      from='contactid'
      to='primarycontactid'
      link-type='inner'
      alias='contact'>
      <attribute name='fullname' />
    </link-entity>
  </entity>
</fetch>

属性

件名	必須?	Description
aggregate	いいえ	適用する 集計関数 です。 FetchXml でデータを集約する方法について解説します
alias	いいえ	返す列の名前です。 各列には一意な名前を付けなければなりません。 集計値を取得する場合は、エイリアスを使用します。 列エイリアスの詳細です。
dategrouping	いいえ	データを日時値でグループ化する場合、この属性は使用する日付部分を指定します。 日付グループ化オプションを参照してください
distinct	いいえ	集約 countcolumn 関数を使用する場合、この属性は列の一意な値のみを返すように指定します。 明確なカラム値について解説します。
groupby	いいえ	データを集計する場合、この属性はデータのグループ化に使用する列を指定します。 グループ化の詳細について解説します。
name	可	列の論理名。
rowaggregate	いいえ	この値が CountChildren に設定されている場合、レコードの子レコードの合計数を含む値は、結果に含まれます。 この属性の使用方法について解説します。
usertimezone	いいえ	日時列ごとにグループ化する集計クエリによって使用されます。 タイムゾーンによっては、同じ日時値が異なる日に該当する場合があります。 日付の部分によるグループ化について この属性を false 値とともに使用して、グループ化に UTC 値を使用するように強制します。 この属性を設定しない場合、既定値は true となり、ユーザーのタイムゾーンが使用されます。 注: QueryExpression では、グループ化には常に UTC が使用されます。 SDK の FetchXmlToQueryExpressionRequest クラスを使用する場合、この設定は失われます。 QueryExpression を使用してこれを設定する方法はありません。

親要素

件名	Description
エンティティ	取り込み要素 の子要素、つまりクエリの「親エンティティ」を指定します。 エンティティは 1 つだけ許可されます。
link-entity	エンティティ または リンク エンティティ に関連するテーブルを結合して、結果を含む多くの列を返します。 また、関連するテーブルの列の値に条件を適用するために、フィルター要素と共に使用されます。

Aggregate 関数

これらの集計関数を使用します。 FetchXml でデータを集約する方法について解説します

Function	値を返す
avg	データを持つ列値の平均値です。
count	返される行の数です。
countcolumn	その列にデータがある行の数です。
max	その列に含まれる行の最大値です。
min	その列に含まれる行の最小値です。
sum	データを持つ列値の合計値です。

日付グループ化オプション

日付の部分によるグループ化の詳細について

価値	Description
day	日付でのグループ化
week	週でのグループ化
month	月でのグループ化
quarter	会計年度の四半期でのグループ化
year	年でのグループ化
fiscal-period	会計年度の期でのグループ化
fiscal-year	会計年度でのグループ化

会計年度設定に関する詳細情報