ทำให้เครื่องมือเชื่อมต่อ Microsoft SharePoint Online ใช้งานได้

คุณตั้งค่า Google Cloud Search ให้แสดงผลลัพธ์จากเนื้อหา SharePoint Online ขององค์กรได้นอกเหนือจากเนื้อหา Google Workspace ใช้ เครื่องมือเชื่อมต่อ SharePoint Online ของ Cloud Search และกำหนดค่าให้ เข้าถึงแหล่งข้อมูล SharePoint Online ที่เฉพาะเจาะจง

สิ่งสำคัญที่ต้องคำนึงถึง

โปรดคำนึงถึงข้อควรพิจารณาต่อไปนี้ก่อนที่จะติดตั้งใช้งานตัวเชื่อมต่อ SharePoint Online

การตั้งค่า SharePoint ที่ใช้

ตัวเชื่อมต่อจะใช้การตั้งค่าระดับการเข้าถึงการค้นหาใน SharePoint เสมอ สำหรับเอกสารฉบับร่าง สิทธิ์ในบัญชีผู้ใช้ที่ตัวเชื่อมต่อใช้เพื่อเข้าถึง SharePoint Online จะควบคุมเอกสารฉบับร่างที่ตัวเชื่อมต่อจัดทำดัชนีและแสดง หากบัญชีมีสิทธิ์ "อ่านทั้งหมด" เท่านั้น ตัวเชื่อมต่อจะใช้การตั้งค่า "ระดับการมองเห็นของรายการฉบับร่าง"

นอกจากนี้ คุณยังกำหนดค่าตัวเชื่อมต่อเพื่อจำกัดผลลัพธ์ตามสิทธิ์เข้าถึงบัญชีผู้ใช้ได้ด้วย หากต้องการใช้การตัดแต่งความปลอดภัย ให้ซิงค์ข้อมูลประจำตัวภายนอกเหล่านี้กับ Google Cloud Directory

• ผู้ใช้ Office 365 / Azure AD
• กลุ่มความปลอดภัยของ Office 365 / Azure AD
• กลุ่ม SharePoint (มีผู้ใช้และกลุ่ม Office 365 เป็นสมาชิก)

การเพิ่มประสิทธิภาพการค้นหา

ปรับปรุงประสบการณ์การค้นหาโดยกำหนดค่าตัวเชื่อมต่อให้แสดงผลลัพธ์ที่เกี่ยวข้อง ใช้พารามิเตอร์การสร้าง HTML ในไฟล์การกำหนดค่าเพื่อตั้งค่าระดับ ผลกระทบของฟิลด์

หากต้องการตั้งค่าสคีมา โปรดดูสร้างและลงทะเบียนสคีมา เมื่อตั้งค่าสคีมา ให้ทำดังนี้

• ตัวเชื่อมต่อจะแปลงประเภทเนื้อหา SharePoint ให้เป็นชื่อคำจำกัดความออบเจ็กต์ที่ถูกต้อง (A-Z, a-z, 0-9) เช่น "บทความข่าว" จะกลายเป็น "NewsArticle"
• หากเครื่องมือเชื่อมต่อจับคู่คำจำกัดความออบเจ็กต์ไม่ได้ เครื่องมือจะใช้ประเภทออบเจ็กต์สำรอง (itemMetadata.objectType) ดูพารามิเตอร์การกำหนดค่าข้อมูลเมตา
• ตัวเชื่อมต่อจะแมปชื่อพร็อพเพอร์ตี้ SharePoint กับคำจำกัดความของพร็อพเพอร์ตี้
• ตัวเชื่อมต่อจะลบล้างประเภทสื่อสำหรับไฟล์ .msg ของ Microsoft Outlook และจัดทำดัชนีเป็น application/vnd.ms-outlook

ข้อจำกัดที่ทราบของตัวเชื่อมต่อ

• อินสแตนซ์ของตัวเชื่อมต่อแต่ละรายการจะจัดทำดัชนีเนื้อหาจากคอลเล็กชันเว็บไซต์เดียวเท่านั้น หากต้องการจัดทำดัชนีคอลเล็กชันเว็บไซต์หลายรายการ ให้ตั้งค่าอินสแตนซ์เพิ่มเติม
• การใช้หน่วยความจำจะเพิ่มขึ้นตามจำนวนผู้ใช้และกลุ่มที่ไม่ซ้ำใน ACL
• การลบการแจ้งเตือนอาจใช้เวลานานกว่า 4 ชั่วโมงจึงจะมีผล

ข้อกำหนดของระบบ

ติดตั้งใช้งานเครื่องมือเชื่อมต่อ

ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้งใช้งานตัวเชื่อมต่อ SharePoint Online

ข้อกำหนดเบื้องต้น

1. สร้างคีย์ส่วนตัวของ Google Workspace ดู กำหนดค่าการเข้าถึง Cloud Search API
2. เพิ่มแหล่งข้อมูลเพื่อค้นหาและบันทึกรหัสของแหล่งข้อมูล ดูเพิ่มแหล่งข้อมูลเพื่อค้นหา
3. สำหรับผลลัพธ์ที่อิงตาม ACL ผู้ดูแลระบบต้องสร้างแหล่งข้อมูลประจำตัว 2 แหล่ง (แหล่งหนึ่งสำหรับ 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

หากต้องการใช้ ACL ตามข้อมูลประจำตัว ให้สร้าง 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

หากคุณใช้ ACL ที่อิงตามข้อมูลประจำตัวของ 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 ไปยังไดเรกทอรีการติดตั้ง

ขั้นตอนที่ 6 กำหนดค่าโปรแกรมเชื่อมต่อข้อมูลประจำตัวของ 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