שתף באמצעות

הפונקציה DataSourceInfo

  • מאמר

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

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

מבט כולל

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

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

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

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

הערה

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

Description

פרטי עמודה

ניתן להשתמש ב- 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 ) האם העמודה טעם של מקור הנתונים גלידה נדרשת? נָכוֹן
DataSourceInfo( IceCream, DataSourceInfo.Required, Quantity) האם העמודה כמות של מקור הנתונים גלידה נדרשת? שֶׁקֶר
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantity) החזרת הערך המספרי המרבי של העמודה כמות של מקור הנתונים גלידה. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity) החזרת הערך המספרי המינימלי של העמודה כמות של מקור הנתונים גלידה. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) האם המשתמש הנוכחי יכול לקרוא רשומות במקור הנתונים גלידה? נָכוֹן
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) האם המשתמש הנוכחי יכול לערוך רשומות במקור הנתונים גלידה? נָכוֹן
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) האם המשתמש הנוכחי יכול ליצור רשומות במקור הנתונים גלידה? שֶׁקֶר
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) האם המשתמש הנוכחי יכול למחוק רשומות במקור הנתונים גלידה? שֶׁקֶר