الأحد، 29 نوفمبر، 2009

كيف تلغي استخدام النماذج المطورة في إدارة عناصر القائمة الخاصة

  1. كيف تنشئ قائمة مخصصة في SharePoint Server 2010
  2. كيف تلغي استخدام النماذج المطورة في إدارة عناصر القائمة الخاصة
  3. إضافة عنصر جديد برمجياً غلى قائمة مخصصة في SharePoint Server 2010

في الإصدار SharePoint Server 2010 تم إدخال ميزة النماذج المطورة التي تعتمد على JavaScript لإظهارها في محاولة من شركة Microsoft لتحسين وتسريع عملية التعامل مع نماذج القوائم وبعض النماذج الأخرى وكذلك اعتمدت شركة Microsoft في بعض النماذج على تقنية Silverlight كما في شاشات إنشاء موقع أو قائمة جديدة. ومن أجل إلغاء استخدام النماذج المطورة في القائمة المخصصة يمكن اتباع الخطوات التالية لاستخدام النماذج التقليدية المستخدمة في MOSS 2007.
من القوائم العلوية اختر الرابط List لعرض روابط الإعدادات الخاصة بالقائمة المخصصة كما في الشكل التالي:

ومن ثم اختر الرابط List Settings كما في الشكل التالي:

لتظهر صفحة الإعدادات الخاصة بالقائمة والتي تحتوي على الكثير من الخيارات ولكن الخيار الذي يهمنا هو Advanced Settings كما في الشكل التالي:


عند الضغط على رابط الإعدادات المتقدمة Advanced Settings تظهر صفحة تحتوي على مجموعة من الخيارات المتقدمة المتعلقة بالقائمة وآخر خيار هو الذي يفعل أو يعطل استخدام النماذج المطورة في إدارة عناصر القائمة:


حدد القيمة No ثم اضغط الزر OK وبعدها اذهب إلى صفحة عرض عناصر القائمة وحاول إضافة عنصر جديد أو الضغط على عنصر موجود مسبقاً ستلاحظ عدم ظهور النموذج المطور وإنما سيظهر النموذج العادي.

السبت، 28 نوفمبر، 2009

إضافة عنصر جديد برمجياً غلى قائمة مخصصة في SharePoint Server 2010

  1. كيف تنشئ قائمة مخصصة في SharePoint Server 2010
  2. كيف تلغي استخدام النماذج المطورة في إدارة عناصر القائمة الخاصة
  3. إضافة عنصر جديد برمجياً غلى قائمة مخصصة في SharePoint Server 2010


من التحسينات الملحوظة في SharePoint Server 2010 هي التعامل مع عناصر القوائم ومنها إضافة عناصر جديدة إلى قائمة, وفي هذه المقالة سنركز على كيفية إضافة عنصر جديد برمجياً إلى القائمة المخصصة التي أنشأناها في مقالة سابقة بعنوان كيف تنشئ قائمة مخصصة في SharePoint Server 2010 واسم القائمة هو Names, وكلن قبل الدخول في تفاصيل الشيفرة البرمجية أرغب في استعراض كيفية إضافة عنصر جديد إلى القائمة باستخدام شاشات SharePoint Server 2010.

هذه الخطوات تم تنفيذها ضمن الشروط التالية:

  • Windows 7 64bit.
  • SharePoint Server 2010 Beta Version.

من صفحة استعراض جميع عناصر القائمة اضغط على الرابط Add new item كما في الشكل التالي لفتح نافذة جديدة إضافة معلومات العنصر الجديد:

أو من خلال الضغط على الرابط Items في قائمة الروابط العلوية للصفحة وبعدها اضغط على الرابط New Item كما في الشكل التالي:

من خلال اتباع إحدى الخطوات السابقة تظهر شاشة مشابة للشكل التالي تتيح إضافة معلومات العنصر الجديد:

بعد تعبئة المعلومات اللازمة اضغط على زر Save لحفظ معلومات العنصر الجديد, بعدها يتم إغلاق شاشة إضافة عنصر مع تحديث صفحة عرض جميع عناصر القائمة لعرض العنصر الجديد الذي تمت إضافته إلى عناصر القائمة.

