الأحد، 31 يناير 2010

إعدادات خدمة الرقم الفريد للمستندات Document ID Settings




بعد تفعيل ميزة الرقم الفريد للمستندات يظهر رابط جديد تحت القسم "إدارة مجموعة الموقع Site Collection Administration" وهذا الرابط هو "إعدقادات الرقم الفريد للمستندات Document ID settings":


ومن خلال هذا الرابط يمكن ضبط بعض الإعدادات التي تؤثر في عمل ميزة الرقم الفريد للمستندات وهي مبينة في الشكل التالي:


ومن خلال هذه الشاشة يمكن ضبط أربعة إعدادات تؤثر في عمل هذه الميزة وهي كما يلي:
  • تعيين رقم فريد للمستندات Assign Document Ids, حيث يحدد هذا الخيار هل سيتم إسناد رقم فريد للمستندات الجديدة أم لا.
  • الأحرف التي يجب أن يبدأ بها الرقم الفريد للمستند, وهي عبارة عن أحرف وأرقام يجب ألا يقل طولها عن 4 ولا يتجاوز 12 حرف ومثال على ذلك:


    حيث نلاحظ من الشكل السابق كيف أن الرقم الفريد للمستند يبدأ بالكلمة ISMAEEL.
  • الخيار "إعادة تعيين الأرقام الفريدة للمستندات لتبدأ بالأحرف الجديدة Reset all Document IDs in this Site Collection to begin with these characters", عند تعيين هذا الخيار فإن جميع أرقام المستندات سيعاد ضبطها بحيث تبدأ بالأحرف الجديدة التي تم تعيينها, وهنا يجدر الانتباه إلى أنه في حال إعادة تعيين أرقام المستندات لتبدأ بأحرف جديدة فإن الروابط التي تم استخدامها مسبقاً لتشير إلى هذه المستندات ستصبح غير صحيحة مما يؤدي إلى ظهور روابط مفقودة Broken Links لذلك يجب الانتباه عند استخدام هذا الخيار.
  • أما الخيار الأخير "Use this search scope for ID lookup", فيمكنك تحديد اسم المجال الذي يمكن من خلاله البحث باستخدام أرقام المستندات الفريدة Document ID.

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


هناك طريقة يمكن استخدامها لتسريع عملية تطبيق الإعدادات الجديدة وهي بتنفيذ المهمة المجدولة التي تطبق الإعدادات بشكل يدوي وذلك باتباع الخطوات التالية:
  1. افتح موقع الإدارة المركزي Central Administration Web Site من قائمة البرامج بعدها افتح Microsoft SharePoint 2010 Products ومن ثم اضغط على الرابط SharePoint 2010 Central Administration.
  2. اختر الأمر Monitoring من القائمة اليسرى.
  3. اختر الأمر Review job definitions.
  4. ابحث عن الأمر Document ID enable/disable job.
  5. اضغط على الزر Run Now لتنفيذ المهمة الجدولة.
  6. من ثم ابحث عن الأمر Document ID assignment job.
  7. اضغط على الزر Run Now.
  8. الآن افتح صفحة إعدادات الرقم الفريد للمستندات Document ID Settings وستلاحظ بأن الرسالة التي باللون الأحمر قد اختفت.

ملاحظة: من الأفضل إعادة جدولة المهمتين السابقتين بحيث يتم تنفيذهما خلال دقائق في حال أنك تتعامل مع إعدادات الرقم الفريد للمستندات بشكل متكرر.


الجمعة، 29 يناير 2010

تأثير تفعيل الميزة DocId في SharePoint 2010





عند تفعيل الميزة DocId على مجموعة الموقع Site Collection يتم إضافة ثلاثة أعمدة إلى نوع المحتوى "مستند Document" والمحتوى "مجموعة مستند Document Set" والأعمدة الثلاثة التالية:
  • Document ID Value: يخزن هذا العمود قيمة الرقم الفريد للمستند, والاسم الداخلي لهذا العمود أي الاسم البرمجي له هو _dlc_DocId, ونوعه هو حقل نصي مفرد Single line of text.
  • Document ID: يخزن هذا العمود رابط الذي يشير إلى المستند, والاسم الداخلي لهذا العمود أي الاسم البرمجي له هو _dlc_DocIdUrl, ونوعه رابط تشعبي أو صورة Hyperlink or Picture.
  • Persist ID: يخزن هذا العمود القيمة نعم أو لا, والاسم الداخلي لهذا العمود أي الاسم البرمجي له هو _dlc_DocIdPersistId, ونوعه حقل نعم/لا Yes/No.
