دالة 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 |