نشر موصل Microsoft SharePoint Online

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

يمكنك إعداد 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 كأعضاء)

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

defaultAcl.mode=override
defaultAcl.public=true

عند إعداد النتائج المتاحة للجميع، لن تحتاج إلى إعداد أدوات ربط الهوية.

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

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

لاستخدام واجهة برمجة التطبيقات، اضبط قيم مَعلمات إنشاء 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=[e-mail]
   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=[e-mail]
   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