وفي حال إلغاء تفعيل هذه الميزة فإن هذه الأعمدة تبقى موجودة في نوع المحتوى "مستند Document" والمحتوى "مجموعة مستند Document Set".

إضافة إلى هذه الأعمدة فإن SharePoint Foundation يضيف مستقبلات أحداث لبعض الأحداث المتعلقة بإضافة وتعديل المستندات, وذلك لضمان تعيين رقم المستند الفريد عند إضافة مستند جديد.


الاثنين، 25 يناير 2010

تشغيل الميزة DocId باستخدام سطر الأوامر Power Shell




سطر الأوامر Power Shell من إحدى الميزات الجديدة في SharePoint 2010 Beta, وفيما يلي سنشرح كيفية تشغيل الميزة DocId باستخدام سطر الأوامر Power Shell بالتفصيل باتباع الخطوات التالية:
  1. افتح سطر الأوامر Power Shell من أجل تنصيب الميزة DocId على المزرعة الحالية Current Farm اكتب السطر التالي واضغط Enter:
    Install-SPFeature DocId

    في الخطوة السابقة قد تظهر الرسالة التالية لتشير بأن هذه الميزة موجودة مسبقاً في هذه المزرعة:

    Install-SPFeature : A feature with ID b50e3104-6812-424f-a011-cc90e6327318 has
    already been installed in this farm. Use the force attribute to explicitly re-
    install the feature.
    At line:1 char:18
    + Install-SPFeature <<<< DocId
    + CategoryInfo: InvalidData: (Microsoft.Share...tInstallFeature:
    SPCmdletInstallFeature) [Install-SPFeature], InvalidOperationException
    + FullyQualifiedErrorId : Microsoft.SharePoint.PowerShell.SPCmdletInstallFeature

    ملاحظة: للتأكد من أن الميزة DocId قد تم تحميلها مسبقاً يمكن اختيار الأمر Site collection features من صفحة إعدادات الموقع الجذر Root web لتطبيق الويب Web Application الذي نعمل عليها:


    وفي حال أن الميزة DocId موجودة مسبقاً يجب أن تشاهد اسمها كما يلي Document ID Service:


  2. بعد التأكد من تحميل الميزة DocId على المزرعة الحالية SharePoint Farm يجب الآن تفعيل هذه الميزة بحيث يمكن استخدامها في مكتبة المستندات, ولتنفيذ ذلك اكتب السطر التالي بعد تنفيذ الخطوة رقم 2 واضغط Enter:
    Enable-SPFeature DocId -Url http://WEB_APP_URL

    ملاحظة: عند محاولة تفعيل الميزة DocId على موقع فرعي Sub Site سيظهر خطأ يعلمك بأن هذه الميزة يتم تفعيلها على مستوى مجموعة الموقع فقط Site Collection.

    ملاحظة: الحالة الافتراضية للميزة DocId هي "غير مفعلة" ويمكن تفعيلها إما باستخدام سطر الأوامر أو يمكن تنفيذها من خلال صفحة ميزات مجموعة الموقع Site Collection Features:


    ملاحظة: في حال محاولة تفعيل الميزة DocId من خلال سطر الأوامر Power Shell وحالتها هي Active عندها ستظهر رسالة الخطأ التالية التي تشير بأن هذه الميزة تم تفعيلها مسبقاً:

    Enable-SPFeature : Feature 'DocId' (ID: b50e3104-6812-424f-a011-cc90e6327318) is already activated at scope 'http://WEB_APP'.
    At line:1 char:17
    + Enable-SPFeature <<<< DocId -Url http://ismaeelenjreny
    + CategoryInfo: InvalidData: (Microsoft.Share...etEnableFeature:
    SPCmdletEnableFeature) [Enable-SPFeature], DuplicateNameException
    + FullyQualifiedErrorId : Microsoft.SharePoint.PowerShell.SPCmdletEnableFeature

    ملاحظة: في حال أن الميزة DocId مفعلة مسبقاً عندها سترى في صفحة ميزات مجموعة الموقع Site Collection Features الشكل التالي بجانب الاسم Document ID Service:


