مشاركة عبر

دالة DataSourceInfo

  • مقالة

تنطبق على: تطبيقات اللوحة التطبيقات المستندة إلى النموذج

توفير معلومات حول مصدر البيانات.

نظرة عامة‬

يمكن أن توفر مصادر البيانات ثروة من المعلومات لتحسين تجربة المستخدم.

يمكنك استخدام المعلومات على مستوى column للتحقق من صحة إدخال المستخدم وتوفير تعليقات فورية للمستخدم قبل استخدام وظيفة Patch. تستخدم وظيفة Validate هذه المعلومات نفسها.

يمكنك استخدام المعلومات الموجودة في مستوي مصدر البيانات، على سبيل المثال، لتعطيل أو إخفاء الزرين تحرير وجديد للمستخدمين الذين ليس لديهم أذونات لتحرير وإنشاء السجلات.

تختلف مصادر البيانات في مقدار المعلومات التي توفرها، بما في ذلك عدم تقديم أي منها على الإطلاق. المجموعات لا توفر أي معلومات. إذا لم يتم توفير جزء من المعلومات، فإنه يتم استخدام الإعداد الافتراضي أو يتم إرجاع فارغ.

‏‫ملاحظة‬

في الوقت الحالي، لا يتم دعم وظيفة DataSourceInfo في قوائم Microsoft.

الوصف

معلومات العمود

يمكنك استخدام DataSourceInfo للحصول على معلومات حول عمود محدد لمصدر البيانات:

وسيطة المعلومات نوع النتيجة ‏‏الوصف
DataSourceInfo.DisplayName سلسلة اسم عرض العمود. وفي حالة عدم تحديد أي اسم عرض، يتم إرجاع اسم العمود.
DataSourceInfo.MaxLength الرقم الحد الأقصى لعدد الأحرف التي يمكن أن يحتوي عليها العمود. ينطبق فقط على الأعمدة التي تحتوي على سلاسل. إذا لم يتم تعيين الحد الأقصى، فإنه يتم إرجاع فارغ.
DataSourceInfo.MaxValue الرقم الحد الأقصى للقيمة الرقمية التي يمكن أن يحتوي عمود عليها. ينطبق فقط على الأعمدة التي تحتوي على أرقام. إذا لم يتم تعيين الحد الأقصى، فإنه يتم إرجاع فارغ.
DataSourceInfo.MinValue الرقم الحد الأدنى للقيمة الرقمية التي يمكن أن يحتوي عمود عليها. ينطبق فقط على الأعمدة التي تحتوي على أرقام. إذا لم يتم تعيين الحد الأدنى، فإنه يتم إرجاع فارغ.
DataSourceInfo.Required منطقي هل القيمة مطلوبة لهذا العمود؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع خطأ.

والوسيطة الثالثة هي اسم العمود كسلسلة. على سبيل المثال، يتم تمرير عمود الهاتف في مجموعة الأشخاص كـ "هاتف"، بما في ذلك علامات الاقتباس المزدوجة.

معلومات مصدر البيانات

يمكنك أيضًا استخدام DataSourceInfo للحصول على معلومات حول مصدر البيانات ككل:

وسيطة المعلومات نوع النتيجة ‏‏الوصف
DataSourceInfo.AllowedValues منطقي ما أنواع الأذونات التي يمكن منحها للمستخدمين لمصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع فارغ.
DataSourceInfo.CreatePermission منطقي هل يمتلك المستخدم الحالي إذنًا لإنشاء سجلات في مصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع صواب.
DataSourceInfo.DeletePermission منطقي هل يمتلك المستخدم الحالي إذنًا لحذف سجلات في مصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع صواب.
DataSourceInfo.EditPermission منطقي هل يمتلك المستخدم الحالي إذنًا لتحرير سجلات في مصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع صواب.
DataSourceInfo.ReadPermission منطقي هل يمتلك المستخدم الحالي إذنًا لقراءة سجلات في مصدر البيانات هذا؟ في حالة عدم تعيين ذلك من قِبل مصدر البيانات، فإنه يتم إرجاع صواب.

‏‫ملاحظة‬

