نشر موصل Microsoft SharePoint Online

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

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

إعدادات SharePoint التي يتم الالتزام بها

يُراعي موصّل Cloud Search SharePoint Online دائمًا إعداد إذن الوصول إلى البحث في SharePoint، ولا يمكن تجاهله. بالنسبة إلى مستندات المسودات، تتحكّم الأذونات في حساب المستخدم (الذي يستخدمه الموصل للوصول إلى SharePoint Online) في مستندات المسودات التي يتم فهرستها وعرضها. إذا كان الحساب يتضمّن أذونات "القراءة الكاملة" فقط، يلتزم الموصل بإعدادات "إمكانية رؤية عناصر المسودّة" في SharePoint.

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

• مستخدمو Office 365 / Azure AD
• مجموعات الأمان في Office 365 / Azure AD
• مجموعات SharePoint (مع مستخدمي ومجموعات Office 365 كأعضاء)

تحسين الأداء على "شبكة البحث"

يمكنك تحسين تجربة المستخدمين من خلال ضبط أداة الربط لعرض نتائج بحث أكثر صلة.

لاستخدام واجهة برمجة التطبيقات، اضبط قيم مَعلمات إنشاء HTML في ملف إعداد أداة ربط SharePoint Online. تتيح لك هذه المَعلمات تحديد الحقول التي لها تأثير أكبر أو أقل في عمليات المطابقة.

لإعداد مخطط، اتّبِع التعليمات الواردة في إنشاء مخطط وتسجيله. عند إعداد مخطط:

• لربط أسماء أنواع محتوى SharePoint بتعريفات العناصر المقابلة، يعمل الموصل على تسوية أسماء أنواع المحتوى من خلال استبعاد الأحرف غير المسموح بها. بالنسبة إلى تعريفات العناصر، لا تتيح Cloud Search API استخدام سوى الأحرف من A إلى Z ومن a إلى z والأرقام من 0 إلى 9 كأحرف صالحة. على سبيل المثال، يرتبط نوع المحتوى "الإشعارات" بتعريف العنصر "الإشعارات". يتوافق نوع المحتوى "مقالة إخبارية" مع "NewsArticle" (بدون مسافة).

• عندما يتعذّر على أداة الربط مطابقة تعريف عنصر مع تعريف عنصر آخر، تستخدم أداة الربط نوع العنصر الاحتياطي (itemMetadata.objectType). مزيد من المعلومات عن مَعلمات إعداد البيانات الوصفية

• يربط الموصل أسماء خصائص SharePoint بتعريفات الخصائص.

• عندما يصادف الموصل ملفات ‎ .msg من Microsoft Outlook أثناء فهرسة المحتوى، يتجاهل نوع المحتوى للملفات ويفهرسها على أنّها application/vnd.ms-outlook.

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

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

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

متطلبات النظام
نظام التشغيل	Windows Server 2016 Ubuntu Red Hat Enterprise Linux 5.0 SUSE Enterprise Linux 10 (64 بت)
المصادقة	المصادقة المباشرة
البرامج	بيئة SharePoint Online تثبيت Java JRE 1.8 على الكمبيوتر الذي سيشغّل موصّل Google Cloud Search SharePoint Online

نشر الموصّل

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

1. أنشئ مفتاحًا خاصًا على Google Workspace يحتوي على رقم تعريف حساب الخدمة. لمعرفة كيفية الحصول على مفتاح خاص، انتقِل إلى ضبط إذن الوصول إلى Google Cloud Search API.

2. على مشرف Google Workspace إضافة مصدر بيانات للبحث. سجِّل رقم تعريف مصدر البيانات.

