通过

attribute 元素

指定要使用查询返回的 实体 或 链接实体 中的列。

了解如何使用 FetchXml 选择列。

Example

<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>

特性

Name Required? Description
aggregate 否 要应用的 聚合函数 。 了解如何使用 FetchXml 聚合数据
alias 否 要返回的列的名称。 每个列必须具有唯一的名称。 检索聚合值时，将使用别名。 详细了解列别名。
dategrouping 否 按日期/时间值对数据进行分组时，此属性指定要使用的日期部分。 请参阅 日期分组选项
distinct 否 使用聚合 countcolumn 函数时，此属性指定只返回列的唯一值。 详细了解不同的列值。
groupby 否 聚合数据时，此属性指定要用于对数据进行分组的列。 了解有关分组的更多信息。
name 是的 列的逻辑名称。
rowaggregate 否 当此值设置为 CountChildren 包含记录的子记录总数的值时，结果中将包含记录的子记录总数。 了解如何使用此属性。
usertimezone 否 由按日期/时间列分组的聚合查询使用。 根据时区，同一日期/时间值可以在不同的日期下降。 了解按日期的各个部分进行分组

将此属性与值一起使用 false 以强制分组使用 UTC 值。 如果未设置此属性，则默认值为 true，并使用用户的时区。

注意：使用 QueryExpression，分组始终使用 UTC。 使用 SDK FetchXmlToQueryExpressionRequest 类时，此设置将丢失。 使用 QueryExpression 无法设置此设置。

父元素

Name Description
实体 指定 提取元素的子元素，即查询的“父实体”。 只允许一个实体。
link-entity 联接与 实体 或 链接实体 相关的表，以返回包含结果的其他列。 还与 筛选器 元素一起使用，以 对相关表中的列值应用条件。

聚合函数

使用这些聚合函数。 了解如何使用 FetchXml 聚合数据

功能 返回值
avg 包含数据的列值的平均值。
count 行数。
countcolumn 包含该列中数据的行数。
max 该列中行的最大值。
min 该列中行的最小值。
sum 包含数据的列值的总计值。

日期分组选项

了解有关按日期部分分组的详细信息

价值 Description
day 按月的日期分组
week 按年份的一周分组
month 按年度月份分组
quarter 按会计年度季度分组
year 按年份分组
fiscal-period 按会计年度期间分组
fiscal-year 按会计年度分组

详细了解会计年度设置