ملاحظة: بعد تنفيذ جميع الخطوات السابقة تكون الميزة DocId قد تم تفعيلها على مجموعة الموقع ولكن هناك بعض الإعدادات الأخرى التي تؤثر على عمل هذه الميزة سيتم شرحها لاحقاً.

تشغيل الميزة DocId باستخدام سطر الأوامر stsadm




سوف نشرح فيما يلي كيفية تحميل وتفعيل الميزة DocId وهو اسم ميزة الرقم الفريد للمستندات Document ID Feature بغض النظر عن الحالة الافتراضية لهذه الميزة حيث سنفترض أنها غير محملة على مجموعة الموقع Site Collection.

تشغيل الميزة DocId باستخدام سطر الأوامر stsadm
سطر الأوامر stsadm مازال موجوداً في SharePoint 2010 Beta مع العلم أن شركة مايكروسوفت توصي بعدم استخدامه وإنما استخدام سطر الأوامر Power Shell الجديد في SharePoint 2010, وفيما يلي سنشرح كيفية تشغيل الميزة DocId باستخدام سطر الأوامر stsadm بالتفصيل باتباع الخطوات التالية:
  • افتح منفذ الأوامر DOS screen واكتب السطر التالي ومن ثم اضغط Enter:
    cd C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\BIN

  • من أجل تنصيب الميزة DocId على المزرعة الحالية Current Farm اكتب السطر التالي واضغط Enter:
    stsadm -o installfeature -name DocId
    في الخطوة السابقة قد تظهر الرسالة التالية لتشير بأن هذه الميزة موجودة مسبقاً في هذه المزرعة:
    A feature with ID b50e3104-6812-424f-a011-cc90e6327318 has already been installed in this farm. Use the force attribute to explicitly re-install the feature.

    ملاحظة: الرسالة السابقة لا تؤثر على باقي خطوات وإنما تؤكد لنا بأن هذه الميزة موجودة مسبقاً, وهذه هي الحالة الافتراضية لهذه الميزة في SharePoint 2010 Beta ولكننا ننفذ هذا الأمر للتأكد من تحميل الميزة DocId.

    ملاحظة: للتأكد من أن الميزة DocId قد تم تحميلها مسبقاً يمكن اختيار الأمر Site collection features من صفحة إعدادات الموقع الجذر Root web لتطبيق الويب Web Application الذي نعمل عليها:


    وفي حال أن الميزة DocId موجودة مسبقاً يجب أن تشاهد اسمها كما يلي Document ID Service:


  • بعد التأكد من تحميل الميزة DocId على المزرعة الحالية SharePoint Farm يجب الآن تفعيل هذه الميزة بحيث يمكن استخدامها في مكتبة المستندات, ولتنفيذ ذلك اكتب السطر التالي بعد تنفيذ الخطوة رقم 2 واضغط Enter:
    stsadm -o activatefeature -name DocId -Url http://WEB_APP_URL

    ملاحظة: عند محاولة تفعيل الميزة DocId على موقع فرعي Sub Site سيظهر خطأ يعلمك بأن هذه الميزة يتم تفعيلها على مستوى مجموعة الموقع فقط Site Collection.

    ملاحظة: الحالة الافتراضية للميزة DocId هي "غير مفعلة" ويمكن تفعيلها إما باستخدام سطر الأوامر أو يمكن تنفيذها من خلال صفحة ميزات مجموعة الموقع Site Collection Features:


    ملاحظة: في حال محاولة تفعيل الميزة DocId من خلال سطر الأوامر stsadm وحالتها هي Active عندها ستظهر رسالة الخطأ التالية التي تشير بأن هذه الميزة تم تفعيلها مسبقاً:

    Feature 'DocId' (ID: b50e3104-6812-424f-a011-cc90e6327318) is already activated at scope 'http://WEB_APP'.

    ملاحظة: في حال أن الميزة DocId مفعلاً مسبقاً عندها سترى في صفحة ميزات مجموعة الموقع Site Collection Features الشكل التالي بجانب الاسم Document ID Service:


