הערה
גישה לעמוד זה דורשת אישור. אתה יכול לנסות להיכנס או לשנות תיקיות.
גישה לעמוד זה דורשת אישור. אתה יכול לנסות לשנות מדריכים.
חל על:
אפליקציות Canvas המבוססות על מודלים
אספקת מידע בנוגע למקור נתונים.
מבט כולל
מקורות נתונים יכולים לספק שפע של מידע למיטוב חוויית המשתמש.
אתה יכול להשתמש במידע ברמת העמודה כדי לאמת את קלט המשתמש ולספק משוב מיידי למשתמש לפני השימוש בפונקציה Patch. הפונקציה Validate משתמשת באותו מידע.
ניתן להשתמש במידע ברמת מקור הנתונים, לדוגמה, כדי להשבית או להסתיר את הלחצנים ערוך וחדש למשתמשים שאין להם הרשאות לערוך וליצור רשומות.
מקורות נתונים שונים זה מזה בכמות המידע שהם מספקים, ויש מקורות נתונים שאינם מספקים מידע זה כלל. אוספים לא מספקים מידע. אם לא מסופק מידע כלשהו, נעשה שימוש בברירת מחדל, או שהערך ריק מוחזר.
הערה
בשלב זה, הפונקציה DataSourceInfo אינה נתמכת ברשימות Microsoft.
תיאור
פרטי עמודה
באפשרותך להשתמש כדי DataSourceInfo לקבל מידע אודות עמודה מסוימת של מקור נתונים:
| ארגומנט מידע | סוג תוצאה | תיאור |
|---|---|---|
| DataSourceInfo. שם תצוגה | מחרוזת | שם תצוגה עבור העמודה. אם לא מוגדר שם תצוגה, החזרת שם העמודה. |
| DataSourceInfo. MaxLength | מספר | מספר התווים המרבי שהעמודה יכולה להכיל. חל רק על עמודות המכילות מחרוזות. אם לא נקבע ערך מרבי, החזרת הערך ריק. |
| DataSourceInfo. ערך מרבי | מספר | ערך מספרי מרבי שעמודה יכולה להכיל. חל רק על עמודות המכילות מספרים. אם לא נקבע ערך מרבי, החזרת הערך ריק. |
| DataSourceInfo. ערך מינימום | מספר | ערך מספרי מינימלי שעמודה יכולה להכיל. חל רק על עמודות המכילות מספרים. אם לא נקבע ערך מינימלי, החזרת הערך ריק. |
| DataSourceInfo. חובה | בוליאני | האם נדרש ערך עבור עמודה זו? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך false. |
הארגומנט השלישי הוא שם עמודה כמחרוזת. לדוגמה, העמודה טלפון באוסף אנשים תעבור כ"טלפון" לרבות המרכאות הכפולות.
פרטי מקור נתונים
באפשרותך גם להשתמש DataSourceInfo כדי להשיג מידע אודות מקור נתונים בכללותו:
| ארגומנט מידע | סוג תוצאה | תיאור |
|---|---|---|
| DataSourceInfo. ערכים מותרים | בוליאני | אילו סוגי הרשאות יכולים משתמשים להעניק למקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך ריק. |
| DataSourceInfo. CreatePermission | בוליאני | האם למשתמש הנוכחי יש הרשאה ליצור רשומות במקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך true. |
| DataSourceInfo. DeletePermission | בוליאני | האם למשתמש הנוכחי יש הרשאה למחוק רשומות במקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך true. |
| DataSourceInfo. ערוך חוברת | בוליאני | האם למשתמש הנוכחי יש הרשאה לערוך רשומות במקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך true. |
| DataSourceInfo. קריאה - הקריאה | בוליאני | האם למשתמש הנוכחי יש הרשאה לקרוא רשומות במקור נתונים זה? אם לא הוגדר על-ידי מקור הנתונים, החזרת הערך 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(קרחון, DataSourceInfo. DisplayName, Quantity ) | החזרת שם התצוגה של העמודה כמות של מקור הנתונים גלידה. | "כמות זמינה" |
| DataSourceInfo(קרחון, DataSourceInfo. MaxLength, Flavor ) | החזרת האורך המרבי של המחרוזת עבור העמודה טעם של מקור הנתונים גלידה. | 30 |
| DataSourceInfo(קרחון, DataSourceInfo. נדרש, טעם ) | האם העמודה טעם של מקור הנתונים גלידה נדרשת? | נָכוֹן |
| DataSourceInfo(קרחון, DataSourceInfo. נדרש, כמות ) | האם העמודה כמות של מקור הנתונים גלידה נדרשת? | שֶׁקֶר |
| DataSourceInfo(קרחון, DataSourceInfo. MaxValue, Quantity ) | החזרת הערך המספרי המרבי של העמודה כמות של מקור הנתונים גלידה. | 100 |
| DataSourceInfo(קרחון, DataSourceInfo. MinValue, Quantity ) | החזרת הערך המספרי המינימלי של העמודה כמות של מקור הנתונים גלידה. | 0 |
| DataSourceInfo(קרחון, DataSourceInfo. קריאה קריאה) | האם המשתמש הנוכחי יכול לקרוא רשומות במקור הנתונים גלידה? | נָכוֹן |
| DataSourceInfo(קרחון, DataSourceInfo. EditPermission) | האם המשתמש הנוכחי יכול לערוך רשומות במקור הנתונים גלידה? | נָכוֹן |
| DataSourceInfo(קרחון, DataSourceInfo. CreatePermission) | האם המשתמש הנוכחי יכול ליצור רשומות במקור הנתונים גלידה? | שֶׁקֶר |
| DataSourceInfo(קרחון, DataSourceInfo. DeletePermission) | האם המשתמש הנוכחי יכול למחוק רשומות במקור הנתונים גלידה? | שֶׁקֶר |