كما يمكن إضافة عنصر جديد إلى عناصر القائمة باستخدام الطريقة المستخدمة في MOSS 2007 وذلك بكتابة العنوان التالي في المتصفح:

http://YOUR_SERVER_NAME/Lists/Names/NewForm.aspx

الخطوات السابقة كانت لإضافة عنصر جديد إلى قائمة باستخدام الميزات التي تقدمها شاشات SharePoint Server 2010.

إنشاء مشروع جديد باستخدام Visual Studio 2010

يدعم VS 2010 مجموعة قوالب مرتبطة مباشرة بالـ SharePoint بحيث تسهل عملية إضافة وتحميل عناصر جديدة تعمل على SharePoint Server 2010 ومن هذه القوالب Visual Web Part الذي يساعد على تصميم جزء ويب Web Part وتحميله ليعمل على تطبيق الويب الخاص بك. الآن يجب إنشاء مشروع باستخدام القالب Visual Web Part:

File -> New Project -> Visual C# -> SharePoint -> Visual Web Part

وليكن اسم المشروع هو CustomList2010Developer ومن ثم اضغط على الزر OK عندها تظهر شاشة تستطيع من خلالها أين سيتم تحميل جزء الويب الذي سنعمل عل برمجته, بعد تحديد عنوان الموقع المناسب اضغط زر Finish.

بعد إنشاء المشروع بنجاح افتح الملف VisualWebPart1.webpart وعدل عنوان جزء الويب Title ووصف جزء الويب Description.

الآن افتح الملف VisualWebPart1UserControl.ascx لبناء النموذج Form الذي سندخل من خلال معلومات العنصر الجديد (FirstName, FamilyName, Email), وهنا طبعاً الشيفرة التي ستتم كتابتها لا علاقة لها بالـ SharePoint Server 2010 وإنما هي شيفرة ASP.NET كما في الشكل التالي:

يحتوي النموذج على 3 حقول نصية لإدخال المعلومات التالية بالترتيب:

  • الاسم الأول FirstName.
  • اسم العائلة FamilyName.
  • البريد الإلكتروني Email.

مع وجود زرين الأول لإضافة المعلومات باستخدام الـ Object Model والثاني باستخدام Linq, والشيفرة التي يجب كتابتها في الحدث Click للزر Add By Object Model هي كما في الشكل التالي:

أما من أجل التعامل مع القائمة Names باستخدام Linq يجب اتباع الخطوات التالية لتوليد الملف الذي من خلاله سيتم التعامل مع القائمة Names:

1 - افتح منفذ الأوامر Command Prompt وأدخل الأمر التالي:

cd c:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\bin

2 - اكتب الأمر التالي الذي يولد الملف:

spmetal /web:http://YOU_SERVER_NAME /namespace:CustomList2010Developer /code:c:\NamesList.cs

بعد توليد الملف NamesList.cs أضف هذا الملف إلى المشروع وذلك بالنقر بزر الفأرة الأيمن على اسم المشروع واختر Add Existing Itme.

يجب إضافة مرجع Reference إلى المكتبة Microsoft.SharePoint.Linq كي نستطيع التعامل مع عناصر الـ SharePoint Server 2010 باستخدام Linq وهذه المكتبة موجودة في المسار التالي:

c:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI

أيضاً يجب إضافة العبارة التالية إلى ملف الشيفرة VisualWebPartUserControl.ascx.cs لتفعيل استخدام الـ Linq:

using System.Linq;

وأخيراً الشيفرة التي ستضيف العنصر الجديد باستخدام الـ Linq إلى القائمة Names هي كما في الشكل التالي:

نفذ عملية بناء المشروع من خلال القائمة Buil à Build Solution, ومن ثم نفذ الأمر Deploy Solution من القائمة Build à Deploy Solution.

أنشئ صفحة أجزاء ويب فارغة وأضف إليها جزء الويب الذي تم بناؤه وفي حال اتباع نفس الخطوات التي تم ذكرها في هذه المقالة عندها يجب أن يكون شكل جزء الويب الناتج كما في الشكل التالي:

الجمعة، 27 نوفمبر، 2009