تقوم DataSourceInfo بإرجاع صواب إذا لم تتمكن من تحديد ما إذا كان المستخدم الحالي لديه الإذن المطلوب. سيتم التحقق من الأذونات مرة أخرى بواسطة الخادم عند بدء تشغيل العملية الفعلية وعرض خطأ إذا لم يكن مسموحا به. في هذا الوقت، التحقق من الأذونات باستخدام DataSourceInfo ممكن فقط عند استخدام Microsoft Dataverse.

بناء الجملة

DataSourceInfo( DataSource, Information,[ColumnName ‎] )

  • DataSource – مطلوب. مصدر البيانات المُراد استخدامه.
  • المعلومات – مطلوبة. نوع المعلومات التي تريد استردادها.
  • اسم العمود - اختياري. اسم العمود الذي سيتم استرداد المعلومات على مستوى العمود له. للحصول على معلومات حول مستوى مصدر البيانات، لا يمكن استخدام وسيطة اسم العمود.

‏‫ملاحظة

قبل Power Apps الإصدار 3.24042، كانت أسماء الأعمدة محددة بسلسلة نصية باستخدام علامات اقتباس مزدوجة، وإذا كانت مرتبطة مصدر البيانات فهي تحتاج أيضا إلى أسماء منطقية. على سبيل المثال، استخدم الاسم المنطقي "cr43e_name" مع علامات اقتباس مزدوجة بدلا من اسم العرض Name بدون عروض أسعار. بالنسبة SharePoint لمصادر بيانات Excel التي تحتوي على أسماء أعمدة ذات المسافات، يتم تحديد كل مسافة باستخدام "_x0020_" ، على سبيل المثال، "اسم العمود" Column_x0020_Name". بعد هذا الإصدار، يتم تحديث كافة التطبيقات تلقائيًا إلى الجملة الجديدة الموضحة في هذه المقالة.

الأمثلة

تستخدم الأمثله الموجودة في هذا القسم مصدر البيانات هذا المسمى IceCream:

مثال آيسكريم.

وفر مصدر البيانات أيضًا هذه المعلومات:

  • اسم عرض الكميةهو "الكمية المتاحة".
  • الحد الأقصى لطول الميزة هو 30 حرفًا.
  • يجب أن يحتوي عمود الميزة على قيمة. عمود الكمية غير مطلوب.
  • الحد الأدنى للكمية هو 0.
  • الحد الأقصى للكمية هو 100.
  • يستطيع المستخدم الحالي قراءة وتحرير سجلات مصدر بيانات IceCream ولكن لا يمكنه إنشاء السجلات أو حذفها.
صيغة ‏‏الوصف نتيجة
DataSourceInfo (IceCream، DataSourceInfo.DisplayName، الكمية) إرجاع اسم العرض لعمود الكمية لمصدر بيانات IceCream. "الكمية المتاحة"
DataSourceInfo (IceCream، DataSourceInfo.MaxLength، Flavor) إرجاع الحد الأقصى لطول سلسلة عمود الميزة في مصدر بيانات IceCream. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) هل عمود الميزة الخاص بمصدر بيانات IceCream مطلوب؟ true
DataSourceInfo (IceCream، DataSourceInfo.Required، الكمية) هل عمود الكمية الخاص بمصدر بيانات IceCream مطلوب؟ false
DataSourceInfo (IceCream، DataSourceInfo.MaxValue، الكمية) إرجاع الحد الأقصى للقيمة الرقمية لعمود الكمية الخاص بمصدر بيانات IceCream. 100
DataSourceInfo (IceCream، DataSourceInfo.MinValue، الكمية) إرجاع الحد الأدنى للقيمة الرقمية لعمود الكمية الخاص بمصدر بيانات IceCream. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) هل يستطيع المستخدم الحالي قراءة السجلات الموجودة في مصدر بيانات IceCream؟ true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) هل يستطيع المستخدم الحالي تحرير السجلات الموجودة في مصدر بيانات IceCream؟ true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) هل يستطيع المستخدم الحالي إنشاء السجلات الموجودة في مصدر بيانات IceCream؟ false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) هل يستطيع المستخدم الحالي حذف السجلات الموجودة في مصدر بيانات IceCream؟ false