المشاكل الشائعة والحلول من مدقق الحلول
تسرد هذه المقالة بعض المشاكل الشائعة التي قد تواجهها أثناء استخدام مدقق الحلول. تم توفير حلول بديلة، حيث أمكن.
لا يمكنك استخدام مدقق الحلول لإجراء تحليل أو تنزيل النتائج
بعد فترة وجيزة من إرسال طلب مدقق الحلول لإجراء تحليل أو لتنزيل النتائج، لا تكتمل العملية وتظهر رسالة خطأ مثل:
"تعذر إجراء تدقيق الحل [اسم الحل]. حاول التشغيل مرة أخرى."
وكلما أمكن، يحاول مدقق الحلول إرجاع رسالة خطأ محددة مرتبطة بتفاصيل حول السبب المحتمل وخطوات الحل. حدد "معرفه المزيد" للحصول على التفاصيل.
ستفشل عمليات الفشل التي تحدث أثناء المعالجة الخلفية للتحليل مع عرض الحالة تعذر الإكمال وإرجاع رسالة خطأ في مدخل Power Apps، بالإضافة إلى إرسال إعلام بالبريد الإلكتروني إلى الطالب.
يؤدي تحديد إعلام المدخل إلى الارتباط بصفحة المشكلات الشائعة لمزيد من استكشاف الأخطاء وإصلاحها. إذا لم يقدم أي من المشكلات الشائعة حلا للمشكلة، سيتم إرجاع رقمًا مرجعيًا أيضًا. ادخل هذا الرقم المرجعي لدعم Microsoft لمزيد من الاستقصاء.
فشل مدقق الحلول في التدقيق في الحل الافتراضي
يقوم مدقق الحلول بتصدير الحل من بيئة Microsoft Power Platform لتحليله. تصدير الحل الافتراضي غير مدعوم وقد لا تكتمل عملية الفحص بنجاح. مزيد من المعلومات: فشل مدقق الحلول في تصدير حلول كبيرة.
فشل مدقق الحلول بسبب إصدار مدقق Power Apps غير المدعوم
مدقق الحلول هو ميزة يتم تمكينها بواسطة مدقق تطبيق Power Apps. إذا كنت قد قمت بتثبيت تطبيق مدقق Power Apps بإصدار يسبق الإصدار 1.0.0.47، فقد يتعذر تشغيل مدقق الحلول بنجاح. يجب ترقية إصدار مدقق Power Apps من مركز إدارة Power Platform.
ومع ذلك، إذا كنت تستخدم إصدار مدقق Power Apps يسبق الإصدار 1.0.0.45، فنحن ننصحك بحذف الحل وتثبيته مرة أخرى. نظرًا للتغييرات التي تم إدخالها مؤخرًا على المخطط، قد تفشل ترقية مدقق Power Appsمن الإصدارات التي تسبق الإصدار 1.0.0.45.
إذا أردت الاحتفاظ بالنتائج السابقة من مدقق الحلول، فعليك تصدير النتائج من تشغيل سابق أو تصدير كافة بيانات مدقق الحلول باستخدام تصدير البيانات إلى Excel لتصدير البيانات من الجداول التالية:
- مكون التحليل
- مهمة التحليل
- نتيجة التحليل
- تفصيل نتيجة التحليل
كيفية إلغاء تثبيت مدقق Power Apps
لإلغاء تثبيت مدقق Power Apps:
- بصفتك مسؤول النظام أو مخصص النظام، افتح مدخل Power Apps عن طريق الانتقال إلى https://make.powerapps.com/environments.
- قم بتحديد حلول.
- حدد مدقق Power Apps، ثم على شريط أدوات الحلول، حدد حذف.
كيفية تثبيت مدقق Power Apps
لتثبيت مدقق Power Apps مرة أخرى في بيئتك:
- بصفتك مسؤول النظام أو مخصص النظام، افتح مدخل Power Apps عن طريق الانتقال إلى https://make.powerapps.com/environments.
- قم بتحديد حلول.
- على شريط أدوات الحلول، حدد مدقق الحلول، ثم حدد تثبيت.
لا يمكن لمدقق الحلول الوصول إلى البيئات في وضع الإدارة
تقيد البيئات التي تم وضعها في وضع الإدارة عن عمد الوصول إلى المستخدمين الذين لديهم أدوار مسؤولي النظام ومخصص النظام فقط. ونظرًا لخلو هوية تطبيق مدقق Power Apps من هذه الأدوار المعينة افتراضيًا، لا يمكنها الوصول إلى المؤسسات التي تعمل في هذا الوضع.
لاستخدام مدقق الحلول في هذه المؤسسة، يجب تعطيل وضع الإدارة.
كيفية تعطيل وضع الإدارة
لتعطيل وضع الإدارة لمثيل مؤسسة:
سجل دخولك إلى مركز إدارة Power Platform.
افتح البيئة التي يوجد بها مشاكل في تشغيل مدقق الحل، ثم حدد تحرير.
عيّن وضع الإدارة إلى مُعطل، ثم حدد حفظ.
شغّل مدقق الحلول من جديد.
يفشل مدقق الحلول بسبب أدوار الأمان المفقودة
يتطلب مستخدم التطبيق لمدقق الحلول اثنين من أدوار الأمان التي تم تعيينها من أجل توفير الامتيازات اللازمة للاتصال بمؤسسة Dataverse. في حالة عدم تعيين أي من هذين الدورين للمستخدم "مدقق Power Apps"، سيؤدي ذلك إلى فشل محاولات إجراء التحليل وتنزيل النتائج وتشغيل الإلغاء. غالبًا ما يحدث هذا عندما يكون العملاء لديهم أتمتة في المكان الذي يؤدي إلى إزالة أدوار الأمان من المستخدمين غير المتوقعين. تتضمن أدوار الأمان التالية الحد الأدنى للأذونات المطلوبة:
- تصدير التخصيصات
- مدقق الحلول
كيفية تعيين أدوار الأمان المفقودة
لتعيين أدوار أمان مفقودة إلى مستخدم مدقق Power Apps:
- افتح مؤسسة Dataverse وانتقل إلى الإعدادات > الأمان > المستخدمون.
- حدد مستخدم "مدقق Power Apps" من قائمة المستخدمين.
- في شريط الأوامر، حدد إدارة الأدوار.
- حدد مربعات اختيار الدور "تصدير التخصيصات" و "مدقق الحل"، ثم حدد موافق.
- شغّل مدقق الحلول من جديد.
يفشل مدقق الحلول بسبب تقييد وضع الوصول
يتطلب مستخدم التطبيق لمدقق الحلول وضع وصول "غير تفاعلي" أو "للقراءة والكتابة" من أجل الاتصال بمؤسسة Dataverse. في حالة تغيير قيمة وضع الوصول إلى قيمة أخرى مثل "إداري"، سيؤدي ذلك إلى فشل محاولات إجراء التحليل وتنزيل النتائج وتشغيل الإلغاء.
لحل هذه المشكلة، يجب تحديث وضع مستخدم تطبيق "مدقق Power Apps" بوضع الوصول "غير تفاعلي".
كيفية تحديث وضع وصول المستخدم
لتحديث وضع الوصول لمستخدم مدقق Power Apps:
- افتح مؤسسة Dataverse وانتقل إلى الإعدادات > الأمان > المستخدمون.
- حدد مستخدم "مدقق Power Apps" من قائمة المستخدمين وانقر نقرًا مزدوجًا لفتح نموذج المستخدم.
- قم بالتمرير إلى قسم "الإدارة" > "معلومات ترخيص وصول العميل (CAL)" في النموذج.
- حدد "غير تفاعلي" في عنصر تحكم القائمة المنسدلة لوضع الوصول.
- حفظ نموذج المستخدم وإغلاقه.
- شغّل مدقق الحلول من جديد.
يفشل مدقق الحلول بسبب تعطيل مستخدم التطبيق
يجب تمكين مستخدم تطبيق مدقق Power Apps في مؤسسة Dataverse والذي يحتوي على الحلول التي سيتم تحليلها. وإذا تم تعطيل مستخدم التطبيق، ستفشل الطلبات الخاصة بتحليل الحلول في نفس المؤسسة. إذا تلقيت رسالة الخطأ هذه، فتحقق أولاً من انه تم تعطيل مستخدم تطبيق مدقق Power Apps بالفعل. ثم اتبع خطوات تخفيف المخاطر الموضحة أدناه.
كيفية تمكين مستخدم تطبيق مدقق Power Apps .
- في مركز إدارة Power Platform، حدد البيئة وانتقل إلى الإعدادات > المستخدمين + الأذونات > المستخدمين.
- في طريقة العرض مستخدمي التطبيق، حدد علامة الاختيار الموجودة بجانب مستخدم تطبيق مدقق Power Apps .
- في شريط أدوات الإجراءات، حدد تمكين
- وفي رسالة تأكيد تنشيط المستخدم، حدد تنشيط.
- والأسلوب البديل هو فتح نموذج مستخدم التطبيق وتحديد حالة التمكين في تذييل النموذج. احفظ التغييرات.
يظل مدقق الحل في حالة قيد التشغيل لأكثر من دقيقة مدققة
قد يظل مدقق الحل في حالة قيد التشغيل بشكل غير محدد إذا كان الحل الذي تم تحليله يحتوي على مكونات إضافية تم تطويرها باستخدام .NET Standard 2.0. لا يتم حاليا دعم الوظائف الإضافية التي تستخدم .NET Standard 2.0 في مدقق الحلول وينبغي استبعادها من التحليل. قم باستبعاد مكون المكون الإضافي إما بإزالته من الحل الهدف، أو باستخدام المعلمة "ExcludedFileNamePattern" في وحدة PowerShell لمدقق Power Apps.
حالات المكونات الإضافية الشائعة التي تتسبب في فشل مدقق الحلول
عند تلقي مدقق الحلول ومعالجة طلبات التحليل، يجب ان يقوم باستدعاء نقطة النهاية Dataverse لاسترداد بيانات الوظيفة ذات الصلة وتحديثها وتصدير الحلول المحددة. كل تفاعل تم إنشاؤه بواسطة خدمة مدقق الحلول مع Dataverse يمكن ان يقوم بتشغيل واحد أو أكثر من الخطوات الإضافية التي تم تسجيلها على الرسالة المرسلة في الطلب. وقد تعمل هذه المكونات الإضافية على تقديم الحالات التي تمنع معالجة الرسالة كما هو متوقع من قبل Dataverse ومقاطعة قدرة مدقق الحلول على معالجة مهمة التحليل المطلوبة. وقد تحدث مواقف مشابهة عند تنزيل نتائج مهمة مدقق الحلول أو إلغاء مهمة تحليل قيد التقدم.
عمليات Dataverse النموذجية المطلوبة بواسطة مدقق الحلول:
- استرداد الحل ومستخدم النظام وبيانات جدول المؤسسة
- إنشاء وتحديث واسترداد بيانات جدول استرداد مهمة التحليل ومكون التحليل ونتائج التحليل
- تصدير الحلول
تم تسجيل خطوة المكون الإضافي للتنفيذ في سياق مستخدم غير مرخص
عندما يفشل مدقق الحل بسبب استثناء "مستخدم غير مرخص"، فإنه غالبًا ما يكون ناتجًا عن خطوة مكون إضافي مُكّون تم تشغيله للتنفيذ في سياق مستخدم نظام معين غير مرخص له حاليًا. تأكد من أن الخطوات الإضافية التي يمكن تشغيلها بواسطة مدقق الحلول يتم تنفيذها في سياق مستخدم مرخص.
هام
يوصي بشدة تكوين خطوات المكون الإضافي للتنفيذ في سياق المستخدم المستدعي بدلاً من مستخدمين محددين خاضعين لترخيص معين تم إبطاله.
تقوم خطوة المكونات الإضافي بتنفيذ العمليات التي تتطلب امتيازات لا تمنح مستخدم تطبيق مدقق Power Apps .
عندما يفشل مدقق الحلول بسبب رفض Dataverse الوصول استنادًا إلى امتياز مفقود، فغالبًا ما يكون السبب هو أن الوظيفة الإضافية مُشغله والتي تقوم بتنفيذ العمليات التي تتطلب امتيازات غير ممنوحة حاليًا إلى مستخدم تطبيق مدقق Power Apps . إما أن تقوم بإعادة تكوين خطوة المكون الإضافي بحيث لا يتم تنفيذها في العملية التي تم استدعائها بواسطة مدقق الحلول أو منح مستخدم تطبيق مدقق Power Apps الامتيازات اللازمة لتنفيذ خطوة المكون الإضافي المخصصة.
تُقاطع خطوة المكون الإضافي التنفيذ بشكل غير متوقع عن طريق طرح InvalidPluginExecutionException
قد يفشل مدقق الحل بسبب الخطأ "تم إحباط العملية من رمز ISV" أو "حدث خطأ غير متوقع من رمز ISV". عند حدوث ذلك، يشير ذلك إلى أنه تم تشغيل خطوة البرنامج المساعد التي أوقفت التنفيذ بشكل صريح عن طريق طرح InvalidPluginExcecutionException أو أنه لم يتم اكتشاف خطأ بشكل صحيح في كود البرنامج المساعد. إما إعادة تكوين خطوة المكون الإضافي بحيث لا يتم تنفيذها في العملية التي تم استدعائها بواسطة مدقق الحلول أو ضبط تنفيذ المكون الإضافي لعدم مقاطعة التنفيذ استنادًا إلى الشروط التي يوفرها مدقق الحلول.
تتضمن العمليات الشائعة التي يتم استدعاؤها بواسطة مدقق الحلول إنشاء وتحديث. يمكن أن تحدث هذه العمليات في الجداول التالية: مهمة التحليل أو مكون التحليل أو نتيجة التحليل.
يفشل مدقق الحلول بسبب تعطيل تطبيق الجهة خارجية في Azure Active Directory
ينبغي ألا يتم تعطيل هوية تطبيق مؤسسة الجهة الأولى (مستشارPowerApps) في Azure Active Directory (AAD) المُستخدمة بواسطة مدقق الحلول. في حالة التعطيل، لا يمكن مصادقة الهوية عند طلب الرموز المميزة لـ Dataverse وموفري الموارد المطلوبين الآخرين بالإنابة عن المستخدم الطالب.
اتبع الخطوات التالية للتحقق من عدم تعطيل هوية التطبيق في AAD، وقم بتمكين التطبيق إذا كان ذلك ضروريًا.
كيفية التحقق من و/أو تعديل حالة تمكين التطبيق
للتحقق من و/أو تعديل حالة تمكين هوية تطبيق المؤسسة في مستشار PowerApps
- الوصول إلى المستأجر في مدخل Azure Active Directory (AAD).
- انتقال إلى تطبيقات المؤسسة.
- حدد كل التطبيقات وابحث عن "مستشار PowerApps".
- حدد "مستشار PowerApps" لعرض تفاصيل التطبيق.
- حدد الخصائص.
- تحقق من حالة ممكَّن لتسجيل دخول المستخدمين. إذا كانت الحالة "لا"، فقد تم تعطيل التطبيق.
- حدد عنصر التحكم التبادلي لتبديل القيمة إلى "نعم". يؤدي ذلك على تمكين التطبيق.
- حدد حفظ. التطبيق ممكَّن حاليًا. قد تحتاج إلى الانتظار بضع دقائق للتغيير إلى النشر.
- شغّل مدقق الحلول من جديد.
هام
يجب أن يكون لديك امتيازات المسؤول في Azure Active Directory (AAD) لتتمكن من تحرير تطبيقات المؤسسة.
فشل مدقق الحلول في تصدير حلول بمكونات مسودة سير إجراءات العمل
في حالة احتواء أحد الحلول على مكون سير إجراءات العمل بالحالة مسودة التي لم يتم تنشيطها من قبل، سيفشل مدقق الحلول في تصدير الحل لإجراء التحليل. لا يعد هذا الخطأ فريدًا بالنسبة لمدقق الحلول ويحدث نتيجة لسير إجراءات العمل التي لها تبعية على مكون جدول مساعد (مخصص) لا يتم إنشاؤه إلى أن يتم تنشيط سير إجراءات العمل لأول مرة. قد تحدث هذه المشكلة أيضًا عند تنشيط سير إجراءات العمل من داخل مستكشف الحلول.
المرجع مقالة قاعدة المعارف رقم 4337537: Invalid Export - Business Process table Missing للحصول على تفاصيل حول المشكلة وخطوات الحل.
فشل مدقق الحلول في تصدير الحلول باستخدام مكونات التطبيق المستندة إلى النموذج
إذا كان الحل يحتوي على تطبيق مستند إلى النموذج، فقد يفشل مدقق الحلول في تصدير الحل للتحليل. يحدث هذا الخطأ بسبب الأمان المستند إلى الدور لمشاركة التطبيقات. إذا لم يكن مستخدم تطبيق مدقق Power Apps يتمتع بحق الوصول المناسب إلى التطبيقات المستندة إلى النماذج، فستفشل عملية تصدير أي حلول تحتوي عليها مع مدقق الحلول.
لحل هذه المشكلة، امنح دور الأمان منشئ البيئة لمستخدم تطبيق مدقق Power Apps.
فشل مدقق الحلول في تصدير الحلول التي تم تطبيق تصحيح عليها
إذا تم تطبيق تصحيح على أحد الحلول، فسيخفق مدقق الحلول في تصدير الحل لتحليله. عند تطبيق تصحيح على أحد الحلول، يصبح الحل الأصلي مؤمنًا ولا يمكن تغييره أو تصديره عند وجود تصحيحات تابعة في المؤسسة تعرّف الحل على أنه الحل الأصل.
لحل هذه المشكلة، انسخ الحل بحيث تُنشر جميع التصحيحات المتعلقة به في الحل المُنشأ حديثًا. يؤدي هذا إلى إلغاء تأمين الحل ويسمح بتصدير الحل من النظام. لمزيد من المعلومات، راجع استنساخ حل.
لن يحلل مدقق الحلول الحلول الفارغة
في حالة تصدير مدقق الحلول لحل لا يحتوي علي أي مكونات للتحليل، سيقوم بإنهاء المعالجة الإضافية وربما يفشل التشغيل. تأكد من تضمين الحل المحدد الذي يتم إرساله لتحليل مدقق الحلول لمكون واحد على الأقل.
يفشل مدقق الحلول في تصدير الحلول الكبيرة
يتضمن السيناريو الأساسي للفشل في تصدير حل كبير من بيئة استثناء مهلة في طلب التصدير. سيحدث هذا في حالة تجاوز الطلب 20 دقيقة. قد يفشل تصدير الحلول الكبيرة، مثل الحل الافتراضي، خلال هذه الفترة الزمنية، ولن تكتمل عملية التدقيق بنجاح. في حالة مواجهة مدقق الحلول مهلة خلال التصدير، سيحاول ثلاث مرات قبل أن يفشل في معالجة المهمة، وبالتالي قد يستغرق الأمر ساعة قبل أن تتلقى إعلامًا بالفشل.
يقضي الحل البديل بإنشاء حلول أصغر بمكونات أقل ليتم تحليلها. إذا كان سبب الحجم الكبير لملف الحل يعود إلى مكونات تجميع المكون الإضافي العديدة، فيُرجى مراجعة إرشادات تحسين تطوير التجميع المخصص.
هام
لتقليل عدد الإيجابيات الخاطئة، تأكد من إضافة تخصيصات تابعة. عندما تضيف حلاً وتضيف هذه المكونات، ضمّنها ما يلي:
- عندما تضيف مكونات إضافية، ضمّن خطوات معالجة رسائل SDK للمكون الإضافي.
- عندما تضيف نماذج الجداول، ضمّن موارد الويب JavaScript مرفقة بأحداث النموذج.
- عندما تضيف موارد الويب JavaScript، ضمّن أي موارد ويب JavaScript تابعة.
- عندما تضيف موارد ويب HTML، ضمّن أية برامج نصية تابعة تم تعريفها ضمن مورد ويب HTML.
- عندما تضيف مهام سير العمل المخصصة، ضمّن التجميع المستخدم في سير العمل.
مراجع أرقام الأسطر للمشاكل في موارد HTML مع JavaScript المضمنة غير صحيحة
عند معالجة موارد الويب HTML داخل مدقق الحلول، تتم معالجة مورد ويب HTML بشكل منفصل عن JavaScript ضمن مورد ويب HTML. نتيجة لذلك، لم يكون رقم السطر للانتهاك الذي تم العثور عليه ضمن <script> لمورد ويب HTML صحيحًا.
خطأ Web-avoid-eval لمكونات كود Power Apps component framework
إذا تم الإبلاغ عن خطأ تقييم web-avoid-eval لمكون كود Power Apps component framework تم إنشاؤه باستخدام أدوات CLI، فأنشئ حزمة لعنصر التحكم مع msbuild /p:configuration=Release أو npm run build -- --buildMode production لإنتاج بنية إصدار لا تتضمن استخدام "eval".
مشكلة في بناء جملة غير مدعوم في الويب لموارد الويب
يدعم مدقق الحلول المتغيرات العمومية لبناء الجملة ECMAScript 2015 (ES6) وما يصل إلى ECMAScript 2018 (ES9). عندما يقوم مُدقق الحل بتحليل JavaScript باستخدام متغيرات عامة بعد ES6 أو بناء الجملة بعد ES9، يتم الإبلاغ عن مشكلة بناء جملة غير مدعومة على الويب لمورد الويب.
تم الإعلام عن انتهاكات متعددة لأنشطة المكونات الإضافية ومهام سير العمل التي تستند إلى نطاق الاستدعاء
فيما يتعلق بقواعد أنشطة المكونات الإضافية وسير العمل حيث تنطبق المشكلة في سياق الاستدعاء فقط، تبدأ أداة مدقق الحلول عملية التحليل على مستوى تنفيذ واجهة IPlugin وتعبر الرسم البياني للاستدعاء للكشف عن المشاكل ضمن نطاق هذا التنفيذ. في بعض الحالات، قد تصل مسارات استدعاء متعددة إلى الموقع نفسه حيث تم الكشف عن المشكلة. وبما أن المشكلة مرتبطة بنطاق الاستدعاء، قد تنشئ الأداة تقريرها استنادًا إلى هذا النطاق لتوفير صورة أفضل للتأثير بدلاً من الاستناد إلى مواقع مختلفة. وكنتيجة لذلك، قد تشير مشاكل متعددة إلى موقع واحد يجب إصلاحه.
قد يعرض app-formula-issues-high عددًا من الأخطاء يختلف عن تلك المعروضة في وضع التصميم
سيقوم مدقق الحلول بسرد عدد الأخطاء التي تم العثور عليها في التطبيق، بما في ذلك الاختبارات التي يتم الحصول عليها. يظهر مدقق التطبيق في وضع التصميم فقط أخطاء من عناصر تحكم ومكونات الشاشة. إذا كان عدد الأخطاء الموضح في مدقق التطبيق في وضع التصميم أصغر، فقم بفتح استوديو الاختبار وابحث عن الأخطاء في التعبيرات المستخدمة في الاختبارات.
انتهاكات مدقق الحلول تم التبليغ عنها لمكونات التعليمات البرمجية
يقوم مدقق الحلول بالتبليغ عن انتهاكات متعددة عند تشغيله على الحل الذي يحتوي على مكونات تعليمات برمجية مبنية في وضع تصحيح الأخطاء. يستهدف مدقق الحلول التحقق من صحة التعليمات البرمجية للاستخدام المتعلق بالإنتاج، وبالتالي يجب بناء مكونات التعليمات البرمجية باستخدام buildMode الصحيح: npm run build -- --buildMode production or msbuild /p:configuration=Release بحسب نظام البناء لديك. مزيد من المعلومات: إنشاء مكون تعليمات برمجية وبناؤه.
راجع أيضًا
أفضل الممارسات والإرشادات لـ Dataverse
أفضل الممارسات والإرشادات للتطبيقات التي تستند إلى نموذج
ملاحظة
هل يمكنك إخبارنا عن تفضيلات لغة التوثيق الخاصة بك؟ شارك في استطلاع قصير. (يرجى ملاحظة أن هذا الاستطلاع باللغة الإنجليزية)
سيستغرق الاستطلاع حوالي سبع دقائق. لا يتم جمع أي بيانات شخصية (بيان الخصوصية).
الملاحظات
إرسال الملاحظات وعرضها المتعلقة بـ