عنصر السمة

تحديد عمود من كيان أو كيان ارتباط لإرجاعه مع استعلام.

تعرف على كيفية تحديد الأعمدة باستخدام 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>

سمات

Name	مطلوب؟	الوصف
aggregate	لا	الدالة التجميعية التي يجب تطبيقها. تعرف على كيفية تجميع البيانات باستخدام FetchXml
alias	لا	اسم العمود المراد إرجاعه. يجب أن يكون لكل عمود اسم فريد. ستستخدم الأسماء المستعارة عند استرداد القيم التجميعية. تعرف على المزيد حول الأسماء المستعارة للعمود.
dategrouping	لا	عند تجميع البيانات حسب قيمة التاريخ والوقت، تحدد هذه السمة جزء التاريخ المراد استخدامه. راجع خيارات تجميع التاريخ
distinct	لا	عند استخدام الدالة التجميعية countcolumn ، تحدد هذه السمة إرجاع القيم الفريدة للعمود فقط. تعرف على المزيد حول قيم الأعمدة المميزة.
groupby	لا	عند تجميع البيانات، تحدد هذه السمة العمود الذي يجب استخدامه لتجميع البيانات. معرفة المزيد حول التجميع
name	‏‏نعم‬	الاسم المنطقي للعمود.
rowaggregate	لا	عند تعيين هذه القيمة إلى CountChildren قيمة تتضمن إجمالي عدد السجلات التابعة للسجل يتم تضمينها في النتائج. تعرف على كيفية استخدام هذه السمة.
usertimezone	لا	يستخدم بواسطة الاستعلامات التجميعية التي يتم تجميعها حسب أعمدة التاريخ والوقت. اعتمادا على المنطقة الزمنية، يمكن أن تقع نفس قيمة التاريخ والوقت في أيام مختلفة. تعرف على التجميع حسب أجزاء من التاريخ استخدم هذه السمة بقيمة false لفرض التجميع على استخدام قيمة UTC. عندما لا تقوم بتعيين هذه السمة، تكون القيمة الافتراضية هي true، ويتم استخدام المنطقة الزمنية للمستخدم. ملاحظة: باستخدام QueryExpression، يستخدم التجميع دائما التوقيت العالمي المتفق عليه. عند استخدام فئة SDK FetchXmlToQueryExpressionRequest، يتم فقدان هذا الإعداد. لا توجد طريقة لتعيين هذا باستخدام QueryExpression.

العناصر الأصلية

Name	الوصف
كيان	تحديد العنصر التابع لعنصر إحضار، "الكيان الأصل" للاستعلام. يسمح بوحدة واحدة فقط.
ارتباط الكيان	ربط جدول مرتبط بالوحدة أو كيان الارتباط لإرجاع أعمدة إضافية بالنتيجة. يستخدم أيضا مع عناصر التصفيةلتطبيق الشروط على قيم الأعمدة في الجداول ذات الصلة.

وظائف التجميع

استخدم هذه الدالات التجميعية. تعرف على كيفية تجميع البيانات باستخدام FetchXml

الوظيفة	قيمة الإرجاع
avg	متوسط قيمة قيم العمود مع البيانات.
count	عدد الصفوف.
countcolumn	عدد الصفوف التي تحتوي على بيانات في هذا العمود.
max	الحد الأقصى لقيمة الصفوف في هذا العمود.
min	الحد الأدنى لقيمة الصفوف في هذا العمود.
sum	القيمة الإجمالية لقيم العمود مع البيانات.

خيارات تجميع التاريخ

تعرف على المزيد حول التجميع حسب أجزاء من التاريخ

القيمة‬	الوصف
day	التجميع حسب يوم من الشهر
week	التجميع حسب الأسبوع من السنة
month	التجميع حسب الشهر من السنة
quarter	تجميع حسب ربع السنة المالية
year	تجميع حسب السنة
fiscal-period	التجميع حسب فترة السنة المالية
fiscal-year	التجميع حسب السنة المالية

تعرف على المزيد حول إعدادات السنة المالية