كيف تنشئ قائمة مخصصة في SharePoint Server 2010

  1. كيف تنشئ قائمة مخصصة في SharePoint Server 2010
  2. كيف تلغي استخدام النماذج المطورة في إدارة عناصر القائمة الخاصة
  3. إضافة عنصر جديد برمجياً غلى قائمة مخصصة في SharePoint Server 2010

لا شك بأن الإصدار الجديد من SharePoint Server 2010 يحتوي على كثير من الميزات الجديدة ولكنه حافظ أيضاً على المزايا القديمة مع إجراء تحسينات هائلة عليها, وسنستعرض فيما يلي كيفية إنشاء قائمة من القالب "قائمة مخصصة" Custom List موضحة بالصور, وهذه الخطوات تم تنفيذها ضمن الشروط التالية:
  • Windows 7 64 Bit
  • SharePoint Server 2010 Beta

في هذه المقالة سنعمل على بناء قائمة تضم المعلومات التالية:

  • الاسم الأول FirstName
  • اسم العائلة FamilyName
  • عنوان البريد الإلكتروني Email

لإنشاء قائمة يمكن تنفيذ ذلك من أماكن مختلفة كما يلي:

  1. من القائمة Site Actions اختر More Options… حيث تظهر شاشة كما في الشكل التالي ومنها يمكن اختيار القالب Custom List وبعدها تكمل خطوات إنشاء القائمة.

  2. من القائمة Site Actions اختر View All Site Content ومن ثم اضغط على الرابط Create لتظهر شاشة مشابة للشاشة في الخطوة رقم 1 ومنها يمكن اختيار القالب Custom List وبعدها تكمل خطوات إنشاء القائمة.

  3. اضغط على الرابط Lists في الجهة اليسرى ومن ثم اضغط على الرابط Create لتظهر شاشة مشابة للشاشة في الخطوة رقم 1 ومنها يمكن اختيار القالب Custom List وبعدها تكمل خطوات إنشاء القائمة.

نلاحظ أن جميع الخطوات السابقة تؤدي إلى نفس النتيجة وهي إنشاء قائمة من القالب Custom List وطبعاً وجود عدة طرق للوصول إلى شاشة إنشاء القائمة يسهل على المستخدم هذه العملية, أيضاً هناك ملاحظة هامة يجب الانتباه إليها وهو أنه عند الضغط على الرابط Create لا ينتقل التحكم إلى صفحة أخرى جديدة وإنما تظهر نافذة منبثقة Pop up Window وتعتبر هذه من التحسينات على شاشات SharePoint Server 2010 والتي تسهل وتسرع عملية الاستخدام والإدارة. كما أن هذه النافذة هي عبارة عن عنصر Silverlight لذلك نلاحظ وجود إبداع في الشكل وطريقة إظهار عناصر الشاشة وذلك باستخدام تنقية Silverlight ولكن ما يحيرني بأن Silverlight حتى تاريخ كتابة هذه المقالة لا يدعم اللغة العربية بشكل صحيح وبعض اللغات الأخرى فلا بد من أن شركة Microsoft ستدعم باقي اللغات بشكل صحيح 100% في الإصدار النهائي لـ SharePoint Server 2010 أو أنها يتقدم حلاً بديلاً لمثل هذه الشاشات كفتح صفحة جديدة في حال أن اللغة المستخدم غير مدعومة (وطبعاً هذا غير منطقي وأشك بأن شركة Microsoft ستقع في مثل هذا الخطأ). ولكن مازال النمط القديم لإنشاء صفحة أو قائمة أو موقع كما في الإصدار MOSS 2007 متوفر وذلك من خلال الرابط http://YOUR_SERVER_NAME/_layouts/create.aspx حيث تظهر الخيارات المتوفرة لإنشاء عنصر ما ومنه يمكن اختيار Custom List لتظهر شاشة لا تعتمد على تقنية Silverlight.

لإكمال عملية إنشاء القائمة اضغط على List في الجهة اليسرى لإظهار القوالب الخاصة بالقوائم فقط ومن ثم اختر القالب Custom List كما في الشكل التالي:

بعد اختيار القالب Custom List يمكن إدخال اسم القائمة في الجهة اليمنى من الشاشة في الحقل النصي Name ومن ثم الضغط على الزر Create لإنشاء القائمة أو يمكن اختيار الزر More Options حيث تفتح شاشة فيها خيارات أكثر لإنشاء القائمة (الاسم, الوصف, وهل تظهر القائمة في قائمة التشغيل السريع Quick Launch) كما في الشاشة التالية:

