שתף באמצעות

הפונקציה DataSourceInfo

  • מאמר

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

אספקת מידע בנוגע למקור נתונים.

מבט כולל

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

אתה יכול להשתמש במידע ברמת העמודה כדי לאמת את קלט המשתמש ולספק משוב מיידי למשתמש לפני השימוש בפונקציה Patch. הפונקציה Validate משתמשת באותו מידע.

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

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

הערה

נכון לעכשיו, הפונקציה DataSourceInfo אינה נתמכת ב'רשימות Microsoft'.

תיאור

פרטי עמודה

ניתן להשתמש ב- DataSourceInfo כדי לקבל מידע על עמודה מסוימת של מקור נתונים:

ארגומנט מידע סוג תוצאה תיאור
DataSourceInfo.DisplayName מחרוזת שם תצוגה עבור העמודה. אם לא מוגדר שם תצוגה, החזרת שם העמודה.
DataSourceInfo.MaxLength מספר מספר התווים המרבי שהעמודה יכולה להכיל. חל רק על עמודות המכילות מחרוזות. אם לא נקבע ערך מרבי, החזרת הערך ריק.
DataSourceInfo.MaxValue מספר ערך מספרי מרבי שעמודה יכולה להכיל. חל רק על עמודות המכילות מספרים. אם לא נקבע ערך מרבי, החזרת הערך ריק.
DataSourceInfo.MinValue מספר ערך מספרי מינימלי שעמודה יכולה להכיל. חל רק על עמודות המכילות מספרים. אם לא נקבע ערך מינימלי, החזרת הערך ריק.
DataSourceInfo.Required בוליאני האם ‏‏נדרש ערך עבור עמודה זו? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך false.

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

פרטי מקור נתונים

ניתן גם להשתמש ב- DataSourceInfo כדי לקבל מידע על מקור נתונים באופן כללי:

ארגומנט מידע סוג תוצאה תיאור
DataSourceInfo.AllowedValues בוליאני אילו סוגי הרשאות יכולים משתמשים להעניק למקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך ריק.
DataSourceInfo.CreatePermission Boolean האם למשתמש הנוכחי יש הרשאה ליצור רשומות במקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך true.
DataSourceInfo.DeletePermission Boolean האם למשתמש הנוכחי יש הרשאה למחוק רשומות במקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך true.
DataSourceInfo.EditPermission Boolean האם למשתמש הנוכחי יש הרשאה לערוך רשומות במקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך true.
DataSourceInfo.ReadPermission Boolean האם למשתמש הנוכחי יש הרשאה לקרוא רשומות במקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך true.

הערה

DataSourceInfo מחזיר true אם הוא לא יכול לקבוע אם למשתמש הנוכחי יש את ההרשאה המבוקשת. ההרשאות ייבדקו שוב על ידי השרת כאשר הפעולה בפועל מתבצעת, ומוצגת שגיאה אם ביצוע הפעולה לא הותר. לעת עתה, הרשאות הבודקות עם DataSourceInfo אפשריות רק בעת שימוש ב- Microsoft Dataverse.

תחביר

DataSourceInfo( DataSource, Information [, ColumnName] )

  • DataSource – נדרש. מקור הנתונים שיש להשתמש בו.
  • מידע - נדרש. סוג המידע שברצונך לאחזר.
  • ColumnName – אופציונלי. שם העמודה שעבורה רוצים לאחזר מידע ברמת העמודה. לקבלת מידע ברמת מקור הנתונים, לא ניתן להשתמש בארגומנט ColumnName.

הערה

ב- Power Apps לפני גרסה 3.24042, שמות העמודות צוינו עם מחרוזת טקסט באמצעות מרכאות כפולות, ואם מחוברים למקור נתונים הם גם צריכים להיות שמות לוגיים. לדוגמה, השם הלוגי "cr43e_name" עם מרכאות כפולות שימש במקום שם תצוגה שם ללא מרכאות. עבור מקורות נתונים של SharePoint ו-Excel המכילים שמות עמודות עם רווחים, כל רווח צוין עם "_x0020_", למשל "שם העמודה" כמו "Column_x0020_Name". אחרי גרסה זו, כל האפליקציות עודכנו אוטומטית לתחביר החדש המתואר במאמר זה.

דוגמאות

הדוגמאות בסעיף זה משתמשות במקור נתונים זה, ששמו גלידה:

דוגמה של גלידה.

מקור הנתונים סיפק גם מידע זה:

  • שם התצוגה עבור כמות הוא "כמות זמינה".
  • האורך המרבי של טעם הוא 30 תווים.
  • העמודה טעם חייב להכיל ערך. העמודה כמות אינה הכרחית.
  • הערך המינימלי של כמות הוא 0.
  • הערך המרבי של כמות הוא 100.
  • המשתמש הנוכחי יכול לקרוא ולערוך את הרשומות של מקור הנתונים גלידה אך אינו יכול ליצור או למחוק רשומות.
נוסחה תיאור תוצאה
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantity ) החזרת שם התצוגה של העמודה כמות של מקור הנתונים גלידה. "כמות זמינה"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavor ) החזרת האורך המרבי של המחרוזת עבור העמודה טעם של מקור הנתונים גלידה. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) האם העמודה טעם של מקור הנתונים גלידה נדרשת? true
DataSourceInfo( IceCream, DataSourceInfo.Required, Quantity ) האם העמודה כמות של מקור הנתונים גלידה נדרשת? false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantity ) החזרת הערך המספרי המרבי של העמודה כמות של מקור הנתונים גלידה. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity ) החזרת הערך המספרי המינימלי של העמודה כמות של מקור הנתונים גלידה. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) האם המשתמש הנוכחי יכול לקרוא רשומות במקור הנתונים גלידה? true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) האם המשתמש הנוכחי יכול לערוך רשומות במקור הנתונים גלידה? true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) האם המשתמש הנוכחי יכול ליצור רשומות במקור הנתונים גלידה? false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) האם המשתמש הנוכחי יכול למחוק רשומות במקור הנתונים גלידה? false