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

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

Collect

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

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

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

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

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

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

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

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

Clear

חל על: יישומי בד ציור

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

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

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

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

ClearCollect

חל על: יישומי בד ציור יישומים מונחי דגמים

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

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

הקצאה

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

תחביר

Collect( DataSource, Item, ... )‎

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

Clear( Collection )

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

ClearCollect( Collection, Item, ... )

• Collection – נדרש. האוסף שברצונך לנקות ולאחר מכן להוסיף אליו נתונים.
• Item(s)‎ - נדרש. רשומה או טבלה אחת או יותר להוספה למקור הנתונים.

דוגמאות

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

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

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

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

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

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

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