نشر موصل Microsoft SharePoint Online

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

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

قبل نشر أداة ربط SharePoint Online، يجب مراعاة ما يلي.

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

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

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

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

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

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

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

  • يعمل الموصل على تسوية أنواع محتوى SharePoint إلى أسماء صالحة لتعريف الكائن (من الألف إلى الياء، ومن الألف إلى الياء بالإنجليزية، ومن 0 إلى 9). على سبيل المثال، تصبح "مقالة إخبارية" "NewsArticle".
  • إذا لم يتمكّن أداة الربط من مطابقة تعريف عنصر، سيستخدم نوع العنصر الاحتياطي (itemMetadata.objectType). راجِع مَعلمات إعداد البيانات الوصفية.
  • يربط الموصل أسماء خصائص SharePoint بتعريفات الخصائص.
  • تتجاهل أداة الربط نوع الوسائط لملفات Microsoft Outlook .msg وتفهرسها على أنّها 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

نشر الموصّل

اتّبِع الخطوات التالية لنشر أداة ربط SharePoint Online.

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

  1. أنشئ مفتاحًا خاصًا في Google Workspace. يمكنك الاطّلاع على ضبط أذونات الوصول إلى Cloud Search API.
  2. أضِف مصدر بيانات إلى البحث وسجِّل رقم تعريفه. اطّلِع على إضافة مصدر بيانات إلى البحث.
  3. بالنسبة إلى النتائج المستندة إلى قائمة التحكّم بالوصول، على المشرف إنشاء مصدرَي هوية (أحدهما لمجموعات Office 365 والآخر لمجموعات SharePoint) وتقديم معرّف عميل Google Workspace. اطّلِع على مقالة تحديد هويات المستخدمين.
  4. إعداد حساب مستخدم للموصل مع امتيازات مشرف مجموعة المواقع في SharePoint Online
  5. أنشئ بيانات اعتماد تطبيق Azure Active Directory مع أذونات Group.Read.All وUser.Read.All. دوِّن معرّف التطبيق والمستأجر والرمز السري للعميل.

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

  1. استنسِخ المستودع: 
    $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
$ cd sharepoint-connector
  2. اطّلِع على الإصدار الذي اخترته (مثلاً v1-0.0.3): 
    $ git checkout tags/v1-0.0.3
  3. إنشاء الموصّل: 
    $ mvn package
     لتخطّي الاختبارات، استخدِم mvn package -DskipTests.
  4. استخرِج ملف ZIP إلى دليل التثبيت.

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

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

api.sourceId=08ef8becd116faa4546b8ca2c84b2879
api.serviceAccountPrivateKeyFile=service_account.json
sharepoint.server=https://mydomain.onmicrosoft.com
sharepoint.siteCollectionOnly=true
sharepoint.username=admin@mydomain.onmicrosoft.com
sharepoint.password=password
sharepoint.formsAuthenticationMode=LIVE
sharepoint.deploymentType=ONLINE
api.identitySourceId=08ef8becd116faa475de26d9b291fed9
api.referenceIdentitySources=defaultIdentitySource
api.referenceIdentitySource.defaultIdentitySource.id=08ef8becd116faa5d3783f8c5a80e5aa

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

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

أنشئ مجلدًا باسم logs وملفًا باسم 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

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

```properties
### 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
```

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

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

  1. أنشئ نسخة طبق الأصل من مستودع Office 365:

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

  2. يمكنك الاطّلاع على الموصّل وإنشائه باستخدام mvn package.

  3. استخرِج ملف ZIP إلى دليل التثبيت.

الخطوة السادسة. ضبط موصّل الهوية في Office 365

  1. في الدليل نفسه الذي تم فيه تثبيت أداة ربط الهوية، أنشئ ملفًا باسم o365-identity-connector.config وأضِف المَعلمات كأزواج مفتاح/قيمة:

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

    للاطّلاع على أوصاف المَعلمات، يُرجى الرجوع إلى أداة ربط الهوية في Office 365.

  2. في الدليل نفسه، أنشئ مجلدًا باسم logs.

  3. في الدليل نفسه، أنشئ ملفًا باسم 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: تشغيل الموصّل

بعد ضبط الموصلات، شغِّلها لبدء المزامنة والفهرسة. نفِّذ كل أمر في نافذة وحدة طرفية منفصلة.

  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 -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar -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

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

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

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

الإعداد المَعلمة
رقم تعريف مصدر البيانات 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