نشر موصّل Microsoft SharePoint On-premises

يمكنكم إعداد Google Cloud Search لعرض نتائج من محتوى SharePoint المحلي التابع لمؤسستكم بالإضافة إلى محتوى Google Workspace. استخدِموا موصِّل SharePoint المحلي في Cloud Search واضبطوه للوصول إلى مصدر بيانات SharePoint محدّد.

اعتبارات مهمة

قبل نشر موصِّل SharePoint المحلي، يُرجى الانتباه إلى الاعتبارات التالية.

إعدادات SharePoint التي يتم تطبيقها

يطبّق الموصِّل دائمًا إعداد إمكانية البحث على SharePoint. بالنسبة إلى المستندات المسودة، تتحكّم الأذونات الممنوحة لحساب المستخدم الذي يستخدمه الموصِّل للوصول إلى SharePoint في المستندات التي يفهرسها ويعرضها. إذا كان الحساب يملك أذونات "القراءة الكاملة"، يطبّق الموصِّل إعدادات "إمكانية الاطّلاع على المسودة".

يمكنكم أيضًا حصر النتائج استنادًا إلى إذن وصول حساب المستخدم باستخدام الكيانات الأساسية من Google والكيانات الخارجية لتحديد قوائم التحكّم بالوصول. لتطبيق ميزة "إخفاء النتائج غير المسموح بها"، يجب مزامنة هذه الهويات الخارجية مع "دليل Google Cloud":

• مستخدمو ومجموعات Active Directory
• المجموعات المحلية في SharePoint (التي تضم مستخدمي ومجموعات Active Directory كأعضاء)

لمزامنة مستخدمي ومجموعات Active Directory، استخدِموا أداة مزامنة دليل Google Cloud Sync وفعِّلوا المجموعات التي تم تحديد الهوية لها. بالنسبة إلى المجموعات المحلية في SharePoint، استخدِموا موصِّل هوية SharePoint.

يُجري الموصِّل أيضًا عمليات بحث في Active Directory لاسترجاع معلومات لمزامنة الكيانات الأساسية، مثل ربط أرقام تعريف الأمان بـ sAMAccountNames.

تحسين البحث

يمكنكم تحسين تجربة البحث من خلال ضبط الموصِّل لعرض نتائج ذات صلة. استخدِموا مَعلمات إنشاء HTML في ملف الإعداد لضبط مستويات تأثير الحقول.

لإعداد مخطط، يُرجى الاطّلاع على مقالة إنشاء مخطط وتسجيله. عند إعداد مخطط:

• يُعدِّل الموصِّل أنواع محتوى SharePoint لتصبح أسماء تعريفات كائنات صالحة (من A إلى Z ومن a إلى z ومن 0 إلى 9). على سبيل المثال، يصبح "مقال إخباري" "NewsArticle".
• إذا تعذّر على الموصِّل مطابقة تعريف كائن، سيستخدم نوع الكائن الاحتياطي (itemMetadata.objectType). يُرجى الاطّلاع على مَعلمات إعداد البيانات الوصفية.
• يُعدِّل الموصِّل أسماء الخصائص من خلال فك ترميز الأحرف السداسية العشرية وإزالة البادئات "ows_".

التعامل مع رسائل Microsoft Outlook

يتجاهل الموصِّل نوع الوسائط لملفات Microsoft Outlook التي تحمل الامتداد .msg ويفهرسها على أنّها application/vnd.ms-outlook.

إعدادات الوحدات المشترَكة

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

