הפונקציות Collect,‏ Clear ו- ClearCollect‏

יוצר ומנקה אוספים ומוסיף רשומות למקור נתונים.

Collect

חל על: אפליקציות קנבס כרטיסים Dataverse בתכנות פשוט יישומי פלאגין Power Platform CLI זרימות שולחן העבודה

הפונקציה Collect מוסיפה רשומות למקור נתונים. הפריטים שניתן להוסיף:

• ערך יחיד: הערך ממוקם בשדה Value של רשומה חדשה. כל המאפיינים האחרים נותרו במצב Blank.
• רשומה: כל מאפיין בעל שם נמצא במאפיין התואם של רשומה חדשה. כל המאפיינים האחרים נותרו במצב ריק.
• טבלה: כל רשומה של הטבלה נוספת כרשומה נפרדת של מקור הנתונים כפי שתואר לעיל. הטבלה אינה נוספת כטבלה מקוננת לרשומה. לשם כך, אפשר תחילה לטבלה לגלוש ברשומה.

כאשר נעשה בהם שימוש באוסף, עמודות נוספות ייווצרו לפי הצורך. העמודות עבור מקורות נתונים אחרים נקבעות לפי מקור הנתונים ולא ניתן להוסיף עמודות חדשות.

אם מקור הנתונים לא קיים כבר, נוצר אוסף.

אוספים משמשים לעתים לאחסון משתנים כלליים או ליצירת עותק זמני של מקור נתונים. יישומי בד ציור מבוססים על נוסחאות המבצעות חישוב מחדש באופן אוטומטי כאשר המשתמש מקיים אינטראקציה עם יישום. אוספים אינם נהנים מיתרון זה והשימוש בהם יכול להפוך את יצירת היישום והבנתו לקשות יותר. לפני השימוש באוסף באופן זה, עיין בנושא עבודה עם משתנים.

ניתן להשתמש גם בפונקציה Patch כדי ליצור רשומות במקור נתונים.

Collect מחזיר את מקור נתונים שהשתנה כטבלה. Collect ניתן להשתמש רק ב נוסחת התנהגות.

Clear

חל על: אפליקציות קנבס

הפונקציה Clear מוחקת את כל הרשומות של אוסף. העמודות של האוסף יישארו כפי שהן.

שים לב שהפונקציה Clear פועלת רק באוספים ולא במקורות נתונים אחרים. אתה יכול להשתמש בפונקציה RemoveIf( DataSource, true ) לשם כך. נקוט זהירות מכיוון שפעולה זו תסיר את כל הרשומות מן האחסון של מקור הנתונים והיא עשויה להשפיע על משתמשים אחרים.

באפשרותך להשתמש בפונקציה Remove כדי להסיר רשומות באופן בררני.

ל-Clear אין ערך החזרה. ניתן להשתמש בה רק בנוסחה של אופן פעולה.

ClearCollect

חל על: אפליקציות קנבס אפליקציות מונחות דגמים

הפונקציה ClearCollect מוחקת את כל הרשומות מאוסף. ולאחר מכן מוסיפה ערכה אחרת של רשומות לאותו אוסף. עם פונקציה יחידה, ClearCollect מציע את השילוב של Clear ואז Collect.

ClearCollect מחזיר את האוסף שהשתנה כטבלה. ניתן להשתמש ב-ClearCollect רק בנוסחת התנהגות.

הקצאה

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

תחביר

איסוף( מקור נתונים, פריט, ... )

• DataSource – חובה. מקור הנתונים שברצונך להוסיף אליו נתונים. אם הוא לא קיים כבר, נוצר אוסף חדש.
• פריטים - חובה. רשומה או טבלה אחת או יותר להוספה למקור הנתונים.

נקה( אוסף )

• אוסף – חובה. האוסף שברצונך לנקות.

ClearCollect( אוסף, פריט, ... )

• אוסף – חובה. האוסף שברצונך לנקות ולאחר מכן להוסיף אליו נתונים.
• פריטים - חובה. רשומה או טבלה אחת או יותר להוספה למקור הנתונים.

דוגמאות

ניקוי והוספה של רשומות למקור נתונים

בדוגמאות הללו, תבצע מחיקה והוספה באוסף ששמו גלידה. מקור הנתונים מתחיל בתכנים הבאים:

נוסחה	תיאור	תוצאה
ClearCollect( IceCream, { טעם: "תות", כמות: 300 } )	מנקה את כל הנתונים מן האוסף גלידה ולאחר מכן מוסיף רשומה הכוללת כמות של גלידת תות.	גם האוסף גלידה השתנה.
Collect( IceCream, { Flavor: "Pistachio", כמות: 40 }, { Flavor: "כתום", כמות: 200 } )	מוסיף שתי רשומות לאוסף גלידה, שכולל כמות של גלידת פיסטוק ותפוז.	גם האוסף גלידה השתנה.
נקה ( IceCream )	מסיר את כל הרשומות מן האוסף גלידה.	גם האוסף גלידה השתנה.

לקבלת דוגמאות מפורטות המתארות כיצד ליצור אוסף, ראה יצירה ועדכון של אוסף.

רשומות וטבלאות

דוגמאות אלה בוחנות את אופן הטיפול בארגומנטים של רשומות וטבלאות לפונקציה Collect ו- ClearCollect.

נוסחה	תיאור	תוצאה
ClearCollect( IceCream, { טעם: "שוקולד", כמות: 100 }, { טעם: "וניל", כמות: 200 } )	נקה את כל הנתונים ולאחר מכן הוסף שתי רשומות לאוסף גלידה הכולל כמות של גלידת שוקולד ווניל. הרשומות שיש להוסיף מסופקות כארגומנטים בודדים לפונקציה.	גם האוסף גלידה השתנה.
ClearCollect( IceCream, Table( { טעם: "שוקולד", כמות: 100 }, { טעם: "וניל", כמות: 200 } ) )	זהה לדוגמה הקודמת, פרט לכך שהרשומות משולבות בטבלה ומועברות באמצעות ארגומנט בודד. מתבצע חילוץ של תוכן הטבלה רשומה אחר רשומה לפני הוספתו לאוסף גלידה.	גם האוסף גלידה השתנה.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	זהה לדוגמה הקודמת, פרט לכך שהטבלה נכללת ברשומה. הרשומות של הטבלה אינן מחולצות ובמקום זאת הטבלה כולה נוספת כתא של הרשומה.	גם האוסף גלידה השתנה.