إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
تطبيقات اللوحة التي تستند إلى نموذج التطبيقات
توفير معلومات حول مصدر البيانات.
نظرة عامة
يمكن أن توفر مصادر البيانات ثروة من المعلومات لتحسين تجربة المستخدم.
يمكنك استخدام المعلومات على مستوى column للتحقق من صحة إدخال المستخدم وتوفير تعليقات فورية للمستخدم قبل استخدام وظيفة Patch. تستخدم وظيفة Validate هذه المعلومات نفسها.
يمكنك استخدام المعلومات الموجودة في مستوي مصدر البيانات، على سبيل المثال، لتعطيل أو إخفاء الزرين تحرير وجديد للمستخدمين الذين ليس لديهم أذونات لتحرير وإنشاء السجلات.
تختلف مصادر البيانات في مقدار المعلومات التي توفرها، بما في ذلك عدم تقديم أي منها على الإطلاق. لا توفر المجموعات أي معلومات. إذا لم يتم توفير جزء من المعلومات، فإنه يتم استخدام الإعداد الافتراضي أو يتم إرجاع فارغ.
ملاحظة
حاليا، الدالة DataSourceInfo غير معتمدة في قوائم Microsoft.
الوصف
معلومات العمود
يمكنك استخدام DataSourceInfo للحصول على معلومات حول عمود معين من مصدر بيانات:
| وسيطة المعلومات | نوع النتيجة | الوصف |
|---|---|---|
| DataSourceInfo. DisplayName | سلسلة | اسم عرض العمود. وفي حالة عدم تحديد أي اسم عرض، يتم إرجاع اسم العمود. |
| DataSourceInfo. MaxLength | الرقم | الحد الأقصى لعدد الأحرف التي يمكن أن يحتوي عليها العمود. ينطبق فقط على الأعمدة التي تحتوي على سلاسل. إذا لم يتم تعيين الحد الأقصى، فإنه يتم إرجاع فارغ. |
| DataSourceInfo. MaxValue | الرقم | الحد الأقصى للقيمة الرقمية التي يمكن أن يحتوي عمود عليها. ينطبق فقط على الأعمدة التي تحتوي على أرقام. إذا لم يتم تعيين الحد الأقصى، فإنه يتم إرجاع فارغ. |
| DataSourceInfo. قيمة أدنى | الرقم | الحد الأدنى للقيمة الرقمية التي يمكن أن يحتوي عمود عليها. ينطبق فقط على الأعمدة التي تحتوي على أرقام. إذا لم يتم تعيين الحد الأدنى، فإنه يتم إرجاع فارغ. |
| DataSourceInfo. مطلوب | منطقي | هل القيمة مطلوبة لهذا العمود؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع خطأ. |
والوسيطة الثالثة هي اسم العمود كسلسلة. على سبيل المثال، يتم تمرير عمود الهاتف في مجموعة الأشخاص كـ "هاتف"، بما في ذلك علامات الاقتباس المزدوجة.
معلومات مصدر البيانات
يمكنك أيضا استخدام DataSourceInfo للحصول على معلومات حول مصدر بيانات ككل:
| وسيطة المعلومات | نوع النتيجة | الوصف |
|---|---|---|
| DataSourceInfo. القيم المسموح بها | منطقي | ما أنواع الأذونات التي يمكن منحها للمستخدمين لمصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع فارغ. |
| DataSourceInfo. CreatePermission | منطقي | هل يمتلك المستخدم الحالي إذنًا لإنشاء سجلات في مصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع صواب. |
| DataSourceInfo. DeletePermission | منطقي | هل يمتلك المستخدم الحالي إذنًا لحذف سجلات في مصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع صواب. |
| DataSourceInfo. تحرير التفويض | منطقي | هل يمتلك المستخدم الحالي إذنًا لتحرير سجلات في مصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع صواب. |
| DataSourceInfo. أذونات القراءة | منطقي | هل يمتلك المستخدم الحالي إذنًا لقراءة سجلات في مصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع صواب. |
ملاحظة
DataSourceInfo إرجاع true إذا لم يتمكن من تحديد ما إذا كان المستخدم الحالي لديه الإذن المطلوب. سيتم التحقق من الأذونات مرة أخرى بواسطة الخادم عند بدء تشغيل العملية الفعلية وعرض خطأ إذا لم يكن مسموحا به. في الوقت الحالي، لا يمكن التحقق من الأذونات إلا DataSourceInfo عند استخدام Microsoft Dataverse.
بناء الجملة
DataSourceInfo( DataSource, Information [, ColumnName] )
- DataSource – مطلوب. مصدر البيانات المُراد استخدامه.
- معلومات - مطلوبة. نوع المعلومات التي تريد استردادها.
- ColumnName - اختياري. اسم العمود الذي سيتم استرداد المعلومات على مستوى العمود له. للحصول على معلومات حول مستوى مصدر البيانات، لا يمكن استخدام وسيطة اسم العمود.
ملاحظة
قبل Power Apps الإصدار 3.24042، كانت أسماء الأعمدة محددة بسلسلة نصية باستخدام علامات اقتباس مزدوجة، وإذا كانت مرتبطة مصدر البيانات فهي تحتاج أيضا إلى أسماء منطقية. على سبيل المثال، استخدم الاسم المنطقي "cr43e_name"مع علامات اقتباس مزدوجة بدلا من اسم العرض Name بدون عروض أسعار. بالنسبة SharePoint لمصادر بيانات Excel التي تحتوي على أسماء أعمدة ذات المسافات، يتم تحديد كل مسافة باستخدام "_x0020_"، على سبيل المثال، "اسم العمود" Column_x0020_Name". بعد هذا الإصدار، يتم تحديث كافة التطبيقات تلقائيًا إلى الجملة الجديدة الموضحة في هذه المقالة.
الأمثلة
تستخدم الأمثله الموجودة في هذا القسم مصدر البيانات هذا المسمى IceCream:
وفر مصدر البيانات أيضًا هذه المعلومات:
- اسم عرض الكميةهو "الكمية المتاحة".
- الحد الأقصى لطول الميزة هو 30 حرفًا.
- يجب أن يحتوي عمود الميزة على قيمة. عمود الكمية غير مطلوب.
- الحد الأدنى للكمية هو 0.
- الحد الأقصى للكمية هو 100.
- يستطيع المستخدم الحالي قراءة وتحرير سجلات مصدر بيانات IceCream ولكن لا يمكنه إنشاء السجلات أو حذفها.
| صيغة | الوصف | نتيجة |
|---|---|---|
| DataSourceInfo( IceCream, DataSourceInfo. DisplayName, Quantity ) | إرجاع اسم العرض لعمود الكمية لمصدر بيانات IceCream. | "الكمية المتاحة" |
| DataSourceInfo( IceCream, DataSourceInfo. MaxLength، نكهة ) | إرجاع الحد الأقصى لطول سلسلة عمود الميزة في مصدر بيانات IceCream. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo. مطلوب، نكهة ) | هل عمود الميزة الخاص بمصدر بيانات IceCream مطلوب؟ | صحيح |
| DataSourceInfo( IceCream, DataSourceInfo. مطلوب، كمية ) | هل عمود الكمية الخاص بمصدر بيانات IceCream مطلوب؟ | خطأ |
| DataSourceInfo( IceCream, DataSourceInfo. MaxValue, Quantity ) | إرجاع الحد الأقصى للقيمة الرقمية لعمود الكمية الخاص بمصدر بيانات IceCream. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo. MinValue, Quantity ) | إرجاع الحد الأدنى للقيمة الرقمية لعمود الكمية الخاص بمصدر بيانات IceCream. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo. ReadPermission) | هل يستطيع المستخدم الحالي قراءة السجلات الموجودة في مصدر بيانات IceCream؟ | صحيح |
| DataSourceInfo( IceCream, DataSourceInfo. EditPermission) | هل يستطيع المستخدم الحالي تحرير السجلات الموجودة في مصدر بيانات IceCream؟ | صحيح |
| DataSourceInfo( IceCream, DataSourceInfo. CreatePermission) | هل يستطيع المستخدم الحالي إنشاء السجلات الموجودة في مصدر بيانات IceCream؟ | خطأ |
| DataSourceInfo( IceCream, DataSourceInfo. DeletePermission) | هل يستطيع المستخدم الحالي حذف السجلات الموجودة في مصدر بيانات IceCream؟ | خطأ |