רכיב תכונה

מציין עמודה מתוך ישות אוישות קישור להחזרה עם שאילתה.

למד כיצד לבחור עמודות באמצעות 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. בעת שימוש במחלקה FetchXmlToQueryExpressionRequest של SDK, הגדרה זו תאבד. אין דרך להגדיר זאת באמצעות QueryExpression.

רכיבי אב

שם	תיאור‬‏‫‬
ישות	מציין את רכיב הצאצא עבור רכיב Fetch, 'ישות האב' עבור השאילתה. מותרת ישות אחת בלבד.
ישות קישור	צירוף טבלה הקשורה לישות או לישותהקישור כדי להחזיר עמודות נוספות עם התוצאה. משמש גם עם רכיבי מסנן כדי להחיל תנאים על ערכי עמודות בטבלאות קשורות.

פונקציות צבירה

השתמש בפונקציות צבירה אלה. למד כיצד לצבור נתונים באמצעות FetchXml

פונקציה	ערך החזרה
avg	הערך הממוצע של ערכי העמודות עם נתונים.
count	מספר השורות.
countcolumn	מספר השורות המכילות נתונים בעמודה זו.
max	הערך המרבי של השורות בעמודה זו.
min	הערך המינימלי של השורות בעמודה זו.
sum	הערך הכולל של ערכי העמודות עם נתונים.

אפשרויות קיבוץ תאריכים

קבל מידע נוסף על קיבוץ לפי חלקים של תאריך

Value	תיאור‬‏‫‬
day	קיבוץ לפי יום בחודש
week	קיבוץ לפי שבוע בשנה
month	קבץ לפי חודש בשנה
quarter	קבץ לפי רבעון של שנת הכספים
year	קבץ לפי שנה
fiscal-period	קבץ לפי תקופה של שנת הכספים
fiscal-year	קבץ לפי שנת הכספים

קבל מידע נוסף על הגדרות שנת כספים