الخميس، 28 يوليو 2011

How To: Visual Web Part 1 on SlideShare




How To: Visual Web Part 1


تمت كتابة هذه المقالة كمحاضرة تم إلقاؤها في جامعة الأمير سلطان في الرياض برعاية مجموعة RSUG





You can download the article as PDF from the following link
How To: Visual Web Part 1



Create empty SharePoint project









- You should change http://stg-sp2010 to your URL.









Add new visual web part











- Change Feature1 --> RSUGHelloSharePoint2010Feature





Change web part namespace

1. Open RSUGHelloSharePoint2010.cs file and change the name space of RSUGHelloSharePoint2010 class to RSUGVisualWebPart01.








2. Open RSUGHelloSharePoint2010.webpart file.

3. Change name attribute value to RSUGVisualWebPart01.RSUGHelloSharePoint2010, $SharePoint.Project.AssemblyFullName$.








4. Open RSUGHelloSharePoint2010UserControl.ascx.cs.

5. Change namespace of RSUGHelloSharePoint2010UserControl class to RSUGVisualWebPart01.








6. Open RSUGHelloSharePoint2010UserControl.ascx file.

7. Change Inherits attribute value to RSUGVisualWebPart01.RSUGHelloSharePoint2010UserCon trol.








8. Open SharePointProjectItem.spdata file.

9. Change Namespace attribute value to RSUGVisualWebPart01.








Change web part control location

1. Open Elements.xml file.

2. Change Value attribute of Group property value to RSUG.








3. Open RSUGHelloSharePoint2010.cs file.

4. Change value of _ascxPath variable to @"~/_CONTROLTEMPLATES/RSUG/RSUGHelloSharePoint2010UserControl.ascx".








5. Open SharePointProjectItem.spdata file and change value of Target attribute to CONTROLTEMPLATES\RSUG\.








Add public property

1. Open RSUGHelloSharePoint2010UserControl.ascx file and add the following code to end of the file:




2. Open RSUGHelloSharePoint2010UserControl.ascx.cs file and add the following code:




3. Open RSUGHelloSharePoint2010.cs file and add MyHello public property as following:




4. Update CreateChildControls method code to be as following:




Visual web part localization

1. Add mapping to resources folder.






2. Add resource file “rsugvisualwebpart01.ar-sa.resx”.












3. Open Elements.xml file and change value of Value property as following:




4. Open RSUGHelloSharePoint2010.webpart file and change Title property value as following:




5. Take copy from rsugvisualwebpart01.ar-sa.resx file rename it to rsugvisualwebpart01.en-us.resx.








Deployment and Usage





1. Create web part page and press “Add web part” on one of web part zones.












الخميس، 21 يوليو 2011

كيف تمنع جزء من النص من الظهور في نتائج بحث شيربوينت 2010


