استخدم مدقق الحلول للتحقق من صحة تطبيقاتك التي تستند إلى نموذج في Power Apps
لتلبية متطلبات العمل المعقدة، بإمكان منشئي التطبيقات التي تستند إلى نموذج التوصل إلى حلول بالغة التقدم تقوم بتخصيص وتوسيع نطاق النظام الأساسي في Microsoft Dataverse. تأتي عمليات التنفيذ المتقدمة مصحوبة بمستويات متزايدة من المخاطرة حيث تظهر مشاكل الأداء والاستقرار والموثوقية، مما قد يؤثر سلبًا على تجربة المستخدم. قد يكون التعرف على طريقة حل هذه المشاكل وفهمها أمرًا معقدًا ويستغرق وقتًا طويلاً. باستخدام ميزة مدقق الحلول، يمكنك إجراء تدقيق تحليلي غني لحلولك في مقابل مجموعة من قواعد أفضل الممارسات وتحديد هذه الأنماط التي تنطوي على مشاكل بسرعة. بعد اكتمال عملية التدقيق، ستتلقى تقريرًا مفصلاً يسرد المشاكل التي تم التعرف عليها، والمكونات والأكواد المتأثرة بالإضافة إلى ارتباطات إلى وثائق توضح كيفية حل كل مشكلة.
هام
بدء من مارس 2022، لن يقوم مدقق الحلول بتحليل الوظائف الإضافية في الحلول. يجري تحديث عمليات التحقق من صحة المكون الإضافي وسوف تركز في النهاية على وقت تأليف المكون الإضافي الأصلي، والذي سيساعدك في الكشف عن المشكلات وإصلاحها مبكراً.
يقوم مدقق الحلول بتحليل مكونات الحل هذه:
- المكونات الإضافية في Dataverse
- أنشطة سير العمل المخصصة في Dataverse
- موارد الويب في Dataverse (HTML وJavaScript)
- تتكوينات Dataverse، مثل خطوات رسالة SDK
يعمل مدقق الحلول مع الحلول غير المدارة التي يمكن تصديرها من بيئة،
ملاحظة
- يشرح هذا الموضوع كيفية تشغيل مدقق الحلول من مدخل منشئ Power Apps. كما تتوفر أيضًا وحدة PowerShell يمكنك استخدامها للتفاعل مباشرة مع الخدمة. يمكن استخدام وحدة Microsoft.PowerApps.Checker.PowerShell لتحليل الحلول المدارة وغير المدارة للإصدارات المدعومة من البيئات المحلية والبيئات عبر الإنترنت عبر الإنترنت، أو لأتمتة الخدمة ودمجها في البنية وإصدار تدفقات. مزيد من المعلومات: نظرة عامة على Microsoft.PowerApps.Checker.PowerShell
- يدعم مدقق الحلول المتغيرات العمومية لبناء الجملة ECMAScript 2015 (ES6) وما يصل إلى ECMAScript 2018 (ES9). عندما يتم الكشف عن JavaScript باستخدام متغيرات عامة بعد ES6 أو بناء الجملة بعد ES9، يتم الإبلاغ عن مشكلة بناء جملة غير مدعومة على الويب لمورد الويب.
- لا يضمن استخدام مدقق الحلول نجاح استيراد الحل. اختبارات التحليل الثابت التي يتم تنفيذها مقابل الحل لا تعرف الحالة المكونة لبيئة الوجهة، وقد يتوقف نجاح الاستيراد على حلول أو تكوينات أخرى في البيئة.
تشغيل مدقق الحلول
قم بتسجيل الدخول إلى Power Apps.
من الجزء الأيمن، حدد الحلول.
إلى جانب الحل غير المدار الذي تريد تحليله، حدد ...، ثم أشر إلى مدقق الحلول، ثم حدد تشغيل.
في الجزء العلوي الأيسر من صفحة الحلول، يعرض جزء الحالة مدقق الحل قيد التشغيل.
لاحظ ما يلي:
قد يحتاج مدقق الحلول إلى دقائق قليلة لإكمال التحليل.
خلال هذا الوقت، ستلاحظ الحالة جارٍ تشغيل... مع عمود تدقيق في الحل في قائمة الحلول.
ستتلقى إعلامًا بالبريد إلكتروني وإعلامًا في ناحية الإعلامات في موقع Power Apps عند اكتمال عملية التدقيق.
اعرض التقرير عند إتمام عملية التدقيق.
إلغاء عملية تدقيق
بعد أن ترسل عملية تدقيق الحلول في بيئتك، يمكن إلغاء عملية التدقيق من خلال جزء الحالة في الجزء العلوي الأيسر من صفحة الحلول.
عندما تلغي عملية التدقيق، يتوقف تشغيل تدقيق الحل وتعود حالة تدقيق الحل إلى الحالة السابقة.
حالات مدقق الحلول
عندما تقوم بتثبيت مدقق الحلول في بيئتك، يصبح العمود تدقيق في الحل متوفرًا في قائمة الحلول. يعرض هذا العمود حالات تحليل الحل لأحد الحلول.
| المحافظة | الوصف |
|---|---|
| لم يتم تشغيله | لم يتم تحليل الحل إطلاقًا. |
| قيد التشغيل | يتم الآن تحليل الحل. |
| تعذر إكماله | تم طلب تحليل الحل ولكن لم يتم إكمال التحليل بنجاح. |
| النتائج اعتبارًا من التاريخ والوقت | تم إكمال تحليل الحل والنتائج متوفرة للتنزيل. |
| تعذر إكماله. النتيجة اعتبارًا من التاريخ والوقت | لم يتم إكمال طلب التحليل الأخير بنجاح. يمكن تنزيل النتائج الناجحة الأخيرة. |
| تم التدقيق بواسطة Microsoft | هذا حل مُدار من Microsoft. غير مسموح بتحليل الحل على هذه الحلول. |
| تم التدقيق بواسطة الناشر | هذا حل مُدار تابع لجهة خارجية. في الوقت الحالي، لا يتوفر تحليل الحل لهذه الحلول. |
مراجعة التقرير مدقق الحلول
عند اكتمال عملية تدقيق الحل، يمكنك عرض تقرير التحليل في المدخل أو يمكنك تنزيل التقرير من مستعرض الويب الخاص بك. توجد لديك في المدخل خيارات لعامل التصفية وتجميع النتائج حسب المشكلة أو الموقع أو الخطورة وعرض المعلومات التفصيلية حول المشكلات التي تم اكتشافها في الحل الخاص بك.
من الجزء الأيمن، حدد الحلول.
وبجانب الحل غير المُدار حيث تريد عرض تقرير مدقق الحلول، حدد ...، ثم أشر إلى مدقق الحلول، ثم حدد عرض النتائج.
حدد مشكلة لعرض التفاصيل والإرشادات حول كيفية حلها.
تتوفر نتائج تدقيق الحل أيضًا للتنزيل. يتم تنزيل ملف مدقق الحلول المضغوط إلى المجلد المحدد في مستعرض الويب الخاص بك. يكون تقرير التنزيل بالتنسيق Excel ويحتوي على العديد من الرسوم المرئية والأعمدة التي تساعدك في تحديد تأثير كل مشكلة تم اكتشافها في الحل ونوعها وموقعها. يتم أيضًا توفير ارتباط يؤدي إلى إرشادات تفصيلية حول كيفية حل المشكلة.
- من الجزء الأيمن، حدد الحلول.
- وبجانب الحل غير المُدار حيث تريد تنزيل تقرير مدقق الحلول، حدد ...، ثم أشر إلى مدقق الحلول، ثم حدد تنزيل النتائج.
- يتم تنزيل الملف المضغوط لمدقق الحلول المجلد المحدد بواسطة مستعرض الويب.
فيما يلي ملخص عن كل عمود في التقرير.
| عمود التقرير | الوصف | ينطبق على المكونات |
|---|---|---|
| المشكلة | عنوان المشكلة التي تم التعرف عليها في الحل. | الكل |
| الفئة | تصنيف المشكلة التي تم التعرف عليها، مثل الأداء أو الاستخدام أو قابلية الدعم. | الكل |
| الأهمية | يمثل التأثير المحتمل للمشكلة التي تم التعرف عليها. أنواع التأثيرات المتوفرة هي مرتفع، متوسط، منخفض، إخباري. | الكل |
| الإرشادات | ارتباط إلى مقالة تقدم شرحًا مفصلاً للمشكلة والتأثير والإجراءات الموصى بها. | الكل |
| المكون | مكون الحل حيث تم التعرف على المشكلة. | الكل |
| Location | موقع و/أو الملف المصدر للمكون حيث حدثا المشكلة التي تم التعرف عليها، مثل اسم ملف التجميع أو JavaScript. | الكل |
| رقم السطر | مرجع رقم السطر للمشكلة في مكون مورد ويب المتأثر. | موارد ويب |
| وحدة نمطية | اسم الوحدة النمطية حيث تم اكتشاف المشكلة التي تم التعرف عليها في التجميع. | مكون إضافي أو نشاط سير عمل مخصص |
| النوع | نوع المشكلة التي تم التعرف عليها في التجميع. | مكون إضافي أو نشاط سير عمل مخصص |
| العضو | عضو المشكلة التي تم التعرف عليها في التجميع. | مكون إضافي أو نشاط سير عمل مخصص |
| البيان | تكوين أو بيان الكود الذي أدى إلى حدوث المشكلة. | الكل |
| التعليقات | تفاصيل حول المشكلة تتضمن خطوات حل عالٍ المستوى. | الكل |
قواعد أفضل الممارسات التي يستخدمها مدقق الحلول
| مكون الحل | اسم القاعدة | وصف القاعدة |
|---|---|---|
| مكون إضافي أو نشاط سير عمل | il-specify-column | تجنب تحديد جميع الأعمدة عبر واجهات برمجة تطبيقات استعلام Dataverse. |
| مكون إضافي أو نشاط سير عمل | meta-remove-dup-reg | تجنب تكرار تسجيلات المكونات الإضافية لـ Dataverse. |
| مكون إضافي أو نشاط سير عمل | il-turn-off-keepalive | عيّن KeepAlive إلى false عند التفاعل مع أجهزة مضيف خارجية في المكون الإضافي في Dataverse. |
| مكون إضافي أو نشاط سير عمل | il-avoid-unpub-metadata | تجنب استرداد بيانات تعريف Dataverse غير المنشورة. |
| مكون إضافي أو نشاط سير عمل | il-avoid-batch-plugin | تجنب استخدام أنواع الطلبات الدفعية في المكونات الإضافية في Dataverse وأنشطة سير العمل. |
| مكون إضافي أو نشاط سير عمل | meta-avoid-reg-no-attribute | قم بتضمين سمات التصفية مع تسجيلات المكونات الإضافية في Dataverse. |
| مكون إضافي أو نشاط سير عمل | meta-avoid-reg-retrieve | يجب توخي الحذر عند استخدام المكونات الإضافية في Dataverse المسجلة لرسائل Retrieve وRetrieveMultiple. |
| مكون إضافي أو نشاط سير عمل | meta-remove-inactive | قم بإزالة التكوينات غير النشطة في Dataverse. |
| مكون إضافي أو نشاط سير عمل | il-meta-avoid-crm2011-depr-message | لا تستخدم رسائل Microsoft Dynamics CRM 2011المهملة. |
| مكون إضافي أو نشاط سير عمل | meta-avoid-crm4-event | لا تستخدم مرحلة تسجيل المكون الإضافي في Microsoft Dynamics CRM 4.0. |
| مكون إضافي أو نشاط سير عمل | il-avoid-specialized-update-ops | لا تستخدم طلبات عمليات التحديث المتخصصة في Dataverse. |
| مكون إضافي أو نشاط سير عمل | il-use-autonumber-feature | استخدم ميزة الترقيم التلقائي بدلاً من حل الترقيم التلقائي المخصص. |
| مكون إضافي أو نشاط سير عمل | il-avoid-parallel-plugin | يجب تجنب استخدام النقوش المتوازية ضمن المكونات الاضافية. |
| مكون إضافي أو نشاط سير عمل | il-avoid-lock-plugin | تجنب تأمين الأعضاء الثابتين في المكونات الاضافية. |
| مكون إضافي أو نشاط سير عمل | meta-avoid-retrievemultiple-annotation | تجنب تسجيل مكون إضافي علي RetrieveMultiple في التعليق التوضيحي. |
| موارد ويب | web-use-async | التفاعل مع موارد HTTP و HTTPS بشكل غير متزامن. |
| موارد ويب | web-avoid-modals | تجنب استخدام مربعات الحوار المشروطة. |
| موارد ويب | web-avoid-crm2011-service-odata | لا تستهدف نقطة نهاية Microsoft Dynamics CRM 2011 OData 2.0. |
| موارد ويب | web-avoid-crm2011-service-soap | لا تستهدف خدمات Microsoft Dynamics CRM 2011 SOAP. |
| موارد ويب | web-avoid-browser-specific-api | لا تستخدم واجهات برمجة التطبيقات القديمة أو المكونات الإضافية للمستعرض في Internet Explorer. |
| موارد ويب | web-avoid-2011-api | لا تستخدم نموذج كائن Microsoft Dynamics CRM 2011 المهمل. |
| موارد ويب | web-use-relative-uri | لا تستخدم عناوين URL لنقاط نهاية Dataverse المطلقة. |
| موارد ويب | web-use-client-context | استخدم سياقات العميل. |
| موارد ويب | web-use-navigation-api | استخدم معلمات API للتنقل. |
| موارد ويب | web-use-org-setting | استخدم إعدادات المؤسسة. |
| موارد ويب | web-use-grid-api | استخدم واجهات برمجة تطبيقات الشبكة. |
| موارد ويب | web-avoid-isActivityType | استبدل الأسلوب Xrm.Utility.isActivityType ببيانات تعريف Xrm.Utility.gettableMetadata الجديدة ولا تستخدم قواعد الشريط. |
| موارد ويب | meta-avoid-silverlight | تم إهمال استخدام مورد ويب Silverlight. |
| موارد ويب | web-remove-debug-script | تجنب تضمين برنامج التصحيح النصي في بيئات غير التطوير. |
| موارد ويب | web-use-strict-mode | استخدم وضع التقييد عندما يكون ذلك ممكنًا. |
| موارد ويب | web-use-strict-equality-operators | استخدم عوامل مساواة صارمة. |
| موارد ويب | web-avoid-eval | لا تستخدم دالة "التقييم" أو معادلاتها الوظيفية. |
| موارد ويب | web-remove-alert | لا تستخدم وظيفة "alert" أو معادلاتها الوظيفية. |
| موارد ويب | web-remove-console | تجنب استخدام الأساليب على وحدة التحكم. |
| موارد ويب | web-avoid-ui-refreshribbon | تجنب استخدام refreshRibbon في النموذج onload وEnableRule. |
| تطبيق اللوحة | app-formula-issues-high | راجع مراجع الصيغ في Power Apps للحصول على مزيد من التفاصيل. |
| تطبيق اللوحة | app-formula-issues-medium | راجع مراجع الصيغ في Power Apps للحصول على مزيد من التفاصيل. |
| تطبيق اللوحة | app-formula-issues-low | راجع مراجع الصيغ في Power Apps للحصول على مزيد من التفاصيل. |
| تطبيق اللوحة | app-use-delayoutput-text-input | استخدم التحميل المؤجل في بعض السيناريوهات لتحسين الأداء. |
| تطبيق اللوحة | app-reduce-screen-controls | حدد عدد عناصر تحكم التطبيق للحصول على أداء محسن. |
| تطبيق اللوحة | app-include-accessible-label | استخدم التسميات الصريحة لتحسين إمكانية الوصول للتطبيق. |
| تطبيق اللوحة | app-include-alternative-input | تأكد من أن كل العناصر التفاعلية يمكن الوصول اليها من الإدخالات البديلة. |
| تطبيق اللوحة | app-avoid-autostart | تجنب استخدام التشغيل التلقائي على المشغلات داخل تطبيق. |
راجع أيضًا
أفضل الممارسات والإرشادات لـ Dataverse
أفضل الممارسات والإرشادات للتطبيقات التي تستند إلى نموذج
المشاكل الشائعة والحلول من مدقق الحلول
ملاحظة
هل يمكنك إخبارنا عن تفضيلات لغة التوثيق الخاصة بك؟ شارك في استطلاع قصير. (يرجى ملاحظة أن هذا الاستطلاع باللغة الإنجليزية)
سيستغرق الاستطلاع حوالي سبع دقائق. لا يتم جمع أي بيانات شخصية (بيان الخصوصية).
الملاحظات
إرسال الملاحظات وعرضها المتعلقة بـ