ملاحظة: بعد تنفيذ جميع الخطوات السابقة تكون الميزة DocId قد تم تفعيلها على مجموعة الموقع ولكن هناك بعض الإعدادات الأخرى التي تؤثر على عمل هذه الميزة سيتم شرحها لاحقاً.

الجمعة، 22 يناير 2010

خدمة الرقم الفريد للمستندات في SharePoint 2010 (Document ID)





من الميزات الجديدة التي رافقت الإصدار الجديد من منتج شركة مايكروسوفت SharePoint 2010 هي الميزة "رقم المستند الفريد Document ID", وهذا الرقم هو عبارة عن قيمة نصية تتألف من أرقام وحروف تميز كل مستند من المستندات الموجودة في أي مكتبة مستندات على مستوى مجموع الموقع Site Collection عن أي مستند آخر, وهذه الميزة ساعدت كثيراً على حل مشكلة نقل المستندات من مكان إلى آخر ضمن نفس مجموعة الموقع بحيث لا تؤثر عملية نقل المستند على رابط المستند المستخدم في صفحات الموقع أو أي موقع آخر. وكمثال على "رقم المستند الفريد Document ID":


ومن خلال هذا الرقم صار من الممكن الإشارة إلى الملف باستخدام الصيغة التالية:
http://web_app_url/_layouts/DocIdRedir.aspx?ID=ISMAEEL-11-53
حيث نلاحظ بأن هذا المسار لا يشير إلى أي مكتبة مستندات وإنما تم إضافة الصفحة DocIdRedir.aspx ويتم تمرير رقم المستند الفريد ومن خلاله يمكن الوصول إلى الملف.

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

ما سبق هو التعريف الاستخدامي لميزة الرقم الفريد للمستندات Document ID وهو مايهم المستخدمين العاديين غير التقنيين معرفته عن هذه الميزة وماهي الفائدة المرجوة منها.

أما من الناحية الفنية التقنية فإن هذه الميزة تعتمد على مجموعة من العناصر التي تشكل بمجموعها الرقم الفريد للمستندات Document ID وفي سلسلة المقالات حول هذه الخدمة سيتم استعراضها كلاً على حدة


الخميس، 14 يناير 2010

خطأ عند طلب إعدادات الرقم الفريد للمستندات Document ID Settings




في SharePoint 2010 Beta عند محاولة الوصول إلى إعدادات الرقم الفريد للمستندات Document ID Settings في إعدادات مجموعة الموقع


ظهر الخطأ التالي:
The load balancer is not provisioned. Verify the load balancer was provisioned successfully before retrieving endpoint addresses
حاولت البحث عن هذا الخطأ في الإنترنت لكن للأسف لم أجد أي حل لهذه المشكلة لذلك حاولت إعادة جميع الإعدادات الافتراضية التي غيرتها ونجحت بعد الكثير من التجارب وذلك عندما أعدت الإعدادات الافتراضية لاتصال الخدمات Service Connections في موقع الإدارة المركزية Central Administration Web Site:


حيث استعدت الإعدادات الافتراضية لهذه الشاشة كما يلي:


وبعدها استطعت الوصول إلى صفحة إعدادات الرقم الفريد للمستندات Document ID Settings:


الثلاثاء، 12 يناير 2010

إضافة ملف إلى مكتبة الصفحات باستخدام الميزة




