استخدم مدقق الحلول للتحقق من صحة الحلول الخاصة بك
لتقديم متطلبات الأعمال المعقدة، غالبًا ما ينتهي الأمر بالصناع بحلول متقدمة للغاية تقوم بتخصيص وتوسيع نطاق منصة Microsoft Dataverse . تأتي عمليات التنفيذ المتقدمة مصحوبة بمستويات متزايدة من المخاطرة حيث تظهر مشاكل الأداء والاستقرار والموثوقية، مما قد يؤثر سلبًا على تجربة المستخدم. قد يكون التعرف على طريقة حل هذه المشاكل وفهمها أمرًا معقدًا ويستغرق وقتًا طويلاً. باستخدام ميزة مدقق الحلول، يمكنك إجراء تدقيق تحليلي غني لحلولك في مقابل مجموعة من قواعد أفضل الممارسات وتحديد هذه الأنماط التي تنطوي على مشاكل بسرعة. بعد اكتمال عملية التدقيق، ستتلقى تقريرًا مفصلاً يسرد المشاكل التي تم التعرف عليها، والمكونات والأكواد المتأثرة بالإضافة إلى ارتباطات إلى وثائق توضح كيفية حل كل مشكلة.
يقوم مدقق الحلول بتحليل مكونات الحل هذه:
- أنشطة سير العمل المخصصة في Dataverse
- موارد الويب في Dataverse (HTML وJavaScript)
- تتكوينات Dataverse مثل خطوات رسالة SDK
- Power Automate التدفق (بواسطة مدقق التدفق)
- Power Fx التعبيرات (عبر مدقق التطبيق)
يعمل مدقق الحلول مع الحلول غير المدارة التي يمكن تصديرها من بيئة،
ملاحظة
- يشرح هذا الموضوع كيفية تشغيل مدقق الحلول من مدخل منشئ Power Apps. كما تتوفر أيضًا وحدة PowerShell يمكنك استخدامها للتفاعل مباشرة مع الخدمة. يمكن استخدام وحدة.PowerApps.Checker.PowerShell لتحليل الحلول غير المُدارة لبيئات Power Apps أو لأتمتة الخدمة ودمجها في خطوط أنابيب الإنشاء والإصدار. مزيد من المعلومات: نظرة عامة على Microsoft.PowerApps.Checker.PowerShell
- يدعم مدقق الحلول المتغيرات العمومية لبناء الجملة ECMAScript 2015 (ES6) وما يصل إلى ECMAScript 2018 (ES9). عندما يتم الكشف عن JavaScript باستخدام متغيرات عامة بعد ES6 أو بناء الجملة بعد ES9، يتم الإبلاغ عن مشكلة بناء جملة غير مدعومة على الويب لمورد الويب.
- لا يضمن استخدام مدقق الحلول نجاح استيراد الحل. اختبارات التحليل الثابت التي يتم تنفيذها مقابل الحل لا تعرف الحالة المكونة لبيئة الوجهة، وقد يتوقف نجاح الاستيراد على حلول أو تكوينات أخرى في البيئة.
تشغيل مدقق الحلول
قم بتسجيل الدخول إلى Power Apps.
من الجزء الأيمن، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
إلى جانب الحل غير المدار الذي تريد تحليله، حدد ...، ثم أشر إلى مدقق الحلول، ثم حدد تشغيل.
مدقق الحل يحتوي زر الأمر على مؤشر تحميل، وستلاحظ وجود تشغيل… مع عمود تدقيق في الحل في قائمة الحلول.
لاحظ ما يلي:
قد يحتاج مدقق الحلول إلى دقائق قليلة لإكمال التحليل.
ستتلقى إعلامًا بالبريد إلكتروني وإعلامًا في ناحية الإعلامات في موقع Power Apps عند اكتمال عملية التدقيق.
اعرض التقرير عند إتمام عملية التدقيق.
إلغاء عملية تدقيق
بعد أن ترسل عملية تدقيق الحلول في بيئتك، يمكن إلغاء عملية التدقيق من خلال جزء الحالة في الجزء العلوي الأيسر من صفحة الحلول.
عندما تلغي عملية التدقيق، يتوقف تشغيل تدقيق الحل وتعود حالة تدقيق الحل إلى الحالة السابقة.
حالات مدقق الحلول
عندما تقوم بتثبيت مدقق الحلول في بيئتك، يصبح العمود تدقيق في الحل متوفرًا في قائمة الحلول. يعرض هذا العمود حالات تحليل الحل لأحد الحلول.
| المحافظة | الوصف |
|---|---|
| لم يتم تشغيله | لم يتم تحليل الحل إطلاقًا. |
| قيد التشغيل | يتم الآن تحليل الحل. |
| تعذر إكماله | تم طلب تحليل الحل ولكن لم يكتمل التحليل بنجاح. |
| النتائج اعتبارًا من التاريخ والوقت | تم إكمال تحليل الحل والنتائج متوفرة للتنزيل. |
| تعذر إكماله. النتيجة اعتبارًا من التاريخ والوقت | لم يكتمل طلب التحليل الأخير بنجاح. يمكن تنزيل النتائج الناجحة الأخيرة. |
| تم التدقيق بواسطة Microsoft | هذا حل مُدار من Microsoft. لا يُسمح بتحليل الحل في هذه الحلول. |
| تم التدقيق بواسطة الناشر | هذا حل مُدار تابع لجهة خارجية. حاليًا، لا يتوفر تحليل الحلول لهذه الحلول. |
مراجعة التقرير مدقق الحلول
عند اكتمال عملية تدقيق الحل، يمكنك عرض تقرير التحليل في المدخل أو يمكنك تنزيل التقرير من مستعرض الويب الخاص بك. في البوابة، لديك خيارات لفرز النتائج حسب المشكلة أو الموقع أو الخطورة وعرض المعلومات التفصيلية حول المشكلات التي تم اكتشافها في الحل الخاص بك.
من الجزء الأيمن، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
وبجانب الحل غير المُدار حيث تريد عرض تقرير مدقق الحلول، حدد ...، ثم أشر إلى مدقق الحلول، ثم حدد عرض النتائج.
حدد مشكلة لعرض التفاصيل والإرشادات حول كيفية حلها.
تتوفر نتائج تدقيق الحل أيضًا للتنزيل. يتم تنزيل الملف المضغوط لمدقق الحلول المجلد المحدد بواسطة مستعرض الويب. تقرير التنزيل بتنسيق Excel ويحتوي على عدد كبير من الرسومات المرئية والأعمدة التي تساعدك في التعرف على تأثير ونوع وموقع كل مشكلة تم الكشف عنها في الحقل. يتم أيضًا توفير ارتباط يؤدي إلى إرشادات تفصيلية حول كيفية حل المشكلة.
- من الجزء الأيمن، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
- وبجانب الحل غير المُدار حيث تريد تنزيل تقرير مدقق الحلول، حدد ...، ثم أشر إلى مدقق الحلول، ثم حدد تنزيل النتائج.
- يتم تنزيل الملف المضغوط لمدقق الحلول المجلد المحدد بواسطة مستعرض الويب.
فيما يلي ملخص عن كل عمود في التقرير.
| عمود التقرير | الوصف | ينطبق على المكونات |
|---|---|---|
| المشكلة | عنوان المشكلة التي تم التعرف عليها في الحل. | الكل |
| الفئة | تصنيف المشكلة المحددة، مثل الأداء، الاحتفاظ، الاستخدام، الدعم، التصميم، الأمان, قابلية الوصول، أو جاهزية الترقية. | الكل |
| خطورة | يمثل التأثير المحتمل للمشكلة التي تم التعرف عليها. أنواع التأثيرات المتوفرة هي شديد الأهمية، مرتفع، متوسط، منخفضو، إخباري. | الكل |
| التوجيه | ارتباط إلى مقالة تقدم شرحًا مفصلاً للمشكلة والتأثير والإجراءات الموصى بها. | الكل |
| المكون | مكون الحل حيث تم التعرف على المشكلة. | الكل |
| Location | موقع و/أو الملف المصدر للمكون حيث حدثا المشكلة التي تم التعرف عليها، مثل اسم ملف التجميع أو JavaScript. | الكل |
| رقم السطر | مرجع رقم السطر للمشكلة في مكون مورد ويب المتأثر. | موارد ويب |
| وحدة نمطية | اسم الوحدة النمطية حيث تم اكتشاف المشكلة التي تم التعرف عليها في التجميع. | نشاط سير العمل المخصص |
| نوع | نوع المشكلة التي تم التعرف عليها في التجميع. | نشاط سير العمل المخصص |
| العضو | عضو المشكلة التي تم التعرف عليها في التجميع. | نشاط سير العمل المخصص |
| البيان | تكوين أو بيان الكود الذي أدى إلى حدوث المشكلة. | الكل |
| التعليقات | تفاصيل حول المشكلة تتضمن خطوات حل عالٍ المستوى. | الكل |
تشغيل قواعد مدقق الحلول محليًا
يمكنك تشغيل قواعد مدقق الحلول في بيئة التطوير لاكتشاف المشاكل قبل حدوثها عندما تقوم بإنشاء موارد الحلول. هذه الميزة مدعومة حاليًا لموارد الويب (JavaScript وTypeScript). لمزيد من التفاصيل، انتقل إلى حزمة NPM @microsoft/eslint-plugin-power-apps.
قواعد أفضل الممارسات التي يستخدمها مدقق الحلول
يسرد الجدول التالي نوع المكون ووصف القاعدة والخطورة والفئة. يتم حظر الانتهاكات الخطيرة أو تحذيرها عند تكوينها لتطبيق مدقق الحلول مع البيئات المُدارة. مزيد من المعلومات: استخدام مدقق الحلول في البيئات المدارة
| مكون الحل | اسم القاعدة | وصف القاعدة | خطورة | فئة |
|---|---|---|---|---|
| مكون إضافي أو نشاط سير عمل | meta-remove-dup-reg | تجنب تكرار تسجيلات المكونات الإضافية لـ Dataverse. | هام | الأداء |
| مكون إضافي أو نشاط سير عمل | meta-avoid-reg-no-attribute | قم بتضمين سمات التصفية مع تسجيلات المكونات الإضافية في Dataverse. | متوسط | الأداء |
| مكون إضافي أو نشاط سير عمل | meta-avoid-reg-retrieve | يجب توخي الحذر عند استخدام المكونات الإضافية في Dataverse المسجلة لرسائل Retrieve وRetrieveMultiple. | متوسط | الأداء |
| مكون إضافي أو نشاط سير عمل | meta-remove-inactive | قم بإزالة التكوينات غير النشطة في Dataverse. | منخفض | الصيانة |
| مكون إضافي أو نشاط سير عمل | meta-avoid-crm4-event | لا تستخدم مرحلة تسجيل المكون الإضافي في Microsoft Dynamics CRM 4.0. | متوسط | الاستعداد للترقية |
| مكون إضافي أو نشاط سير عمل | meta-avoid-retrievemultiple-annotation | تجنب تسجيل مكون إضافي علي RetrieveMultiple في التعليق التوضيحي. | عالي | الاستخدام |
| مكون إضافي أو نشاط سير عمل | meta-license-sales-sdkmessages | يحتوي الحل على رسائل وعمليات SDK التي تتطلب ترخيص Dynamics 365 صالحًا. | منخفض | الترخيص |
| تطبيق يستند إلى النموذج | meta-license-sales-customcontrols | يحتوي الحل على عناصر تحكم مخصصة تتطلب ترخيص Dynamics 365 Sales صالحًا. | منخفض | الترخيص |
| تطبيق يستند إلى النموذج | meta-license-sales-entity-operations | يحتوي الحل على كيانات ذات رسائل SDK وعمليات مقيدة تتطلب ترخيص Dynamics 365 صالحًا. | منخفض | الترخيص |
| موارد الويب | استخدام غير متزامن | التفاعل مع موارد HTTP و HTTPS بشكل غير متزامن. | هام | الأداء |
| موارد الويب | تجنب الوسائط | تجنب استخدام مربعات الحوار المشروطة. | عالي | إمكانية الدعم |
| موارد الويب | avoid-dom-form | عالي | إمكانية الدعم | |
| موارد الويب | تجنب دوم شكل الحدث | عالي | إمكانية الدعم | |
| موارد الويب | تجنب crm2011-service-odata | لا تستهدف نقطة نهاية Microsoft Dynamics CRM 2011 OData 2.0. | هام | الاستعداد للترقية |
| موارد الويب | تجنب -crm2011-service-soap | لا تستهدف خدمات Microsoft Dynamics CRM 2011 SOAP. | هام | الاستعداد للترقية |
| موارد الويب | avoid-loadtheme | لا تستخدم loadTheme Fluent v8 API. |
منخفض | إمكانية الدعم |
| موارد الويب | تجنب-browser-specific-api | لا تستخدم واجهات برمجة التطبيقات القديمة أو المكونات الإضافية للمستعرض في Internet Explorer. | هام | الاستعداد للترقية |
| موارد الويب | تجنب-unpub-api | عالي | إمكانية الدعم | |
| موارد الويب | تجنب-window-top | عالي | إمكانية الدعم | |
| موارد الويب | تجنب-2011-api | لا تستخدم نموذج كائن Microsoft Dynamics CRM 2011 المهمل. بدلا من ذلك، اتبع Dataverse وثائق API على الويب. | عالي | الاستعداد للترقية |
| موارد الويب | استخدم-relative-uri | لا تستخدم عناوين URL لنقاط نهاية Dataverse المطلقة. | متوسط | الصيانة |
| موارد الويب | استخدم-cached-webresource | متوسط | الأداء | |
| موارد الويب | استخدم-client-context | استخدم سياقات العميل. | متوسط | الاستعداد للترقية |
| موارد الويب | استخدم-navigation-api | استخدم معلمات API للتنقل. | متوسط | الاستعداد للترقية |
| موارد الويب | استخدم-offline | متوسط | الاستعداد للترقية | |
| موارد الويب | افتراض عدم جعل الوالدين | عالي | التصميم | |
| موارد الويب | استخدام وضع المنظمة | استخدم إعدادات المؤسسة. | متوسط | الاستعداد للترقية |
| موارد الويب | استخدام السياق العالمي | متوسط | الاستعداد للترقية | |
| موارد الويب | استخدام الشبكة API | استخدم واجهات برمجة تطبيقات الشبكة. | متوسط | الاستعداد للترقية |
| موارد الويب | استخدام الحوارات فائدة | متوسط | الاستخدام | |
| موارد الويب | avoid-isActivityType | استبدل الأسلوب Xrm.Utility.isActivityType ببيانات تعريف Xrm.Utility.gettableMetadata الجديدة ولا تستخدم قواعد الشريط. | متوسط | الاستعداد للترقية |
| موارد الويب | meta-avoid-silverlight | تم إهمال استخدام مورد ويب Silverlight. | متوسط | الاستعداد للترقية |
| موارد الويب | قم بإذالة-debug-script | تجنب تضمين برنامج التصحيح النصي في بيئات غير التطوير. | متوسط | الاستخدام |
| موارد الويب | استخدم-strict-mode | استخدم وضع التقييد عندما يكون ذلك ممكنًا. | متوسط | الاستخدام |
| موارد الويب | استخدام عوامل المساواة الصارمة | استخدم عوامل مساواة صارمة. | متوسط | الاستخدام |
| موارد الويب | تجنب التقييم | لا تستخدم دالة "التقييم" أو صيغها الوظيفية. | هام | الأمان |
| موارد الويب | تجنب | لا تستخدم عامل التشغيل "with". | عالي | الأداء |
| موارد الويب | إزالة التنبيه | لا تستخدم دالة "alert" أو صيغها الوظيفية. | متوسط | الاستخدام |
| موارد الويب | إزالة وحدة التحكم | تجنب استخدام الأساليب على وحدة التحكم. | متوسط | الاستخدام |
| موارد الويب | تجنب-ui-Refreshribbon | تجنب استخدام refreshRibbon في النموذج onload وEnableRule. | هام | الأداء |
| موارد الويب | استخدمuse-getsecurityroleprivilegesinfo | تجنب userSettings.securityRolePrivileges. استخدم userSettings.getSecurityRolePrivilegesInfo. | عالي | الأداء |
| موارد الويب | use-appsidepane-api | استخدم Xrm.App.sidePanes.createPane بدلاً من Xrm.Panels.loadPanel. | متوسط | الاستعداد للترقية |
| موارد الويب | ملفات تعريف الارتباط (web-sdl-no-cookies) على الويب | ملفات تعريف الارتباط HTTP هي آلية تخزين قديمة من جانب العميل لها مخاطر ملازمة وحدود. استخدم مساحة تخزين الويب أو IndexedDB أو طرق حديثة أخرى بدلا من ذلك. | متوسط | الأمان |
| موارد الويب | مجال ويب-sdl-no-document-domain | يجب مراجعة خاصية الكتابة إلى document.domain لتجنب تجاوز عمليات التحقق من نفس الأصل. ممنوع منعا باتا استخدام مجالات المستوى الأعلى مثل azurewebsites.net المستوى. | متوسط | الأمان |
| موارد الويب | ويب-sdl-no-document-domain | المكالمات للمستندات.write أو document.writeln لمعالجة DOM مباشرة دون أي إهتيال وينبغي تجنبه. استخدم مستند.createElement() أو أساليب مشابهة بدلا من ذلك. | متوسط | الأمان |
| موارد الويب | web-sdl-no-html-method | وتعالج المكالمات المباشرة لطريقة html() في الغالب (في jQuery framework) DOM دون أي تدخل في المناشف وينبغي تجنبها. استخدم مستند.createElement() أو أساليب مشابهة بدلا من ذلك. | متوسط | الأمان |
| موارد الويب | web-sdl-no-inner-html | التخصيصات لخصائص innerHTML أو outerHTML تتعامل مع DOM مباشرة دون أي تعقيم ويجب تجنبها. استخدم مستند.createElement() أو أساليب مشابهة بدلا من ذلك. | متوسط | الأمان |
| موارد الويب | url-sdl-no-insecure-web-sdl-no-insecure-url | وينبغي استبدال بروتوكولات غير آمنة مثل HTTP أو FTP بواسطة الأجهزة المشفرة (HTTPS، FTPS) لتجنب إرسال بيانات قد تكون حساسة عبر الشبكات غير الهامة في نص عادي. | متوسط | الأمان |
| موارد الويب | web-sdl-no-msapp-exec-غير آمن | استدعاءات إلى MSApp.execUnsafeLocalFunction() bypass التحقق من صحة البرنامج النصي لتجاوز هذه الحالات وينبغي تجنبه. | متوسط | الأمان |
| موارد الويب | web-sdl-no-postmessage-الأصلي | يجب دوما توفير أصل هدف معين، وليس * عند إرسال البيانات إلى نوافذ أخرى باستخدام postMessage لتجنب تكرار البيانات خارج حدود الثقة. | متوسط | الأمان |
| موارد الويب | web-sdl-no-winjs-html-غير آمن | لا تؤدي استدعاءات WinJS.المرافق.setInnerHTMLUnsafe() والطرق المتشابهة إلى إجراء أي تحقق من صحة الإدخال وينبغي تجنبها. استخدم WinJS.المرافق.setInnerHTML() بدلا من ذلك. | متوسط | الأمان |
| تطبيق اللوحة | تطبيق-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
أفضل الممارسات والإرشادات للتطبيقات التي تستند إلى نموذج
المشاكل الشائعة والحلول من مدقق الحلول
الملاحظات
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجع https://aka.ms/ContentUserFeedback.
إرسال الملاحظات وعرضها المتعلقة بـ