نشر موصل Microsoft SharePoint Online

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

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

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

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

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

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

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

تحسين البحث

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

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

• يُعدّل الموصِّل أنواع محتوى SharePoint إلى أسماء تعريفات كائنات صالحة (من A إلى Z ومن a إلى z ومن 0 إلى 9). على سبيل المثال، يصبح "News Article" (مقال إخباري) "NewsArticle".
• إذا تعذّر على الموصِّل مطابقة تعريف كائن، سيستخدم نوع الكائن الاحتياطي (itemMetadata.objectType). يُرجى الاطّلاع على مَعلمات إعداد البيانات الوصفية.
• يربط الموصِّل أسماء خصائص SharePoint بتعريفات الخصائص.
• يتجاهل الموصِّل نوع الوسائط لملفات Microsoft Outlook التي تحمل الامتداد .msg ويفهرسها على أنّها application/vnd.ms-outlook.

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

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

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

نشر الموصِّل

اتّبِع الخطوات التالية لنشر موصِّل 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، عليك تنفيذ هذه الخطوة. إذا كنت تستخدم قوائم التحكّم بالوصول العلنية، يمكنك تخطّي هذه الخطوة.

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.

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

الوصول إلى SharePoint Online

ربط هويات SharePoint

إنشاء محتوى HTML

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