3. إذا كان الموصل يعرض نتائج استنادًا إلى قوائم التحكّم بالوصول (النتائج ليست متاحة للجميع)، على مشرف Google Workspace إنشاء مصدرَي هوية ومنحك أرقام التعريف الخاصة بهما:

   • واحد لمستخدمي ومجموعات Office 365
   • واحد لمجموعات SharePoint

   على المشرف أيضًا الحصول على رقم تعريف عميل Google Workspace لمؤسستك وإرساله إليك.

   تعرَّف على كيفية الحصول على هذه القيم في مقالة ربط هويات المستخدمين في Cloud Search.

4. إعداد حساب مستخدم للموصل لديه امتيازات مشرف مجموعة المواقع في SharePoint Online

5. إذا كان الموصل يعرض نتائج استنادًا إلى قوائم التحكم بالوصول (النتائج ليست متاحة للجميع)، أنشئ بيانات اعتماد لقراءة المستخدمين والمجموعات من حسابك على Office 365. اتّبِع تعليمات Microsoft لإنشاء تطبيق Azure Active Directory. أثناء إعداد التطبيق، اتّبِع الخطوات التالية:

   1. امنح التطبيق اسمًا وصفيًا، مثل "gcs-o365-identity-connector".
   2. إضافة أذونات يحتاج التطبيق إلى "Group.Read.All" و "User.Read.All".
   3. سجِّل المعلومات التالية لاستخدامها في إعدادات الموصل:
      • معرِّف التطبيق
      • المستأجر
      • سرّ العميل

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

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

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

2. اطّلِع على الإصدار المطلوب من الموصل:

   $ git checkout tags/v1-0.0.3

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

   $ mvn package

   لتخطّي الاختبارات عند إنشاء الموصل، شغِّل mvn package -DskipTests بدلاً من mvn package.

4. انسخ ملف zip الخاص بالموصل إلى دليل التثبيت المحلي:

   $ cp target/google-cloudsearch-sharepoint-connector-v1-0.0.3.zip installation-dir
   $ cd installation-dir
   $ unzip google-cloudsearch-sharepoint-connector-v1-0.0.3.zip
   $ cd google-cloudsearch-sharepoint-connector-v1-0.0.3

الخطوة 2: إنشاء ملف إعدادات موصّل SharePoint Online

1. في الدليل نفسه الذي تم فيه تثبيت أداة الربط، أنشِئ ملفًا جديدًا وسمِّه sharepoint-online-connector.config. إذا كنت تخطّط لتشغيل العديد من مثيلات الموصل، أضِف المزيد من التفاصيل إلى الاسم لتمييزه.

2. أضِف المَعلمات كأزواج مفتاح/قيمة إلى محتوى الملف، كما في المثال التالي:

   ### SharePoint Online connector configuration ###
   
   # Required parameters for data source access
   api.sourceId=08ef8becd116faa4546b8ca2c84b2879
   api.serviceAccountPrivateKeyFile=service_account.json
   
   # Required parameters for SharePoint Online access
   sharepoint.server=https://mydomain.onmicrosoft.com
   sharepoint.siteCollectionOnly=true
   sharepoint.username=admin@mydomain.onmicrosoft.com
   sharepoint.password=pa$sw0rd
   sharepoint.formsAuthenticationMode=LIVE
   sharepoint.deploymentType=ONLINE
   
   # SharePoint identity mapping parameters
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   api.referenceIdentitySources=defaultIdentitySource
   api.referenceIdentitySource.defaultIdentitySource.id=08ef8becd116faa5d3783f8c5a80e5aa
   
   # Optional SharePoint List Item metadata parameters
   contentTemplate.sharepointItem.title=Title
   contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
   

   للحصول على أوصاف تفصيلية لكل مَعلمة، انتقِل إلى مرجع مَعلمات الإعداد.

3. (اختياري) اضبط مَعلمات إضافية للموصل حسب الحاجة. لمعرفة التفاصيل، انتقِل إلى مَعلمات الموصل التي توفّرها Google.

الخطوة 3: إعداد التسجيل لموصل SharePoint Online

1. أنشئ مجلدًا باسم logs في الدليل نفسه الذي يحتوي على الملف الثنائي للموصل.