من أجل إضافة ملف إلى المكتبة Pages باستخدام ميزة Feature اتبع الخطوات التالية:
  1. أنشئ مجلد اسمه AddFileToPages في المسار C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES\
  2. أنشء في المجلد AddFileToPages ملفاً اسمه Feature.xml يحتوي على البيانات التالية:


  3. <?xml version="1.0" encoding="utf-8"?>
    <Feature xmlns="http://schemas.microsoft.com/sharepoint/"
    Id="92AE1E3D-929E-4064-9266-A38136D623EC"
    Title="Add File to Pages list"
    Scope="Web"
    >
    <ElementManifests>
    <ElementManifest Location="Manifest.xml"/>
    </ElementManifests>
    </Feature>
  4. أنشئ ملفاً آخر في المجلد AddFileToPages اسمه Manifest.xml يحتوي على البيانات التالية:

  5. <Elements xmlns="http://schemas.microsoft.com/sharepoint/">
    <Module Name="AddFile" Url="Pages">
    <File
    Type="GhostableInLibrary"
    Url="Ismail.aspx"
    Path="Ismail.aspx"
    NavBarHome="True"
    Name="Ismail.aspx" />
    </Module>
    </Elements>
  6. أنشئ ملفاً في المجلد AddFileToPages اسمه Ismail.aspx وهو الملف الذي سيتم إضافته إلى القائمة Pages.
  7. الآن يجب تنصيب الميزة AddFileToPages كما يلي:
  8. install-SPFeature AddFileToPages
  9. الآن يجب تفعيل الميزة AddFileToPages على أحد المواقع التي تحتوي على المكتبة Pages كما يلي:
  10. Enable-SPFeature AddFileToPages -Url http://YOUR_WEB_SITE_PATH

الأحد، 10 يناير 2010

دعم اللغة العربية في SilverLight + SharePoint 2010



ذكرت في مقالة سابقة "إنشاء قائمة مخصصة" كيف أن شركة مايكروسوفت استخدمت تقنية Silverlight في النموذج الذي يظهر عند إنشاء موقع جديد أو قائمة وكما نعلم حتى تاريخ كتابة هذه المقالة فإن Silverlight لا يدعم اللغة العربية بشكل صحيح وقد قمت بتجربة بسيطة حيث قمت بتغيير اسم Blank Site إلى "موقع فارغ" في الملف webtemp.xml وكانت النتيجة ما يلي:


نلاحظ كيف أن اللغة العربية لا تظهر بشكل صحيح في الصورة السابقة, لذلك أنا متفائل بأن الإصدار القادم من Silverlight سيدعم اللغة العربية بشكل صحيح أو أنه سيكون هناك بديل عن هذه الشاشة في الإصدار القادم من SharePoint 2010.


الخميس، 7 يناير 2010

السماح بتحرير عناصر مكتبة المستندات في صفحة البيانات Allow items in this document library to be edited using the datasheet





الخيار "السماح بتحرير عناصر مكتبة المستندات في صفحة البيانات Allow items in this document library to be edited using the datasheet" موجود في صفحة الإعدادات المتقدمة لمكتبة المستندات, ويمكن ضبط هذا الخيار على إحدى القيمتين "لا و نعم Yes & No"


والهدف منه هو السماح أو عدم السماح بالأمر "طريقة عرض صفحة بيانات Datasheet View" في الج موعة "طريقة العرض View Format" في التبويب "المكتبة Library" في مكتبة المستندات, فعند ضبطه على القيمة "لا No" يتم إلغاء تفعيل هذا الأمر


أيضاً عند ضبط هذا الخيار على القيمة "لا No" يختفي الخير إنشاء طريقة عرض لصفحة بيانات Datasheet View من صفحة إنشاء طريقة عرض جديدة:


ملاحظة: في حال إنشاء طريقة عرض من النوع Datasheet View قبل ضبط هذا الخيار على القيمة "لا No" فمازال من الممكن استخدام طريقة العرض الجديدة حتى بعد ضبط الخيار على القيمة "لا No" وبرأيي الشخصي حول هذا الأمر فأعتقد بأنه غير صحيح, إذا يجب إما إخفاء طريقة العرض الجديدة من النوع Datasheet View أو منع عملية اختيارها لأن إلغاء عملية السماح بتعديل المستندا في طريقة عرض صفحة بيانات لم يعد لها أي تأثير في هذه الحالة وهذا أمر غير منطقي أعتقد أنه إحدى ثغرات SharePoint 2010 Beta.