في جميع المشاريع التي تعتمد على شيربوينت 2010 كمنصة عمل لا بد أنها ستحتوي على محرك بحث ضمن محتوى البوابة أو الموقع, مع إمكانيات البحث الأخرى التي يوفرها شيربوينت 2010 SharePoint, لكن يجب ضبط إعدادات محرك البحث على شيربوينت 2010 بشكل صحيح لتحقيق أفضل نتائج ضمن البحث. ومن المشاكل التي قد تواجه عملية البحث هي إظهار نتائج قد يظن البعض بأنها غير مرتبطة مباشرة بالصفحة التي ظهرت فيها, وطبعاً لا يمكن أن يحصل هذا الأمر فنتائج البحث التي يُظهرها شيربوينت 2010 دقيقة جداً, لكن هناك عدة عوامل لعدم تطابق نتائج البحث مع الرابط الذي يعرضه شيربوينت ومنها:
  • عدم تحديث فهرس محرك بحث شيربوينت 2010 بعد إجراء التعديلات الأخيرة. حيث من الممكن أن شيربوينت قد نفذ عملية فهرسة لبعض البيانات التي تم تحديثها أو حذفها ولم يتم تحديث فهرس شيربوينت, لذلك قد تظهر في نتائج البحث.
  • في بعض الأحيان تتكرر بعض النصوص في كل صفحة من صفحات الموقع, وهذا يعني أن أي كلمة ضمن هذه النصوص ستظهر في نتائج البحث لجميع الصفحات, وكمثال على ذلك القوائم العلوية وتذييل الصفحة Page Footer وغيرها من النصوص التي تظهر في كل صفحة من صفحات الموقع, مثال لو كانت القائمة العلوية تحتوي على النص "مركز التدريب" وهو رابط إلى موقع مركز التدريب, عند البحث عن الكلمة التدريب ستظهر صفحات قد يُعتقد بأن لا علاقة لها بنتائج البحث ولكن الحقيقة أن النص في القائمة العلوية هو المعني بهذه المشكلة, ولحل هذه المشكلة يجب منع محرك البحث في شيربوينت 2010 من فهرسة بعض النصوص التي تتكرر كما سبق, ولتحقيق ذلك يجب إحاطة النصوص التي لا ترغب في فهرستها ضمن الوسم <div class=”noindex”></div> عندها سيتجاهل محرك البحث النصوص الموجودة ضمن هذا الوسم. كما في المثال التالي:

<div class=”noindex”>نص لن يظهر في نتائج البحث</div>


بعد تحديث معلومات محرك البحث لن يظهر النص السابق ضمن نتائج البحث.

إصدار أول كتاب عربي عن شيربوينت 2010



تم إصدار النسخة الأولى من كتاب تعلم شيربوينت 2010 باللغة العربية ولأول مرة, حيث تفتخر دار شعاع بأنه أول من أصدر كتاب باللغة العربية حول شيربوينت 2010 بالتعاون مع المهندس إسماعيل عنجريني





الجمعة، 15 يوليو 2011

تثبيت حزمة الإصلاح الكاملة 1 لشيربوينت 2010


مقدمة
بعد سلسلة من حزم الإصلاح لشيربوينت 2010 أصدرتها مايكروسوفت وتُسمى Hotfixes أو Cumulative Updates, أصدرت مايكروسوفت مؤخراً حزمة الإصلاح الأولى Service Pack 1 for SharePoint 2010 والتي تتضمن جميع حزم الإصلاح المتفرقة السابقة إضافة إلى مجموعة من الميزات الجديدة التي سترافق هذه الحزمة, ويُعتبر تطبيقها على بيئة العمل الحقيقية ضرورة يجب عدم التهاون فيها لما تحتويه من تحسينات على عمل شيربوينت 2010 سواء من ناحية الأداء أو من ناحية الأمان أو فيما يتعلق بميزات شيربوينت وخدماته.

الحصول على حزمة الإصلاح الكاملة لشيربوينت 2010 Service Pack 1 for SharePoint Server 2010

تتضمن حزمة الإصلاح الكاملة Service Pack 1 for SharePoint Servcer 2010 عدة ملفات يجب أن يتم أخذها بعين الاعتبار أثناء عملية تحميل هذه الحزمة على بيئة عمل شيربوينت 2010.
حزمة الإصلاح الكاملة Service Pack 1 for SharePoint Foundation 2010 على الرابط التالي:

حزمة الإصلاح الكاملة للغة العربيةMicrosoft SharePoint Foundation 2010 Language Pack Service Pack 1 على الرابط التالي:
حزمة الإصلاح الكاملة Service Pack 1 for SharePoint Server 2010 على الرابط التالي:
حزمة الإصلاح الكاملة للغة العربية Service Pack 1 for Server Language Pack 2010 على الرابط التالي:
Service Pack 1 for Microsoft Office Web Apps 2010
حزمة الإصلاح Cumulative Update June 2011
http://support.microsoft.com/kb/2536599


