属性の要素
クエリで返す エンティティ または リンク エンティティ の列を指定します。
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を使用してこれを設定する方法はありません 。 |
親要素
件名 | プロパティ |
---|---|
エンティティ | 取り込み要素 の子要素、つまりクエリの「親エンティティ」を指定します。 エンティティは 1 つだけ許可されます。 |
link-entity | エンティティ または リンク エンティティ に関連するテーブルを結合して、結果を含む多くの列を返します。 また、関連するテーブルの列の値に条件を適用するために、フィルター要素と共に使用されます。 |
Aggregate 関数
これらの集計関数を使用します。 FetchXml でデータを集約する方法について解説します
Function | 値を返す |
---|---|
avg |
データを持つ列値の平均値です。 |
count |
返される行の数です。 |
countcolumn |
その列にデータがある行の数です。 |
max |
その列に含まれる行の最大値です。 |
min |
その列に含まれる行の最小値です。 |
sum |
データを持つ列値の合計値です。 |
日付グループ化オプション
価値 | Description |
---|---|
day |
日付でのグループ化 |
week |
週でのグループ化 |
month |
月でのグループ化 |
quarter |
会計年度の四半期でのグループ化 |
year |
年でのグループ化 |
fiscal-period |
会計年度の期でのグループ化 |
fiscal-year |
会計年度でのグループ化 |
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。