2. أنشئ ملفًا بترميز Latin-1 باسم logging.properties في الدليل نفسه وأضِف المحتوى التالي:

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = INFO
   # uncomment line below to increase logging level for SharePoint APIsa
   #com.google.enterprise.cloudsearch.sharepoint.level=FINE
   
   # uncomment line below to increase logging level to enable API trace
   #com.google.api.client.http.level = FINE
   java.util.logging.ConsoleHandler.level = INFO
   java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log
   java.util.logging.FileHandler.limit=10485760
   java.util.logging.FileHandler.count=10
   java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
   

الخطوة 4: ضبط موصّل تحديد الهوية في SharePoint Online

هذه الخطوة مطلوبة لتطبيق قوائم التحكم بالوصول المستندة إلى الهوية في SharePoint Online على نتائج البحث. إذا أعددت أداة الربط باستخدام قوائم التحكّم بالوصول (ACL) العامة، يمكنك تخطّي هذه الخطوة.

1. في الدليل نفسه الذي تم فيه تثبيت أداة ربط SharePoint Online، أنشِئ ملفًا جديدًا وسمِّه sharepoint-online-identity-connector.config.

2. أضِف المَعلمات كأزواج مفتاح/قيمة إلى محتوى الملف، كما في المثال التالي:

   ### SharePoint Online identity connector configuration ###
   # Required parameters for data source access
   api.customerId=C05d3djk8
   api.serviceAccountPrivateKeyFile=service_account.json
   
   # Required parameters for SharePoint Online access
   sharepoint.server=https://mydomain.onmicrosoft.com
   sharepoint.siteCollectionOnly=true
   sharepoint.username=admin@mydomain.onmicrosoft.com
   sharepoint.password=pa$sw0rd
   sharepoint.formsAuthenticationMode=LIVE
   sharepoint.deploymentType=ONLINE
   
   # SharePoint identity mapping parameters
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   api.referenceIdentitySources=defaultIdentitySource
   api.referenceIdentitySource.defaultIdentitySource.id=08ef8becd116faa5d3783f8c5a80e5aa
   

   تتشابه القيم تقريبًا مع قيم موصّل SharePoint Online، باستثناء أنّه بدلاً من api.sourceId، تكون المَعلمة api.customerId. قيمة api.customerId هي رقم تعريف العميل الذي حصلت عليه من مشرف Google Workspace.

الخطوة 5: تثبيت موصِّل الهوية في Office 365

هذه الخطوة مطلوبة لتطبيق قوائم التحكم بالوصول المستندة إلى الهوية في SharePoint Online على نتائج البحث. إذا أعددت أداة الربط باستخدام قوائم التحكّم بالوصول (ACL) العامة، يمكنك تخطّي هذه الخطوة.

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

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

2. اطّلِع على الإصدار المطلوب من الموصل:

   $ git checkout tags/v1-0.0.3

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

   $ mvn package

   لتخطّي الاختبارات عند إنشاء الموصل، شغِّل mvn package -DskipTests بدلاً من mvn package.

4. انسخ ملف zip الخاص بالموصل إلى دليل التثبيت المحلي:

   $ cp target/google-cloudsearch-office-365-connector-v1-0.0.3.zip installation-dir
   $ cd installation-dir
   $ unzip google-cloudsearch-office-365-connector-v1-0.0.3.zip
   $ cd google-cloudsearch-office-365-connector-v1-0.0.3

الخطوة السادسة. ضبط أداة ربط الهوية في Office 365 وإعداد التسجيل

1. في الدليل نفسه الذي تم فيه تثبيت أداة ربط تحديد الهوية، أنشِئ ملفًا جديدًا وسمِّه o365-identity-connector.config.

