елемент атрибута

Визначає стовпець від сутності або сутності-зв'язку для повернення із запитом.

Дізнайтеся, як вибрати стовпці за допомогою 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>

Атрибути

Унікальне ім'я	Обов’язкове?	Опис
aggregate	Ні	Агрегатна функція для застосування. Дізнайтеся, як агрегувати дані за допомогою FetchXml
alias	Ні	Ім'я стовпця, який потрібно повернути. Кожен стовпець має мати унікальне ім'я. Псевдоніми використовуватимуться під час отримання агрегатних значень. Дізнайтеся більше про псевдоніми стовпців.
dategrouping	Ні	Якщо згрупувати дані за значенням дати й часу, цей атрибут визначає частину дати, яку потрібно використовувати. Див . параметри групування дат
distinct	Ні	Під час використання агрегатних countcolumn функцій цей атрибут указує, що повертаються лише унікальні значення для стовпця. Дізнайтеся більше про окремі значення стовпців.
groupby	Ні	Під час агрегації даних цей атрибут визначає стовпець для групування даних. Докладніше про групування.
name	Так	Логічне ім'я стовпця.
rowaggregate	Ні	Якщо для цього значення встановлено CountChildren значення, яке містить загальну кількість дочірніх записів для запису, буде включено до результатів. Дізнайтеся, як використовувати цей атрибут.
usertimezone	Ні	Використовується агрегатних запитів, які групуватимуться за стовпцями дати й часу. Залежно від часового поясу однакове значення дати й часу може припадати в різні дні. Відомості про групування за частинами дати Використовуйте цей атрибут зі значенням false , щоб змусити групування використовувати значення UTC. Якщо не встановити цей атрибут, значення за замовчуванням – true, і використовується часовий пояс користувача. Примітка. З QueryExpression групування завжди використовує UTC. Під час використання класу SDK FetchXmlToQueryExpressionRequest цей параметр втрачається. Не можна встановити цей параметр за допомогою QueryExpression.

Батьківські елементи

Унікальне ім'я	Опис
Сутності	Указує дочірній елемент для елемента віддаленого доступу – батьківську сутність запиту. Дозволено лише одну сутність.
зв'язування сутності	Об'єднує таблицю, пов'язану з сутністю або об'єктом-зв'язком , щоб повернути додаткові стовпці з результатом. Також використовується з елементами фільтра для застосування умов до значень стовпців у пов'язаних таблицях.

Агрегатні функції

Використовуйте ці агрегатні функції. Дізнайтеся, як агрегувати дані за допомогою FetchXml

Function	Значення, що повертається
avg	Середнє значення значень стовпців із даними.
count	Кількість рядків.
countcolumn	Кількість рядків із даними в цьому стовпці.
max	Максимальне значення рядків у цьому стовпці.
min	Мінімальне значення рядків у цьому стовпці.
sum	Загальне значення значень стовпців із даними.

Параметри групування дат

Докладніше про групування за частинами дати

Цінність	Опис
day	Групування за днем місяця
week	Групування за тижнем року
month	Групування за місяцями року
quarter	Групування за кварталом фінансового року
year	Групування за роком
fiscal-period	Групування за періодом фінансового року
fiscal-year	Групування за фінансовим роком

Докладніше про настройки фінансового року