عنصر التحكم

تعريف مساحة اسم المكون وإصداره ومعلومات العرض.

متوفر ل

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

المعلمات

Name	الوصف	نوع	مطلوبة	متوفر ل
namespace	تعريف النموذج الأولي للكائن للمكون	الأحرف أو الأرقام فقط	‏‏نعم‬	التطبيقات المستندة إلى النموذج واللوحة
constructor	أسلوب لتهيئة الكائن	الأحرف أو الأرقام فقط	‏‏نعم‬	التطبيقات المستندة إلى النموذج واللوحة
control-type	سواء كان عنصر التحكم هو عنصر تحكم قياسي أو عنصر تحكم React. تشير قيمة virtual إلى عنصر تحكم React باستخدام مكتبة React للنظام الأساسي. عناصر التحكم الظاهرية هي ميزة في المعاينة العامة. مزيد من المعلومات: عناصر تحكم React ومكتبات النظام الأساسي	standard|virtual	لا.	التطبيقات المستندة إلى النموذج واللوحة
description-key	تعريف وصف المكون المرئي في واجهة المستخدم.	string	لا.	التطبيقات المستندة إلى النموذج واللوحة
display-name-key	تعريف اسم عنصر التحكم المرئي في واجهة المستخدم.	string	‏‏نعم‬	التطبيقات المستندة إلى النموذج واللوحة
preview-image	الصورة المستخدمة على شاشات التخصيص لإظهار معاينة للمكون.	string	لا.	التطبيقات التي تستند إلى النموذج
version	تعريف إصدار المكون المحدد في الإصدار الدلالي	string	‏‏نعم‬	التطبيقات المستندة إلى النموذج واللوحة

العناصر الأصلية

العنصر

الوصف

أظهر

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

العناصر التابعة

العنصر	الوصف	تواجدات
مجموعة البيانات	تمثل عقدة مجموعة البيانات في بيان المكون تمثيلا محددا وقابلا للتكوين لمجموعة من سجلات الجدول.	0 أو أكثر
استخدام الخدمة الخارجية	يشير إلى ما إذا كان عنصر التحكم هذا يستخدم خدمة خارجية أم لا. إذا كان الأمر كذلك، فقم بتعيين علامة السمة الممكنة على أنها true وأضف مجال الخدمة الخارجية إلى الخاصية <domain> . عنصر التحكم الذي يستخدم أي خدمة خارجية هو عنصر تحكم متميز وسيحتاج المستخدم النهائي إلى ترخيص Power Apps لفتح تطبيق بعنصر تحكم متميز. مزيد من المعلومات: الترخيص	0 أو 1
مال	تحدد عقدة الخاصية جزءا محددا وقابلا للتكوين من البيانات التي يتوقعها المكون من Microsoft Dataverse.	0 أو أكثر
موارد	تشير عقدة الموارد في بيان المكون إلى ملفات الموارد التي يتطلبها المكون لتنفيذ تصوره.	1
مجموعة النوع	تحدد عقدة مجموعة النوع مجموعة من الأنواع التي تم تعريفها بواسطة اسم واحد. يمكن استخدام هذه المعلومات لتحديد أنواع البيانات التي تدعمها خاصية معينة.	0 أو أكثر
تبعيات الخصائص	تعريف مجموعة من تبعيات الخصائص.	0 أو أكثر
إجراء النظام الأساسي	يستخدم لتحديد تحميل تبعيات عنصر التحكم عند الطلب بدلا من تحميل عنصر التحكم.	0 أو 1

مثال

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

المقالات ذات الصلة

مرجع مخطط بيان إطار عمل مكون Power Apps
مرجع واجهة برمجة تطبيقات إطار عمل مكون Power Apps
نظرة عامة على إطار عمل مكون Power Apps