الثلاثاء، 5 يناير 2010

تخصيص الأمر "إرسال إلى" Customize Send To Destination





كنا قد شاهدنا سابقاً الأمر "إرسال إلى Send To" في المجموعة "النسخ Copies" في التبويب "المستندات Documents" والذي يحتوي على الأمر الفرعي "إرسال إلى مكان آخر Other Location" حيث يتم تحديد مسار مكتبة المستندات حيث سيتم نسخ المستند الحمدد, وارتباطاً بهذا الأمر فإنه يمكن وضع مسار مخصص حيث يمكن نسخ المستند الحnدد مباشرة من خلال ضبط الخيار "Custom Send To Destination" في الإعدادات المتقدم لمكتبة المستندات:

حيث يمكن إدخال اسم للمكان المخصص بحيث يظهر للمستخدم, وعنوان هذا المكان حيث سيتم نسخ المستند المحدد:
الآن حدد مستند واضغط على Send To --> Contracts Copies عندها سيتم شاشة نسخ المستند كما في الشكل التالي:
في الحقل النصي الأول يظهر عنوان المكان المخصص لمكتبة المستندات حيث يجب نسخ المستند إليها, ويمكن تحديد مسار لمجلد في مكتبة المستندات, ومسار مكتبة المستندات يمكن أن يكون على مجموعة مواقع جديدة Site Collection, كما يمكن كتابة مسار مكتبة المستندات على تطبيق ويب مختلف Web Application.
في الحقل النصي الثاني يظهر اسم المستند الحالي مع إمكانية تغييره مع العلم أن الامتداد لا يمكن تغييره, وفي حال إدخال لاسم مستند موجود في مكتبة المستندات الهدف فإن عملية النسخ ستفشل في حال تحقق الشرطين التاليين معاً:
  • المستند الهدف غير مسحوب Not Checked Out.
  • الخيار "يجب سحب المستندات قبل إمكانية التحرير عليها Require documents to be checked out before they can be edited" في مكتبة المستندات الهدف محدد إلى نعم Yes.
أما الخيار الثالث وهو عبارة عن اختيار بين نعم ولا Yes & No فعند اختيار نعم Yes يعني أنه عند تنفيذ العملية "إيداع مستند Check In" سيُظهر النظام خياراً للمستخدم لتحديث المستند المنسوخ من المستند الأصلي. أما الخيار الأخير فهو إمكانية استقبال إشعار عند أي تحديث على معلومات المستند الأصلي.
ملاحظة: عند تجربة هذا الخيار على SharePoint 2010 Beta فإن النموذج الذي يفتح لنسخ المستند لا يستخدم النماذج المطورة وإنما يفتح صفحة جديدة فيها خيارات نسخ المستند.


الأحد، 3 يناير 2010

الملف غير موجود SharePoint2010

عند استخدام نظام التغشيل Windwos 7 كمنصة عمل لتشغيل SharePoint 2010 مع استخدام Visual Studio 2010 لا بد أنك حاولت كتابة برنامج يستخدم SharePoint Object Model بحيث أن شاشة التنفيذ إما تكون شاشات رسومية أو شاشة DOS أي بدون إنشاء جزء ويب أو رفع الشيفرة إلى SharePoint 2010, المهم عند تنفيذ البرنامج ستظهر رسالة خطأ تفيد بأن مسار الموقع الذي استخدمته في SPSite غير موجود:
System.IO.FileNotFoundException: The Web application could not be found. Verify that you have typed the URL correctly. If the URL should be serving existing content, the system administrator may need to add a new request URL mapping to the intended application

سبب هذا الخطأ هو أن خيارات المعالج في Visual Studio 2010 الافتراضية هي x68 مع العلم أن SharePoint 2010 يعمل فقط على منصة عمل x64 لذلك يجب تغيير Platform Target في Project Properties --> Build إلى x64 بدلاً من x86 وبعدها أعد بناء البرنامج وتنفيذه.

ملاحظة: في بعض الأحيان هذا الخطأ قد ينتج عن أن المستخدم الذي ينفذ البرنامج ليس لديه السماحيات الكافية.