كيفية تحميل حزمة الإصلاح الكاملة على بيئة عمل شيربوينت 2010
يجب الالتزام بالترتيب المذكور في وثائق مايكروسوفت حول حزمة الإصلاح الكاملة وهي كما يلي:
  1. Service Pack 1 for SharePoint Foundation 2010.
  2. Microsoft SharePoint Foundation 2010 Language Pack Service Pack 1.
  3. Service Pack 1 for SharePoint Server 2010.
  4. Service Pack 1 for Server Language Pack 2010.
  5. Service Pack1 for Office Web Applications (عند وجود حزمة Office Web Application على مزرعة شيربوينت 2010 الحالية).
  6. June 2011 Cumulative Updates.
ملاحظة: في حال أن بيئة عمل شيربوينت 2010 الحالية هي SharePoint Server 2010 فيجب البدء من الخطوة رقم 3.


الخطوات المفضلة لتنفيذ عملية تحميل حزمة الإصلاح الكاملة Service Pack 1 for SharePoint Server 2010 Steps
  1. وضع جميع الملفات الثنائية لحزم الإصلاح المذكورة سابقاً على جميع الخوادم ضمن مزرعة شيربوينت 2010 SharePoint Server 2010 Farm.
  2. تحويل جميع قواعد بيانات المحتوى تطبيقات الويب Content Databases إلى نمط القراءة فقط Read Only وذلك لمنع أي عملية تغيير قد تحصل على بيانات تطبيقات الويب أثناء تنفيذ خطوات تحميل حزمة الإصلاح الكاملة لشيربوينت 2010.
  3. تنفيذ عملية نسخ احتياطي لجميع قواعد البيانات الخاصة ببيئة عمل شيربوينت بما فيها قواعد البيانات الخاصة بموقع الإدارة المركزية Central Administration وقاعدة بيانات إعدادات بيئة عمل شيربوينت 2010 Configuration Database , وبالطبع قواعد بيانات المحتوى Content Databases.
  4. تنفيذ عملية نسخ لجميع الملفات الموجودة تحت المسار c:\inetpub\wwwroot\wss\VirtualDirectories.
  5. منع أي طلب من الوصول إلى خوادم مزرعة شيربوينت 2010 SharePoint 2010 Farm.
  6. البدء بتشغيل الملفات الثنائية لحزم الإصلاح الكاملة حسب الترتيب السابق. ويمكن تشغيل هذه الملفات على جميع الخوادم ضمن مزرعة شيربوينت 2010 بنفس الوقت لأن تأثير هذه العملية لا يتم تنفيذه إلى بعد تشغيل SharePoint Configuration Wizard.
  7. التأكد من انتهاء تحميل جميع الحزم الكاملة على جميع الخوادم, يجب تشغيل الأداة SharePoint 2010 Configuration Wizard على الخادم الذي يعمل عليه موقع الإدارة المركزية Central Administration.
  8. ستبدأ عملية تطبيق حزم الإصلاح بشكل فعلي الآن ولا يمكن التراجع عن هذه الخطوة, وفي حال حدوث أي خطأ أثناء هذه العملية يجب معرفته والعمل على حله بشكل صحيح ومن ثم إعادة تشغيل SharePoint 2010 Configuration Wizard على الخادم الذي يعمل عليه موقع الإدارة المركزية Central Administration.
  9. بعد الانتهاء من الخطوة رقم 8 بنجاح ابدأ بتشغيل SharePoint 2010 Configuration Wizard على باقي الخوادم بشكل متسلسل وتأكد من حل جميع المشاكل والأخطاء التي قد تحدث أثناء هذه العملية. علماً أن نجاح هذه العملية على أحد الخوادم إشارة جيدة إلى أنها ستنجح بنسبة 98% على باقي الخوادم.
  10. بعد الانتهاء من تنفيذ SharePoint 2010 Configuration Wizard على جميع الخوادم بشكل ناجح, يجب الآن الانتقال إلى موقع الإدارة المركزية Central Administration والتأكد من أن جميع الخدمات السابقة تعمل بشكل صحيح.

