تصحيح الأخطاء حلول SharePoint

تصحيح حلول SharePoint باستخدام Visual Studioمصحح الأخطاء. عند تشغيل تصحيح الأخطاء Visual Studioبنشر ملفات المشروع إلى SharePoint الخادم ثم يقوم بفتح مثيل من موقع SharePoint في مستعرض ويب. تشرح المقاطع التالية كيفية إلى يصحح تطبيقات SharePoint في Visual Studio.

• تمكين تصحيح الأخطاء

• F5 تصحيح الأخطاء و عملية التوزيع

• ميزات SharePoint مشروع

• تصحيح الأخطاء مهام سير العمل

• ميزة تصحيح الأخطاء مستقبلات الأحداث

• تمكين معلومات تصحيح الأخطاء محسن

تمكين تصحيح الأخطاء

عندما تقوم debug SharePoint أولاً الحل في Visual Studio، يعلمك مربع حوار لم يتم تكوين ملف ويب.config لتمكين تصحيح. (يتم إنشاء ملف ويب.config عند يثّبت خادم SharePoint. للحصول على مزيد من المعلومات، راجع العمل ضمن ملفات وحدة تحكم MMC. مربع حوار يتيح لك خيار إما تشغيل المشروع دون التصحيح أو تعديل ملف ويب.config إلى تمكين تصحيح أخطاء. إذا قمت بتحديد الخيار الأول المشروع يعمل بشكل طبيعي. إذا قمت بتحديد الخيار الثاني تكوين ملف ويب.config إلى:

• تشغيل يتصل المكدس ( CallStack="true")

• يعطل مخصص أخطاء في Visual Studio( <customErrors mode="Off" />)

• تمكين التجميع تصحيح الأخطاء ( <compilation debug="true">)

يتبع ملف ويب.config الناتج:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <configuration>
        ...
        <SharePoint>
            <SafeMode MaxControls="200"
                CallStack="true"
                DirectFileDependencies="10"
                TotalFileDependencies="50"
                AllowPageLevelTrace="false">
                ...
            </SafeMode>
        ...
        </SharePoint>
        <system.web>
            ...
            <customErrors mode="Off" />
            ...
            <compilation debug="true">
            ...
            </compilation>
            ...
        </system.web>
        ...
    </configuration>

عكس التغييرات ويعطل تصحيح الأخطاء, تغيير التالية XMLفي الملف ويب.config:

• إيقاف تشغيل مكدس الاستدعاءات ( CallStack="false")

• تمكين رسائل الخطأ المخصصة في Visual Studio( <customErrors mode="On" />)

• يعطل تصحيح التحويل البرمجي ( <compilation debug="false">)

F5 تصحيح الأخطاء و عملية التوزيع

عند تشغيل المشروع SharePoint في الوضع التصحيح، عملية التوزيع SharePoint بتنفيذ المهام التالية:

1. يشغل الأوامر pre-توزيع القابلة للتخصيص.

2. إنشاء ملف حزمة (.wsp) حل ويب باستخدام MSBuildالأوامر. يتضمن ملف .wsp الكل الملفات الضرورية والميزات. لمزيد من المعلومات، راجع نظرة حلول.

3. إذا كان SharePoint الحل مزرعة الحل ، recycles IISتجمع تطبيقات الخاصة بالموقع المحدد URL. هذه الخطوة إصدارات الملفات مؤمنة بواسطة IISالعملية المنفذة.

4. وفي حالة وجود إصدار سابق من الحزمة بالفعل، retracts الإصدار السابق من الملفات في ملفات .wsp والميزات. هذه الخطوة يلغي تنشيط الميزات إلغاء تثبيت حزمة الحلول و ثم يحذف حزمة الحلول على SharePoint الخادم.

5. قم بتثبيت الإصدار الحالي من ميزات والملفات في ملفات .wsp. يضيف هذه الخطوة وتثبيتها الحل على SharePoint الخادم.

6. لمهام سير العمل "، يتم تثبيت التجميع سير العمل. يمكنك تغيير الموقعه باستخدام Assembly Locationالخاصية.

7. تنشيط ميزة "المشروع" في SharePoint إذا كان النطاق موقع أو صفحة ويب. لم يتم تنشيط الميزات الموجودة في المزرعة و WebApplication النطاقات.

8. مهام سير العمل ، يقترن سير العمل مع مكتبة SharePoint أو قائمة أو الموقع الذي حددته معالج تخصيص SharePoint.

   ملاحظة

   يحدث هذا الاقتران فقط إذا قمت بتحديد إقران سير العمل تلقائياً في المعالج.

9. يشغل الأوامر pre-توزيع القابلة للتخصيص.

10. يصل Visual Studioالمصحح إلى معالجة Windows SharePoint Services(w3wp.exe). إذا كان نوع المشروع يتيح إمكانية تغيير Sandboxed Solutionيتم تعيين الخاصية والقيمة الخاصة بها إلى true, ثم إرفاق مصحح الأخطاء عملية مختلفة (SPUCWorkerProcess.exe). لمزيد من المعلومات، راجع اعتبارات sandboxed الحل.

11. يبدأ تشغيل المصحح JavaScript إذا كان حل SharePoint حل مزرعة.

12. يعرض المناسبة مكتبة أو قائمة أو موقع الصفحة في مستعرض ويب.

Visual Studioيعرض رسالة حالة في نافذة الإخراج بعد مكتمل كل مهمة. إذا كان لا يمكن مكتمل مهمة, Visual Studioتعرض رسالة خطأ في نافذة "قائمة خطأ".

ميزات SharePoint مشروع

هي ميزة وحدة المحمولة و نمطي من الوظائف التي تبسط التعديل المواقع باستخدام ملفات تعريف الموقع. يتم أيضاً حزمة Windows SharePoint Servicesعناصر (WSS) يمكن تنشيط عن نطاق معيّن يساعد المستخدمين على تحقيق هدف معين أو مهمة. يتم نشر قوالب كميزات.

تشغيل مشروع في يصحح الوضع عملية التوزيع بإنشاء مجلد في الدليل الميزة عند %COMMONPROGRAMFILES%\Microsoft Shared\ويب extensions\14\قالب\FEATURES الخادم. تحتوي أسماء ميزة في تنسيق اسم المشروع _Feature x ، مثل TestProject_Feature1.

يحتوي مجلد الحل في دليل الميزة على ملف تعريف الميزة ملف تعريف سير العمل. وصف ملف تعريف الميزة (Feature.xml) الملفات الموجودة في ميزة للمشروع. وصف ملف تعريف المشروع (عناصر.xml) قالب مشروع. يمكن العثور على عناصر.xml في مستكشف الحلول بينما يتم إنشاء ميزة.xml عند إنشاء حزمة الحلول. للحصول على مزيد من المعلومات حول هذه العناصر، راجع للمشروع SharePoint و العنصر خصائص المشروع.

تصحيح الأخطاء مهام سير العمل

عندما تقوم يصحح سير عمل المشاريع "،" Visual Studioيضيف قالب سير العمل (اعتماداً تشغيل النوع الخاص به) إلى مكتبة أو قائمة. ثم يمكنك يبدأ قالب سير العمل يدوياً أو بواسطة إضافة أو تحديث عنصر. يمكنك حينئذ استخدام Visual Studioإلى التصحيح سير العمل.

ملاحظة

إذا قمت بإضافة مراجع إلى التجميعات الأخرى تأكد من أن هذه التجميعات مثبتة في مخزن المجموعات العمومي المؤقت ( GAC). وإلا، ستفشل الحل سير العمل. للحصول على معلومات حول كيفية يثّبت التجميعات راجع يدوياً بدء تشغيل سير العمل على المستند أو العنصر .

ومع ذلك، لا يبدأ عملية التوزيع سير العمل. يجب عليك يبدأ سير العمل من موقع SharePoint على ويب. يمكنك أيضاً يبدأ سير العمل باستخدام تطبيق عميل مثل Microsoft Office Word 2007 أو باستخدام تعليمات برمجية من جانب الخادم منفصلة. استخدم إحدى الطرق المحددة في معالج تخصيص SharePoint.

على سبيل المثال، إذا حددت من يمكن بدء سير العمل يدوياً بدء سير العمل مباشرةً من العنصر في القائمة أو المكتبة. للحصول على أكثر المعلومات حول كيفية يبدأ سير عمل يدوياً، راجع يدوياً بدء سير عمل على عنصر مستند.

ميزة تصحيح الأخطاء مستقبلات الأحداث

بشكل افتراضي، عند تشغيل Visual Studioتطبيق SharePoint بشكل تلقائي عند تنشيط ميزاته لك على SharePoint الخادم. ومع ذلك، يؤدي مشاكل عند تصحيح ميزة حدث مستقبلات, لأن عند تنشيط ميزة بواسطة Visual Studio تشغيلها في عملية مختلفة من مصحح الأخطاء. وهذا يعني أنه بعض تصحيح الأخطاء الوظيفي، مثل نقاط التوقف, لن تعمل بشكل صحيح.

يعطل التنشيط التلقائي الميزة في SharePoint والسماح التصحيح المناسب ميزة حدث مستقبلات, تعيين الالقيمة للمشروع تكوين نشر نشط Directory الخاصية التنشيط لا قبل التصحيح. بعد ذلك، بعد الاتصال Visual StudioSharePoint التطبيق قيد التشغيل يدوياً تنشيط الميزة في SharePoint. للقيام بذلك، انقر فوق إعدادات الموقع القائمة إجراءات الموقع في SharePoint ، انقر فوق الارتباط إدارة ميزات الموقع ومن ثم انقر فوق الزر تنشيط بجانب الميزة ثم سيرة ذاتية التصحيح العادي كما.

تمكين معلومات تصحيح الأخطاء محسن

الاستحقاق إلى معقدة أحياناً التفاعلات بين Visual Studioعملية (devenv.exe) Visual StudioSharePoint معالجة المضيف (vssphost4.exe) و SharePoint ، و الطبقة WCF تشخيص الأخطاء التي تحدث أثناء الإنشاء بتوزيع, و كذلك forth يمكن الارتياب. إلى المساعدة لحل تلك الأخطاء, يمكنك تمكين معلومات تصحيح الأخطاء المحسنة. للقيام بهذا، انتقل إلى المفتاح السجل التالي في تسجيل Windows:

[HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\SharePointTools]

تغيير القيمة المفتاح "EnableDiagnostics" من "0" إلى "1".

تعيين القيمة هذا المفتاح إلى 1 الأسباب مكدس تتبع المعلومات التي تظهر في النافذة إخراج كلما تحدث أخطاء النظام المشروع أثناء تشغيل Visual Studio. ليعطل معلومات تصحيح الأخطاء المحسنة تعيين EnableDiagnostics إلى 0.

للحصول على أكثر راجع المعلومات حول مفاتيح السجل الأخرى SharePoint تصحيح ملحقات لأدوات SharePoint في Visual Studio.

راجع أيضًا:

المبادئ

حلول SharePoint استكشاف الأخطاء وإصلاحها