2. أضِف المَعلمات كأزواج مفتاح/قيمة إلى محتوى الملف، كما في المثال التالي. ملاحظة: جميع المَعلمات مطلوبة.

   ### Office 365 Identity connector configuration ###
   
   api.identitySourceId=12345abcde
   api.customerId=abcde12345
   o365.clientId=a63c6eb3-29e7-486
   o365.tenant=185ef9ed-29e7-486
   o365.clientSecret=raHJN15vRLBKs
   

   للحصول على أوصاف تفصيلية لكل مَعلمة، انتقِل إلى مرجع إعداد موصّل هوية Office 365.

3. أنشئ مجلدًا باسم logs في الدليل نفسه الذي يحتوي على الملف الثنائي للموصل.

4. أنشئ ملفًا بتنسيق ASCII أو UTF-8 باسم logging.properties في الدليل نفسه وأضِف المحتوى التالي:

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = INFO
   # uncomment line below to increase logging level for Office 365 APIs
   #com.google.enterprise.cloudsearch.o365.level=FINE
   
   # uncomment line below to increase logging level to enable Google API traces
   #com.google.api.client.http.level = FINE
   java.util.logging.ConsoleHandler.level = INFO
   java.util.logging.FileHandler.pattern=logs/connector-o365.%g.log
   java.util.logging.FileHandler.limit=10485760
   java.util.logging.FileHandler.count=10
   java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
   

الخطوة 7: تشغيل أداة ربط SharePoint Online

في الخطوات التالية، يمكنك ربط الجهات الرئيسية في كل من Office 365 ومجموعة المواقع الإلكترونية على SharePoint بالهويات في خدمة Cloud Identity. تتم هذه المزامنة باستخدام موصّل هوية Office 365 وموصّل هوية SharePoint Online.

بعد أن يربط موصّل Office 365 المستخدمين والمجموعات، شغِّل موصّل تحديد الهوية في SharePoint Online لربط مجموعات مجموعات المواقع الإلكترونية في SharePoint. بعد ذلك، شغِّل أداة ربط SharePoint Online لفهرسة النتائج وعرضها لمستخدمي Cloud Search.

1. شغِّل موصِّل الهوية في Office 365:

   $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-office-365-connector-v1-0.0.3.jar -Dconfig=o365-identity-connector.config

2. شغِّل موصِّل الهوية في SharePoint Online:

   $ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-v1-0.0.3.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-online-identity-connector.config

3. شغِّل موصِّل SharePoint Online:

   $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar -Dconfig=sharepoint-online-connector.config

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

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

الإعداد	المَعلمة
رقم تعريف مصدر البيانات	api.sourceId=1234567890abcdef الحقل مطلوب. رقم تعريف مصدر بيانات Google Cloud Search الذي أعدّه مشرف Google Workspace
مسار ملف المفتاح الخاص لحساب الخدمة	api.serviceAccountPrivateKeyFile=PrivateKey.json الحقل مطلوب. مسار ملف مفتاح حساب خدمة Google Cloud Search.

الوصول إلى SharePoint Online

الإعداد	المَعلمة
اسم النطاق المؤهَّل بالكامل لمجموعة مواقع SharePoint	sharepoint.server=http://yoursharepoint.example.com/ الحقل مطلوب. إذا لم يكن اسم النطاق مؤهَّلاً بالكامل، اضبط إعدادات تجاوز نظام أسماء النطاقات على مضيف الموصّل.
وضع "مجموعة المواقع الإلكترونية فقط"	sharepoint.siteCollectionOnly=true الحقل مطلوب. بالنسبة إلى SharePoint Online، اضبط القيمة على true.
اسم مستخدم SharePoint	sharepoint.username=username الحقل مطلوب. اسم المستخدم للحساب المستخدَم للوصول إلى SharePoint Online
كلمة مرور SharePoint	sharepoint.password=user_password الحقل مطلوب. كلمة مرور الحساب المستخدَم للوصول إلى SharePoint Online
وضع المصادقة	sharepoint.formsAuthenticationMode=LIVE الحقل مطلوب. بالنسبة إلى SharePoint Online، تكون القيمة دائمًا `LIVE`.
نوع النشر	sharepoint.deploymentType=ONLINE الحقل مطلوب. بالنسبة إلى SharePoint Online، تكون القيمة دائمًا `ONLINE`.