• امنحوا حساب الموصِّل أذونات مشرف مجموعة المواقع الإلكترونية.
• اضبطوا sharepoint.server على عنوان URL لمجموعة المواقع الإلكترونية (مثلاً، http://sharepoint.example.com/sites/collection).
• اضبطوا sharepoint.siteCollectionOnly على true.

اضبطوا مثيلاً واحدًا من الموصِّل لكل مجموعة مواقع إلكترونية.

القيود المعروفة

• يزداد وقت رصد التغييرات مع زيادة عدد قواعد البيانات التي تتم مراقبتها.
• يزداد استخدام الذاكرة مع زيادة عدد المستخدمين والمجموعات الفريدين في قوائم التحكّم بالوصول.
• لا يتيح الموصِّل سوى الهويات من نطاق Active Directory واحد.
• قد يستغرق نشر إشعارات الحذف أكثر من أربع ساعات.

متطلبات النظام

تفعيل الوصلة

اتّبِعوا الخطوات التالية لنشر موصِّل SharePoint المحلي.

المتطلبات الأساسية

1. أنشِئوا مفتاحًا خاصًا على Google Workspace. يُرجى الاطّلاع على مقالة ضبط إذن الوصول إلى Cloud Search API.
2. أضيفوا مصدر بيانات إلى البحث وسجِّلوا رقم تعريفه. يُرجى الاطّلاع على مقالة إضافة مصدر بيانات إلى البحث.
3. بالنسبة إلى النتائج المستندة إلى قوائم التحكّم بالوصول، على المشرف إنشاء مصدرَي هوية (أحدهما لـ Active Directory والآخر للمجموعات المحلية في SharePoint) وتقديم رقم تعريف عميل Google Workspace. يُرجى الاطّلاع على مقالة تحديد هويات المستخدمين.
4. اضبطوا حساب مستخدم للموصِّل يملك أذونات القراءة الكاملة.
5. تأكَّدوا من أنّ تطبيق SharePoint على الويب يملك مجموعة مواقع إلكترونية جذرية.
6. إذا كانت مجموعات المواقع الإلكترونية محمية ضد الكتابة، شغِّلوا الـ PrepareWriteLockedSites.ps1 النص البرمجي.

الخطوة 1: تثبيت برنامج الموصِّل

1. استنسِخوا المستودع:

   $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
   $ cd sharepoint-connector

2. اختاروا الإصدار المطلوب (مثلاً، v1-0.0.5):

   $ git checkout tags/v1-0.0.5

3. أنشِئوا الموصِّل:

   $ mvn package

   لتخطّي الاختبارات، استخدِموا mvn package -DskipTests.
4. استخرِجوا ملف ZIP إلى دليل التثبيت.

الخطوة 2: إنشاء ملف الإعداد

أنشِئوا ملف connector-config.properties في دليل التثبيت. أضيفوا المَعلمات كأزواج مفتاح/قيمة:

api.sourceId=08ef8becd116faa4546b8ca2c84b2879
api.serviceAccountPrivateKeyFile=service_account.json
api.identitySourceId=08ef8becd116faa475de26d9b291fed9
sharepoint.server=http://sp-2016:32967/sites/collection
sharepoint.siteCollectionOnly=true
sharepoint.username=contoso\\admin
sharepoint.password=password
adLookup.host=dc.contoso.com
adLookup.username=contoso\\admin
adLookup.password=password

يُرجى الاطّلاع على المرجع أو المَعلمات التي توفّرها Google للحصول على التفاصيل.

الخطوة 3: إضافة SharePoint كمضيف موثوق به (HTTPS)

في حال استخدام HTTPS، يُرجى تصدير شهادة SharePoint واستيرادها إلى مخزن مفاتيح الموصِّل:

$ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

الخطوة 4: إعداد التسجيل

أنشِئوا مجلدًا باسم logs وملفًا باسم logging.properties يتضمّن هذا المحتوى: properties handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler .level = INFO java.util.logging.ConsoleHandler.level = INFO java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log

الخطوة 5: إعداد موصِّل الهوية

لتطبيق قوائم التحكّم بالوصول المستندة إلى الهوية، أنشِئوا ملف sharepoint-onprem-identity-connector.config يتضمّن api.customerId ومَعلمات الاتصال الأخرى.

الخطوة 6: بدء الموصِّل

1. شغِّلوا أداة مزامنة دليل Google Cloud لمزامنة مستخدمي ومجموعات Active Directory.
2. شغِّلوا موصِّل هوية SharePoint لمزامنة مجموعات مجموعة المواقع الإلكترونية.
3. شغِّلوا موصِّل SharePoint المحلي لفهرسة المحتوى.

مرجع مَعلمات الإعداد

تسرد الأقسام التالية مَعلمات الإعداد المستخدَمة لضبط موصِّل SharePoint المحلي.

الوصول إلى مصدر البيانات

الوصول إلى SharePoint المحلي

إنشاء محتوى HTML