ملاحظة: يجب على مدير مزرعة شيربوينت 2010 SharePoint 2010 Farm التأكد من تحميل جميع حزم الإصلاح المتعلقة بجميع الخدمات المتوفرة على بيئة العمل مثل Project Server 2010 و TFS 2010 وغيرها والتي لم يتم التطرق إليها أعلاه.


تحديث بتاريخ 17-07-2011
يجب إعادة تثبيت June 2011 Hotfix على بيئة عمل شيربوينت 2010 في حال أنه تم تثبيت النسبخة June Hotfix قبل 08-07-2011 وذلك بسبب وجود بعض المشاكل التي ظهرت نتيئجة النسبة القديمة, ويمكن تحميلها من الرباط التالي


الاثنين، 11 يوليو 2011

كيف تستخدم الأداة SPDisposeCheck

الهدف من الأداة SPDisposeCheck
تُستخدم هذه الأداة للتأكد من أن الشيفرة المكتوبة في المجمعات Assemblies لا تحتوي على ما سيسبب مشاكل غير متوقعة في ذاكرة الخادم التي تعمل عليها التطبيقات أو ما يسمى بـ Memory Leaks.

متى يجب استخدام هذه الأداة
يجب استخدام هذه الأداة من قبل المطورين الذين يستخدمون واجهة برمجة التطبيقات API دائماً قبل إطلاق العمل للمستخدم النهائي وذلك لتجنب أي مشكلة في ذاكرة الخادم Server RAM.

كيف يتم استخدام هذه الأداة
1 - يفضل دائماً قبل استخدام هذه الأداة الحصول على الإصدار الأخير منها على الرابط التالي:


2 - الأداء هي عبارة عن ملف تنفيذي EXE File يجب تنفيذه ليتم تركيب الأداة على جهازك.










3 - بعد الانتهاء من الخطوات السابقة (يمكن تجاوز الخطوة رقم 2 في حال أن الأداة موجودة مسبقاً على جهازك), نفذ الآن الخطوات التالية لتنفيذ عملية اختبار المجمعة Assembly التي تستخدم واجهة برمجة التطبيقات لشيربوينت SharePoint API:

- افتح منفذ الأوامر Command Line ونفذ الأمر التالي:

cd C:\Program Files (x86)\Microsoft\SharePoint Dispose Check


ملاحظة: المسار الذي تم وضعه في الأمر السابق قد يتغير حسب المستخدم أو يمكن أن تغييره أثناء عملية تركيب الأداة على جهازك.

- الآن نفذ الأمر التالي لفحص الشيفرة في إحدى المجمعات Assembly كما يلي:

SPDisposeCheck.exe DLL_PATH >> c:\disposeReport.txt

علماً أن DLL_PATH هو المسار الكامل للمجمعة على جهازك. أما بالنسبة للمسار c:\disposeReport.txt فهو اختياري ولكن يفضل استخدام هذه الطريقة لكي يتم تخزين جميع نتائج الاختبار في ملف نصي بدلاً من عرضه على الشاشة.

- بعد الانتهاء من تنفيذ الأمر السابق افتح الملف النصي الذي تم تحديده في الأمر السابق. حيث سيحتوي هذا الملف على جميع الملاحظات إضافة إلى العدد الإجمالي لهذه الملاحظات.

4 - جميع الملاحظات التي تكون نتيجة استخدام هذه الأداة تتعلق باستخدام التابع Dispose أو العبارة using عند الوصول إلى كائن Object باستخدام واجهة برمجة التطبيقات SharePoint API, إضافة إلى ذلك فليس بالضرورة أن جميع الملاحظات التي ستظهر يجب حلها وذلك بناء على الوثائق التي تتحدث عن هذه الأداة, لذلك يجب عدم التعديل على الشيفرة المتعلقة بالشيربوينت قبل التأكد منها.