بعد إدخال معلومات القائمة كما هو موضح في الشكل السابق اضغط الزر Create أسفل الصفحة لإنشاء القائمة الجديدة. بعد إنشاء القائمة الجديدة بشكل ناجح تظهر صفحة تعرض عناصر القائمة الجديدة مع خيار لإضافة عنصر جديد كما هو مبين في الشكل التالي:

كما ذكرنا سابقاً يجب إضافة أعمدة أخرى إلى القائمة (FirstName, FamilyName, Email) ولتنفيذ ذلك اتبع الخطوات التالية:

  1. لإنشاء العمود FamilyName اضغط على الرابط Create Column في قائمة الروابط أعلى الصفحة (إظهار الروابط بهذا الشكل هو إحدى الميزات الجديدة في SharePoint Server 2010 ويسمى Ribbon وقد استخدم في Office 2007 قبل ذلك) بعد الضغط على Create Column تظهر شاشة منبثقة Pop up Window كما في الشكل التالي:


    تتيح اختيار أنواع مختلفة من الأعمدة (هذه الشاشة لا تعتمد على تقنية Silverlight) أدخل معلومات العمود الجديد وهي:
    • اسم العمود: FamilyName
    • نوع العمود: Single line of text
    • وصف العمود: Family name
    • هل قيمة هذا العمود مطلوبة: Yes
    • عدم تكرار هذه القيمة: No
    • الطول الأعظمي لقيمة هذا العمود: 15
    • باقي القيم اتركها كما هي.
    • بعد إدخال المعلومات المطلوبة اضغط على الزر OK لإنشاء العمود.
  2. لإنشاء العمود Email اضغط على الرابط Create Column في قائمة الروابط أعلى الصفحة بعد الضغط على Create Column تظهر شاشة منبثقة Pop up Window تتيح اختيار أنواع مختلفة من الأعمدة (هذه الشاشة لا تعتمد على تقنية Silverlight) أدخل معلومات العمود الجديد وهي:
    • اسم العمود: Email
    • نوع العمود: Single line of text
    • وصف العمود: Email address
    • هل قيمة هذا العمود مطلوبة: Yes
    • عدم تكرار هذه القيمة: Yes
    • الطول الأعظمي لقيمة هذا العمود: 50
    • في الجزء Column Validation وهي من الميزات الجديدة في SharePoint Server 2010 حيث تمكنك من كتابة صيغة للتحقق من صحة المعلومات المدخلة مع إمكانية إدخال رسالة تظهر في حال أن المعلومات المدخلة غير صحيحة, المهم في هذا الجزء أدخل المعلومات التالية:
      • في الحقل Formula اكتب =LEN(Email) >= 5 وتعني بأن طول عنوان البريد الإلكتروني لا يمكن أن يكون أقل من 5 محارف.
      • في الحقل User Message اكتب Email length must be 5 letters at least.
    • باقي القيم اتركها كما هي.
    • بعد إدخال المعلومات المطلوبة اضغط على الزر OK لإنشاء العمود.
  3. لإنشاء العمود FirstName سنعدل على العمود Title الموجود أصلاً وذلك بالضغط على الرابط List Settings في قائمة الروابط أعلى الصفحة حيث تفتح صفحة إعدادات القائمة وهي مشابهة لصفحة إعدادات القائمة في الإصدار Microsoft Office SharePoint Server 2007:


    الآن اضغط على اسم العمود Title لتفتح صفحة جديدة تمكنك من تعديل معلومات هذا العمود كما يلي:

    • اسم العمود: FirstName
    • وصف العمود: First name
    • الطول الأعظمي لقيمة هذا العمود: 15
    • باقي القيم اتركها كما هي.
    • بعد إدخال المعلومات المطلوبة اضغط على الزر OK لإنشاء العمود.

بعد تنفيذ الخطوات السابقة نكون قد أتممنا عملية إنشاء قائمة جديدة اسمها Names تحتوي على 3 أعمدة (FirstName, FamilyName, Email) ويمكن الآن تجربة إضافة عنصر جديد في هذه القائمة.