الدالتان AsType وIsType

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

يقوم بالتحقق من مرجع سجل لنوع جدول محدد (IsType) وتعامل المرجع على أنه نوع محدد (AsType).

‏‫ملاحظة

لا تدعم أوامر PAC CLI pac power-fx IsType.

الوصف

أقرا فهم مراجع السجلات وعمليات البحث متعددة الاشكال للحصول على مقدمة أوسع ومزيد من التفاصيل.

يشير حقل البحث عادة إلى سجلات في جدول معين. نظرا لأن نوع الجدول منشأ بشكل جيد، يمكنك الوصول إلى حقول البحث باستخدام نقطة بسيطة. على سبيل المثال، First( Accounts ).'Primary Contact'.'Full Name' ينتقل من جدول الحسابات إلى سجل جهة الاتصال الرئيسية في جدول جهات الاتصال ويستخرج حقل الاسم الكامل.

كما يدعم Microsoft Dataverse حقول البحث التي قد تشير إلى سجلات من مجموعة من الجداول، كما في هذه الأمثلة.

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

في صيغ تطبيق اللوحة، استخدم مراجع السجلات للعمل مع عمليات البحث متعددة الأشكال. ونظرا لأن مرجع سجل يمكن أن يشير إلى جداول مختلفة، فلا يمكنك معرفة الحقول التي ستتوفر عند كتابة صيغة. لا تتوفر علامة Record.Field يجب أن تلائم هذه الصيغ السجلات التي يواجهها التطبيق عند تشغيلها.

تتحقق وظيفة IsType مما إذا كان مرجع سجل يشير إلى نوع جدول محدد أم لا. ترجع الدالة قيمة منطقية أو خاطئة.

تتعامل وظيفة AsType مع مرجع سجل كنوع جدول محدد ، ويشار إليه أحيانًا باسم التسجيل. يمكنك استخدام النتيجة كما لو كانت سجلا في الجدول ثم استخدام تعليق Record.Field مرة أخرى للوصول إلى جميع حقول ذلك السجل. يحدث خطأ إذا لم يكن المرجع من النوع المحدد.

استخدم هذه الوظائف معا لاختبار نوع الجدول الأول للسجل ثم التعامل مع هذا السجل كسجل من هذا النوع حتى تكون الحقول متاحة:

If( IsType( First( Accounts ).Owner, Users ),
    AsType( First( Accounts ).Owner, Users ).'Full Name',
    AsType( First( Accounts ).Owner, Teams ).'Team Name'
)

تحتاج إلى هذه الوظائف فقط إذا كنت تقوم بالوصول إلى حقول مرجع سجل. علي سبيل المثال، يمكنك استخدام مراجع السجلات في دالة Filterدون IsType أو AsType:

Filter( Accounts, Owner = First( Users ) )

بالمثل، يمكنك استخدام مراجع السجلات مع دالة Patch:

Patch( Accounts, First( Accounts ), { Owner: First( Teams ) } )

إذا تم استخدامه في سياق سجل ، مثل داخل عنصر تحكم Gallery أو Edit form، فقد تحتاج إلى استخدام عامل إزالة الغموض العمومي للرجوع إلى نوع الجدول. علي سبيل المثال، قد تكون هذه الصيغة فعالة لمعرض يقوم بعرض قائمة بجهات الاتصال حيث اسم الشركةهو بحث العميل:

If( IsType( ThisItem.'Company Name', Accounts ),
    AsType( ThisItem.'Company Name', Accounts ).'Account Name',
    AsType( ThisItem.'Company Name', Contacts ).'Full Name'
)

وبالنسبة لكلا الوظائف، يمكنك تحديد النوع من خلال اسم مصدر البيانات المتصل الجدول. ولكي تعمل الصيغة، يجب عليك أيضا إضافة مصدر البيانات إلى التطبيق لأي أنواع تريد اختبارها أو تحويلها. على سبيل المثال، يجب إضافة جدول المستخدمين كمصدر بيانات إذا أردت استخدام IsType وAsType مع سجلات وبحث المالك من هذا الجدول. يمكنك إضافة مصادر البيانات التي تستخدمها بالفعل فقط في تطبيقك؛ لست بحاجة إلى إضافة جميع الجداول التي يمكن أن يشير البحث إليها.

إذا كان مرجع السجل blank، ستقوم IsType بإرجاع FALSE، وستقوم AsTypeبإرجاع blank. ستكون كافة حقول blank بالقيمة blank.

بناء الجملة

AsType ( مرجع السجل ، نوع الجدول )

• مرجع السجل- مطلوب. مرجع سجل، وغالبا ما يكون حقل البحث الذي يمكن أن يشير إلى سجل في أي من الجداول المتعددة.
• نوع الجدول- مطلوب. الجدول المحدد الذي يجب أن يتم التسجيل فيه عنونة.

IsType ( مرجع السجل ، نوع الجدول )

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

مثال

فهم مراجع السجلات وعمليات البحث متعددة الأشكال يحتوي على أمثلة شاملة.

1. قم بإنشاء تطبيق لوحة فارغ للأجهزة اللوحية.

2. في الجزء الأيسر، حدد البيانات>إضافة البيانات. وبعد ذلك، أضف جداول الحسابات وجهات الاتصال.

   

3. في الجزء الأيسر، حدد + (إدراج) >تخطيط‏‎>معرض عمودي فارغ.

   

4. حدد الاتصال بالبيانات، ثم حدد جهات الاتصال كمصدر البيانات.

5. قم بتعيين تخطيط المعرض على العنوان والعناوين الفرعية.

   

   

6. في جزء البيانات، افتح القائمة عنوان1، ثم حدد الاسم بالكامل.

   

7. حدد عنصر تحكم تسمية عنوان فرعي1.

   

8. تعيين خاصية Text لـ عنوان فرعي1 لهذه الصيغة:

   If( IsBlank( ThisItem.'Company Name' ), "--",
       IsType( ThisItem.'Company Name', Accounts ),
           "Account: " & AsType( ThisItem.'Company Name', Accounts ).'Account Name',
       "Contact: " & AsType( ThisItem.'Company Name', Contacts ).'Full Name'
   )
   

   

   يعرض العنوان الفرعي في المعرض هذه القيم:

   • "--" إذا كان 'Company Name' بالقيمة blank.
   • "الحساب:" ثم حقل اسم الحساب من جدول الحسابات إذا كان حقل اسم الشركة يشير إلى حساب.
   • "جهة الاتصال:" ثم حقل الاسم الكامل من جدول جهات الاتصال إذا كان حقل اسم الشركة يشير إلى جهة اتصال.

   قد تختلف النتائج عن تلك الموجودة في هذا الموضوع لأنها تستخدم بيانات نموذجية تم تعديلها لعرض أنواع إضافية من النتائج.