مشاركة عبر

دالة RecordInfo

  • مقالة

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

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

استخدم RecordInfo للحصول على معلومات حول سجل محدد من مصدر البيانات. يجب أن يكون مصدر البيانات جدوليًا ومتوافقًا مع وظيفتي Remove وPatch.

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

المعلومات المتوفرة:

وسيطة المعلومات الوصف
RecordInfo.DeletePermission هل المستخدم الحالي لديه إذن لإزالة هذا السجل من مصدر البيانات؟
RecordInfo.EditPermission هل المستخدم الحالي لديه إذن لتعديل هذا السجل في مصدر البيانات؟
RecordInfo.ReadPermission هل المستخدم الحالي لديه إذن لقراءة هذا السجل من مصدر البيانات؟

RecordInfo يُرجع قيمة منطقية:

قيمة الإرجاع الوصف
true يمتلك المستخدم الإذن.
true لا يمتلك المستخدم الإذن. إذا كان السجل فارغًا فسيُرجع RecordInfo أيضًا خطأ.

RecordInfo يضع في الاعتبار الأذونات على مستوى مصدر البيانات أيضًا. على سبيل المثال، إذا كان لدى المستخدم إذن على مستوى السجل لتعديل السجل، ولكن المستخدم ليس لديه أذونات على مستوى الجدول، فسيرجع خطأ لـ ModifyPermission. استخدم وظيفة DataSourceInfo للحصول على معلومات حول مصدر البيانات ككل.

بناء الجملة

RecordInfo( تسجيل، المعلومات )

  • السجل – مطلوب. السجل المراد اختباره.
  • المعلومات – مطلوبة. المعلومات المطلوبة للسجل.

الأمثلة

RecordInfo( First(Accounts), RecordInfo.EditPermission )

التحقق من إذن التحرير للسجل الأول في مصدر بيانات Accounts، الذي قد يكون موجودًا في Dataverse، أو SharePoint، أو SQL Server، أو مصدر بيانات جدولي آخر. إذا كان لدى المستخدم إذن بتحرير هذا السجل وتعديل مصدر بيانات Accounts بشكل عام، فسيقوم RecordInfo بإرجاع صواب.

With( { MyRecord: First( Accounts ) },
      RecordInfo( MyRecord, RecordInfo.EditPermission ) )

التقاط سجل باستخدام وظيفة With، ثم الضغط على هذه القيمة لوظيفة RecordInfo. ستكون النتيجة مماثلة للمثال الأخير.

Collect( MyAccounts, FirstN( Accounts, 10 ) );
RecordInfo( First( MyAccounts ), RecordInfo.EditPermission ) )

التقاط أول 10 سجلات من مصدر بيانات Accounts في مجموعة MyAccounts. نظرًا لأن السجلات نشأت من مصدر بيانات، فيمكن استخدامها مع وظيفة RecordInfo. ستكون النتيجة مماثلة للمثال الأخير.

Collect( MyCollection, [ 1, 2, 3 ] );
RecordInfo( First(MyCollection), RecordInfo.DeletePermission )

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