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>

Attributes

名稱	Required?	Description
aggregate	否	要套用的 彙總函數 。 瞭解如何使用 FetchXml 彙總資料
alias	否	要傳回的資料行名稱。 每個資料行都必須有唯一的名稱。 當您擷取彙總值時，您將使用別名。 進一步瞭解資料欄別名。
dategrouping	否	當您依日期時間值將資料分組時，此屬性會指定要使用的日期部分。 請參閱 日期分組選項
distinct	否	當您使用彙總 countcolumn 函數時，此屬性會指定只傳回直欄的唯一值。 深入瞭解相異資料行值。
groupby	否	當您彙總資料時，此屬性會指定要用來將資料分組的資料行。 深入了解群組。
name	Yes	資料行的邏輯名稱。
rowaggregate	否	當此值設定為 CountChildren 包含記錄的子記錄總數的值時，結果中會包含記錄的子記錄總數。 瞭解如何使用這個屬性。
usertimezone	否	由依日期時間資料行分組的彙總查詢使用。 視時區而定，相同的日期時間值可能落在不同的日期。 瞭解如何依日期的各個部分進行分組 將此屬性與值搭配 false 使用，以強制分組使用 UTC 值。 當您未設定此屬性時，預設值為 true，並使用使用者的時區。 附註： 使用 QueryExpression 時，群組一律使用 UTC。 使用 SDK FetchXmlToQueryExpressionRequest 類別時，此設定會遺失。 無法 使用 QueryExpression 來設定此專案。

父元素

名稱	Description
實體	指定 提取元素的子元素，即查詢的「父實體」。 只允許一個實體。
連結實體	聯結與 實體 或 連結實體 相關的資料表，以傳回包含結果的其他資料行。 也與 篩選 元素一起使用，以 對相關表格中的欄值套用條件。

聚合函數

使用這些彙總函數。 瞭解如何使用 FetchXml 彙總資料

功能	返回值
avg	具有資料的資料行值的平均值。
count	列數。
countcolumn	該欄中包含資料的列數。
max	該直欄中列的最大值。
min	該欄中列的最小值。
sum	具有資料的資料行值總值。

日期分組選項

進一步瞭解依日期部分進行分組

價值觀	Description
day	按月份中的日期分組
week	按年中的週分組
month	按年中的月份分組
quarter	按會計年度季度分組
year	按年份分組
fiscal-period	按會計年度期間分組
fiscal-year	按會計年度分組

深入瞭解會計年度設定