Collect, Clearופונקציות ClearCollect

פונקציה	חל על
Clear	אפליקציות Canvas שולחן העבודה זורם פונקציות CLI Dataverse של Power Platform
ClearCollect	אפליקציות Canvas לשולחן העבודה זורמות ל- Power Platform CLI
Collect	אפליקציות Canvas שולחן עבודה זורמת אפליקציות מונחות-מודלים פונקציות CLI של Power Platform Dataverse

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

Collect

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

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

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

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

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

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

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

Clear

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

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

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

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

ClearCollect

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

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

הקצאה

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

תחביר

Collect( DataSource, Item, ... )

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

Clear( אוסף )

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

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

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

דוגמאות

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

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

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

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

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

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

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