שתף באמצעות

הפונקציה RecordInfo

  • מאמר

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

מספק מידע אודות רשומה של מקור נתונים.

השתמש ב- RecordInfo כדי לקבל מידע על רשומה מסוימת של מקור נתונים. מקור הנתונים מוכרח להיות טבלאי ותואם לפונקציות Remove ו- Patch.

לעת עתה, קיימת תמיכה רק ב- ‏‏Microsoft Dataverse. רשומות מכל מקורות הנתונים האחרים יגרמו לשגיאת נוסחה.

המידע הזמין:

ארגומנט מידע תיאור
RecordInfo.DeletePermission האם למשתמש הנוכחי יש הרשאה להסיר רשומה זו ממקור הנתונים?
RecordInfo.EditPermission האם למשתמש הנוכחי יש הרשאה לשנות רשומה זו במקור הנתונים?
RecordInfo.ReadPermission האם למשתמש הנוכחי יש הרשאה לקרוא רשומה זו ממקור הנתונים?

RecordInfo מחזיר ערך בוליאני:

ערך החזרה תיאור
נָכוֹן למשתמש יש הרשאה.
שֶׁקֶר למשתמש אין הרשאה. אם הרשומה היא ריקה הפונקציה RecordInfo תחזיר גם false.

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

תחביר

RecordInfo( Record, מידע )

  • רשומה - חובה. הרשומה לבדיקה.
  • מידע – נדרש. המידע הרצוי עבור הרשומה.

דוגמאות

RecordInfo( First(Accounts), RecordInfo.EditPermission )

בודקת את הרשאת העריכה עבור הרשומה הראשונה במקור הנתונים Accounts, שיכול להיות Dataverse, SharePoint,‏ SQL Server או מקור נתונים טבלאי אחר. אם למשתמש יש הרשאה לערוך רשומה זו ולשנות את מקור הנתונים Accounts באופן כללי, הפונקציה RecordInfo תחזיר true.

With( { MyRecord: First( Accounts ) },
      RecordInfo( MyRecord, RecordInfo.EditPermission ) )

לוכדת רשומה באמצעות הפונקציה With ולאחר מכן מעבירה ערך זה אל הפונקציה RecordInfo. התוצאה תהיה זהה לדוגמה האחרונה.

Collect( MyAccounts, FirstN( Accounts, 10 ) );
RecordInfo( First( MyAccounts ), RecordInfo.EditPermission ) )

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

Collect( MyCollection, [ 1, 2, 3 ] );
RecordInfo( First(MyCollection), RecordInfo.DeletePermission )

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