تحديد الهوية في SharePoint

الإعداد	المَعلمة
رقم تعريف مصدر الهوية	api.identitySourceId=1234567890abcdef الحقل مطلوب. معرّف مصدر الهوية في Cloud Search لمصدر هوية مجموعات SharePoint.
مصادر الهوية المرجعية	api.referenceIdentitySources=defaultIdentitySource الحقل مطلوب. بالنسبة إلى SharePoint Online، تكون القيمة دائمًا `defaultIdentitySource`.
أرقام تعريف مصادر الهوية المرجعية	api.referenceIdentitySource.defaultIdentitySource.id=112233abcd الحقل مطلوب. معرّف مصدر الهوية في Cloud Search لمصدر هوية "مستخدمو Office 365" و"مجموعات Office 365"

إنشاء محتوى HTML

الإعداد	المَعلمة
حقل عنوان نموذج HTML	contentTemplate.sharePointItem.title=Title حقل SharePoint الذي سيتم استخدامه كعنوان لنموذج HTML لرمز HTML الذي تم إنشاؤه.
حقول جودة البحث العالية لمحتوى HTML	contentTemplate.sharePointItem.quality.high=highField1[,highField2,...] قائمة مفصولة بفواصل للحقول التي سيتم تضمينها في رمز HTML الذي تم إنشاؤه كحقول عالية الجودة عندما تتطابق عبارات طلب البحث مع هذه الحقول، يتم ترتيب النتائج في موضع أعلى.
حقول جودة البحث المتوسطة لمحتوى HTML	contentTemplate.sharePointItem.quality.medium=mediumField1[,mediumField2,...] قائمة مفصولة بفواصل للحقول التي سيتم تضمينها في رمز HTML الذي تم إنشاؤه كحقول متوسطة الجودة
حقول جودة البحث المنخفضة لمحتوى HTML	contentTemplate.sharePointItem.quality.low=lowField1[,lowField2,...] قائمة مفصولة بفواصل للحقول التي سيتم تضمينها في رمز HTML الذي تم إنشاؤه كحقول منخفضة الجودة
أعمدة محتوى HTML غير مرتبطة	contentTemplate.sharepointItem.unmappedColumnsMode=APPEND كيفية تعامل الموصّل مع الأعمدة غير المطابَقة القيمة هي APPEND (تلقائية) أو IGNORE. APPEND: ينشئ الموصل محتوى HTML يتضمّن جميع الحقول، بما في ذلك الحقول التي لم يتم ضبط مستوى جودة لها (مرتفع أو متوسط أو منخفض). IGNORE: ينشئ الموصل محتوى HTML يتضمّن الحقول المرتبطة فقط.

إعدادات موصّل الهوية في Office 365

الإعداد	المَعلمة
رقم تعريف مصدر الهوية	api.identitySourceId=1234567890abcdef الحقل مطلوب. رقم تعريف مصدر الهوية في Office 365 يجب أن تتطابق هذه القيمة مع قيمة `api.referenceIdentitySource.defaultIdentitySource.id` في إعدادات موصّل SharePoint Online.
رقم تعريف العميل على Google	api.customerId=c1b1d1e1 الحقل مطلوب. الرقم التعريفي لعميل Google Workspace في مؤسستك
معرّف تطبيق Office 365	o365.clientId=a63c6eb3-29e7-486 الحقل مطلوب. معرّف التطبيق من إعداد تطبيق Office 365
مستأجر Office 365	o365.tenant=185ef9ed-29e7-486 الحقل مطلوب. المستأجر لحسابك على Office 365 (تطبيق Azure Activity Directory)
سر عميل Office 365	o365.clientSecret=raHJN15vRLBKs الحقل مطلوب. سر بيانات الاعتماد من إعداد تطبيق Office 365