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

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

สิ่งสำคัญที่ควรพิจารณา

การตั้งค่า SharePoint ที่ได้รับการสนับสนุน

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

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

  • ผู้ใช้ Active Directory
  • กลุ่ม Active Directory
  • SharePoint Local Groups (โดยผู้ใช้และกลุ่มของ Active Directory เป็นสมาชิก)

หากต้องการซิงค์ข้อมูลผู้ใช้และกลุ่ม AD คุณจะใช้ Google Cloud Directory Sync เพื่อเปิดใช้กลุ่มที่มีการจับคู่ข้อมูลประจำตัว หากต้องการซิงค์กลุ่มในเครื่องของ SharePoint ให้ใช้เครื่องมือเชื่อมต่อ SharePoint Identity

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

  • แมป SID สำหรับกลุ่มโดเมนกับ sAMAccountName ที่ตรงกัน
  • แมปผู้ใช้ sAMAccountName กับอีเมลสำหรับการเป็นสมาชิกกลุ่มในเครื่องของ SharePoint

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

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

หากต้องการใช้ API ให้กำหนดค่าสำหรับพารามิเตอร์การสร้าง HTML ในไฟล์การกำหนดค่าเครื่องมือเชื่อมต่อ SharePoint Online พารามิเตอร์เหล่านี้ช่วยให้คุณกำหนดได้ว่าช่องใดจะมีผลกระทบสูงหรือต่ำกว่าการจับคู่

หากต้องการตั้งค่าสคีมา ให้ทำตามวิธีการในหัวข้อสร้างและลงทะเบียนสคีมา เมื่อคุณตั้งค่าสคีมา

  • ในการจับคู่ชื่อของประเภทเนื้อหา SharePoint กับการกำหนดออบเจ็กต์ที่ตรงกัน เครื่องมือเชื่อมต่อจะปรับชื่อประเภทเนื้อหาให้เป็นมาตรฐานโดยการยกเว้นอักขระที่ไม่รองรับ สำหรับคำจำกัดความของออบเจ็กต์ Cloud Search API รองรับเฉพาะอักขระ A-Z, a-z และ 0-9 ที่ถูกต้องเท่านั้น เช่น เนื้อหาประเภท "ประกาศ" จะแมปกับคำจำกัดความของออบเจ็กต์ "ประกาศ" ประเภทเนื้อหา "บทความข่าว" จะแมปกับ "NewsArticle" (ไม่เว้นวรรค)

  • เมื่อเครื่องมือเชื่อมต่อจับคู่การกำหนดออบเจ็กต์กับคำจำกัดความของออบเจ็กต์ไม่ได้ เครื่องมือเชื่อมต่อจะใช้ประเภทออบเจ็กต์สำรอง (itemMetadata.objectType) ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การกำหนดค่าข้อมูลเมตา

  • ในการจับคู่ชื่อพร็อพเพอร์ตี้ SharePoint กับคำจำกัดความของพร็อพเพอร์ตี้ เครื่องมือเชื่อมต่อจะปรับชื่อพร็อพเพอร์ตี้ให้เป็นมาตรฐานโดยถอดรหัสอักขระที่เข้ารหัสเลขฐาน 16 และนำคำนำหน้า "ows_" ออก จากนั้นจึงยกเว้นอักขระที่ไม่รองรับ (อักขระทั้งหมดยกเว้น A-Z, a-z และ 0-9 เป็นอักขระที่ถูกต้อง)

การจัดการข้อความ Microsoft Outlook

เมื่อเครื่องมือเชื่อมต่อพบไฟล์ .msg ของ Microsoft Outlook ขณะที่จัดทำดัชนีเนื้อหา เครื่องมือเชื่อมต่อจะลบล้างประเภทสื่อของไฟล์และจัดทำดัชนีเป็น application/vnd.ms-outlook.

การกำหนดค่ากลุ่มผู้ใช้หลายกลุ่ม

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

วิธีเปิดใช้โหมดการรวบรวมเว็บไซต์

  • ให้สิทธิ์แก่ผู้ดูแลระบบคอลเล็กชันเว็บไซต์ให้กับบัญชีผู้ใช้เครื่องมือเชื่อมต่อ
  • ตั้งค่า sharepoint.server ในไฟล์การกำหนดค่าเครื่องมือเชื่อมต่อเป็น URL การรวบรวมเว็บไซต์ เช่น http://sharepoint.example.com/sites/sitecollection URL ไม่จำเป็นต้องใช้ตัวพิมพ์เหมือนกับใน SharePoint
  • ตั้งค่า sharepoint.siteCollectionOnly ในไฟล์การกำหนดค่าเครื่องมือเชื่อมต่อเป็น true

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

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

  • เวลาที่เครื่องมือเชื่อมต่อใช้ในการตรวจหาการเปลี่ยนแปลงที่เกิดขึ้นกับรายการในฐานข้อมูลจะเพิ่มขึ้นตามจำนวนฐานข้อมูลที่เครื่องมือเชื่อมต่อตรวจสอบ
  • การใช้หน่วยความจำจะเพิ่มขึ้นตามจํานวนผู้ใช้และกลุ่มที่ไม่ซ้ำกันที่คุณใช้ใน ACL สําหรับคอลเล็กชันเว็บไซต์แต่ละรายการ
  • คุณจะกำหนดค่าเครื่องมือเชื่อมต่อด้วยข้อมูลประจำตัวจากโดเมน Active Directory ได้เพียงรายการเดียวเท่านั้น
  • ระบบจะไม่รองรับ Active Directory ทั่วไปและผู้ใช้หลักของ Windows บางรายการ เช่น Everyone, BUILTIN\Users และ All Authenticated Users
  • การแจ้งเตือนการลบจะไม่เกิดขึ้นทันที และอาจใช้เวลามากกว่า 4 ชั่วโมงเพื่อให้เครื่องมือเชื่อมต่อจดจำได้ว่าผู้ใช้ลบเนื้อหาออกจากที่เก็บต้นทางแล้ว

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

ข้อกำหนดของระบบ
ระบบปฏิบัติการ
  • Windows Server 2016
  • Ubuntu
  • Red Hat Enterprise Linux 5.0
  • SUSE Enterprise Linux 10 (64 บิต)
ซอฟต์แวร์
  • เซิร์ฟเวอร์ SharePoint
    • เซิร์ฟเวอร์ SharePoint 2016
    • เซิร์ฟเวอร์ SharePoint 2013
  • Java JRE 1.8 ที่ติดตั้งในคอมพิวเตอร์ที่จะเรียกใช้เครื่องมือเชื่อมต่อ SharePoint On-Prem ของ Google Cloud Search
การตรวจสอบสิทธิ์
  • NTLM
  • Kerberos
  • HTTP พื้นฐาน
  • ADFS

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

สิ่งที่ต้องดำเนินการก่อน

  1. สร้างคีย์ส่วนตัวของ Google Workspace ซึ่งมีรหัสบัญชีบริการ โปรดดูวิธีรับคีย์ส่วนตัวที่หัวข้อ กำหนดค่าการเข้าถึง Google Cloud Search API

  2. ผู้ดูแลระบบ Google Workspace ต้องเพิ่มแหล่งข้อมูลเพื่อค้นหา บันทึกรหัสแหล่งข้อมูล

  3. หากเครื่องมือเชื่อมต่อแสดงผลลัพธ์ตาม ACL (ผลลัพธ์ไม่ได้เป็นแบบสาธารณะ) ผู้ดูแลระบบ Google Workspace จะต้องสร้างแหล่งที่มาของข้อมูลประจำตัว 2 แหล่งและมอบรหัสให้กับคุณดังนี้

    • แหล่งที่มาของข้อมูลประจำตัวสำหรับการซิงค์ผู้ใช้และกลุ่มของ Active Directory
    • แหล่งที่มาของข้อมูลประจำตัวสำหรับกลุ่ม SharePoint Local

    ผู้ดูแลระบบต้องได้รับรหัสลูกค้า Google Workspace ขององค์กรและมอบรหัสดังกล่าวให้คุณด้วย

    ดูวิธีรับค่าเหล่านี้ได้ในส่วนจับคู่ข้อมูลประจำตัวของผู้ใช้ใน Cloud Search

  4. ตั้งค่าบัญชีผู้ใช้สำหรับเครื่องมือเชื่อมต่อที่มีสิทธิ์อ่านแบบเต็มสำหรับเว็บแอปพลิเคชัน SharePoint ในนโยบายผู้ใช้

  5. หากเว็บแอปพลิเคชัน SharePoint ไม่มีคอลเล็กชันเว็บไซต์รูท ให้สร้างคอลเล็กชันใหม่

  6. หากคอลเล็กชันของเว็บไซต์มีการล็อกการเขียน ให้ลงชื่อเข้าใช้เซิร์ฟเวอร์ SharePoint ด้วยบัญชีที่มีสิทธิ์ของผู้ดูแลระบบ และเรียกใช้สคริปต์ PrepareWriteLockedSites.ps1

  7. หากต้องการรับเมตริกแหล่งข้อมูลเพื่อแจ้งการกำหนดค่าเครื่องมือเชื่อมต่อ ให้ลงชื่อเข้าใช้เซิร์ฟเวอร์ SharePoint ด้วยบัญชีที่มีสิทธิ์จัดการฟาร์ม และเรียกใช้ diagnose_sp.ps1

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

ขั้นตอนที่ 1 ติดตั้งซอฟต์แวร์เครื่องมือเชื่อมต่อ SharePoint On-Prem ของ Google Cloud Search

  1. โคลนที่เก็บเครื่องมือเชื่อมต่อจาก GitHub

    $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
    $ cd sharepoint-connector
  2. ตรวจสอบเวอร์ชันเครื่องมือเชื่อมต่อที่ต้องการ

    $ git checkout tags/latest_version

    ตำแหน่ง: latest_version = ค่า เช่น v1-0.0.5

  3. สร้างเครื่องมือเชื่อมต่อ

    $ mvn package

    หากต้องการข้ามการทดสอบเมื่อสร้างเครื่องมือเชื่อมต่อ ให้เรียกใช้ mvn package -DskipTests แทน mvn package

  4. คัดลอกไฟล์ ZIP ของเครื่องมือเชื่อมต่อไปยังไดเรกทอรีการติดตั้งภายในเครื่อง:

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

ขั้นตอนที่ 2 สร้างไฟล์การกำหนดค่าเครื่องมือเชื่อมต่อ SharePoint On-Prem

  1. สร้างไฟล์ในไดเรกทอรีเดียวกับที่ติดตั้งเครื่องมือเชื่อมต่อ Google ขอแนะนำให้คุณตั้งชื่อไฟล์ connector-config.properties เพื่อไม่จำเป็นต้องมีพารามิเตอร์บรรทัดคำสั่งเพิ่มเติมเพื่อเรียกใช้เครื่องมือเชื่อมต่อ หากคุณวางแผนที่จะเรียกใช้อินสแตนซ์เครื่องมือเชื่อมต่อหลายรายการ ให้เพิ่มรายละเอียดลงในชื่อเพื่อแยกความแตกต่าง

  2. เพิ่มพารามิเตอร์เป็นคู่คีย์/ค่าในเนื้อหาไฟล์ ดังตัวอย่างต่อไปนี้

    ### Sharepoint On-Prem Connector configuration ###
    
    # Required parameters for data source access
    api.sourceId=08ef8becd116faa4546b8ca2c84b2879
    api.serviceAccountPrivateKeyFile=service_account.json
    api.identitySourceId=08ef8becd116faa475de26d9b291fed9
    
    # Required parameters for SharePoint on-premises access
    sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
    sharepoint.siteCollectionOnly=true
    sharepoint.username=contoso\\admin
    sharepoint.password=pa$sw0rd
    sharepoint.stripDomainInUserPrincipals=true
    
    # Required parameters for AD lookup
    adLookup.host=dc.contoso.com
    adLookup.username=contoso\\admin
    adLookup.password=pa$sw0rd
    api.referenceIdentitySources=CONTOSO,contoso
    api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
    api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
    
    # Optional parameters for schema mapping
    contentTemplate.sharepointItem.title=Title
    contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
    

    โปรดดูคำอธิบายโดยละเอียดของแต่ละพารามิเตอร์ได้ที่ ข้อมูลอ้างอิงเกี่ยวกับพารามิเตอร์การกำหนดค่า

  3. (ไม่บังคับ) กำหนดค่าพารามิเตอร์เครื่องมือเชื่อมต่อเพิ่มเติมตามต้องการ โปรดดูรายละเอียดที่หัวข้อพารามิเตอร์เครื่องมือเชื่อมต่อที่ Google มีให้

ขั้นตอนที่ 3 สำหรับ HTTPS ให้เพิ่ม SharePoint เป็นโฮสต์ที่เชื่อถือได้

หากมีการกำหนดค่า SharePoint ให้ใช้ HTTPS ให้รับใบรับรอง SharePoint เพื่อเพิ่มเป็นโฮสต์ที่เชื่อถือได้สำหรับเครื่องมือเชื่อมต่อ

  1. ในคอมพิวเตอร์ที่จะเรียกใช้เครื่องมือเชื่อมต่อ ให้เปิดเบราว์เซอร์และไปที่ SharePoint

  2. ในหน้าคำเตือนที่เปิดขึ้น ให้คลิกฉันเข้าใจความเสี่ยงและเพิ่มข้อยกเว้น หน้านี้จะแสดงข้อความ เช่น "การเชื่อมต่อนี้ไม่เชื่อถือ" เนื่องจากใบรับรองเป็นแบบลงนามด้วยตนเองและไม่ได้ลงชื่อโดยผู้ออกใบรับรองที่เชื่อถือได้

  3. เมื่อปุ่มดูพร้อมใช้งาน ให้คลิกปุ่มนั้น

  4. ไปที่แท็บรายละเอียด แล้วคลิกส่งออก

  5. บันทึกใบรับรองในไดเรกทอรีเครื่องมือเชื่อมต่อด้วยชื่อ sharepoint.crt

  6. คลิกปิด แล้วคลิกยกเลิกเพื่อปิดหน้าต่าง

  7. เปิด Command Prompt แล้วป้อนคำสั่งต่อไปนี้

    $ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

    เมื่อได้รับข้อความแจ้งว่า "เชื่อถือใบรับรองนี้ไหม" ให้ตอบว่าใช่

ขั้นตอนที่ 4 ตั้งค่าการบันทึก

  1. ในไดเรกทอรีที่มีไบนารีของเครื่องมือเชื่อมต่อ ให้สร้างโฟลเดอร์ชื่อ logs

  2. ในไดเรกทอรีเดียวกัน (ไม่ใช่ logs) ให้สร้างไฟล์ที่เข้ารหัสแบบ Latin1 ชื่อ logging.properties

  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 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
    

ขั้นตอนที่ 5 กำหนดค่าเครื่องมือเชื่อมต่อข้อมูลประจำตัว SharePoint On-Prem

จำเป็นต้องมีขั้นตอนนี้เพื่อใช้ ACL ตามข้อมูลประจำตัวของ SharePoint On-Prem กับผลการค้นหา หากคุณตั้งค่าเครื่องมือเชื่อมต่อด้วย ACL สาธารณะ คุณสามารถข้ามขั้นตอนนี้ได้

  1. ในไดเรกทอรีเดียวกับการติดตั้งเครื่องมือเชื่อมต่อ SharePoint Online ให้สร้างไฟล์และตั้งชื่อว่า sharepoint-onprem-identity-connector.config

  2. เพิ่มพารามิเตอร์เป็นคู่คีย์/ค่าในเนื้อหาไฟล์ ดังตัวอย่างต่อไปนี้

    ### SharePoint On-prem identity connector configuration ###
    
    # Required parameters for data source access
    api.customerId=C05d3djk8
    api.serviceAccountPrivateKeyFile=service_account.json
    api.identitySourceId=08ef8becd116faa475de26d9b291fed9
    
    # Required parameters for SharePoint access
    sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
    sharepoint.siteCollectionOnly=true
    sharepoint.username=contoso\\admin
    sharepoint.password=pa$sw0rd
    sharepoint.stripDomainInUserPrincipals=true
    
    # Required parameters for AD lookup
    adLookup.host=dc.contoso.com
    adLookup.username=contoso\\admin
    adLookup.password=pa$sw0rd
    api.referenceIdentitySources=CONTOSO,contoso
    api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
    api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
    

    ค่าต่างๆ จะเหมือนกับเครื่องมือเชื่อมต่อ SharePoint On-Prem ยกเว้น api.sourceId พารามิเตอร์จะเป็น api.customerId ค่าของ api.customerId คือรหัสลูกค้าที่คุณได้รับจากผู้ดูแลระบบ Google Workspace

ขั้นตอนที่ 6 เปิดเครื่องมือเชื่อมต่อ SharePoint On-Prem

ในขั้นตอนต่อไปนี้ คุณจะจับคู่ผู้ใช้หลักทั้งใน Active Directory ภายในองค์กรและคอลเล็กชันของเว็บไซต์ SharePoint กับข้อมูลประจำตัวในบริการ Cloud Identity การซิงค์ข้อมูลนี้ดำเนินการผ่าน Google Cloud Directory Sync (GCDS) และเครื่องมือเชื่อมต่อข้อมูลประจำตัว SharePoint On-Prem

หลังจากที่ GCDS ซิงค์ผู้ใช้และกลุ่ม หากต้องการซิงค์ข้อมูลกลุ่มคอลเล็กชันของเว็บไซต์ SharePoint ให้เรียกใช้เครื่องมือเชื่อมต่อข้อมูลประจำตัว SharePoint On-Prem สุดท้าย ให้เรียกใช้เครื่องมือเชื่อมต่อ SharePoing On-Prem เพื่อจัดทำดัชนีและแสดงผลลัพธ์ให้แก่ผู้ใช้ Cloud Search

  1. หากยังไม่ได้กำหนดค่า ให้ กำหนดค่าและเรียกใช้ GCDS ตรวจสอบว่าได้เปิดใช้กลุ่มการจับคู่ข้อมูลประจำตัวแล้ว

  2. เรียกใช้เครื่องมือเชื่อมต่อข้อมูลประจำตัว SharePoint On-Prem ด้วยคำสั่งต่อไปนี้

    $ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-version.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-onprem-identity-connector.config
  3. เรียกใช้เครื่องมือเชื่อมต่อ SharePoint On-Prem ใช้ไวยากรณ์คำสั่งสำหรับการรักษาความปลอดภัยของเว็บไซต์ SharePoint

    • HTTP (ไม่ต้องใช้โฮสต์ที่เชื่อถือได้):

      $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar
    • HTTPS (เพิ่ม SharePoint เป็นโฮสต์ที่เชื่อถือได้):

      $ java -Djavax.net.ssl.trustStore=cacerts.jks -Djavax.net.ssl.trustStoreType=jks -Djavax.net.ssl.trustStorePassword=changeit -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar

ข้อมูลอ้างอิงพารามิเตอร์การกำหนดค่า

การเข้าถึงแหล่งข้อมูล

การเกริ่นนำ พารามิเตอร์
รหัสแหล่งข้อมูล api.sourceId=1234567890abcdef

ต้องระบุ รหัสแหล่งข้อมูล Google Cloud Search ที่ผู้ดูแลระบบ Google Workspace เป็นผู้ตั้งค่า

เส้นทางไปยังไฟล์คีย์ส่วนตัวของบัญชีบริการ api.serviceAccountPrivateKeyFile=PrivateKey.json

ต้องระบุ เส้นทางไปยังไฟล์คีย์บัญชีบริการ Google Cloud Search

การเข้าถึง SharePoint ภายในองค์กร

การเกริ่นนำ พารามิเตอร์
URL ของเซิร์ฟเวอร์ SharePoint sharepoint.server=http://yoursharepoint.example.com/

ต้องระบุ URL ของเซิร์ฟเวอร์ SharePoint เป็นชื่อโฮสต์แบบเต็ม เช่น http://yoursharepoint.example.com/ หากชื่อโฮสต์ไม่ใช่ชื่อแบบเต็ม คุณต้องตั้งค่าการลบล้าง DNS ในโฮสต์เครื่องมือเชื่อมต่อ

ชื่อผู้ใช้ SharePoint sharepoint.username=YOURDOMAIN\\ConnectorUser

จำเป็นเมื่อคุณเรียกใช้เครื่องมือเชื่อมต่อบน Linux หรือบนเครื่อง Windows ที่ไม่ได้เป็นส่วนหนึ่งของโดเมน SharePoint Server AD

รหัสผ่าน SharePoint sharepoint.password=user_password

จำเป็นเมื่อคุณเรียกใช้เครื่องมือเชื่อมต่อบน Linux หรือบนเครื่อง Windows ที่ไม่ได้เป็นส่วนหนึ่งของโดเมน SharePoint Server AD

ใช้การตรวจสอบสิทธิ์แบบสดเพื่อเชื่อมต่อกับ SharePoint sharepoint.username=AdaptorUser Live Authentication Id

sharepoint.password uS3R_passWoRD

sharepoint.formsAuthenticationMode=LIVE

ใช้การตรวจสอบสิทธิ์ ADFS เพื่อเชื่อมต่อกับ SharePoint sharepoint.username=AdaptorUser@yourdomain.com

sharepoint.password=uS3R_passWoRD

sharepoint.sts.endpoint=https://adfs.example.com/adfs/services/trust/2005/usernamemixed

sharepoint.sts.realm=urn:myserver:sharepoint หรือ https://yoursharepoint.example.com/_trust

sharepoint.formsAuthenticationMode=ADFS

การจัดทำดัชนีคอลเล็กชันของเว็บไซต์

การเกริ่นนำ พารามิเตอร์
ประเภทดัชนี sharepoint.siteCollectionOnly=boolean

ไม่บังคับ ยกเว้นการทำให้ SharePoint แบบหลายกลุ่มผู้ใช้ใช้งานได้ (ดูข้อมูลเพิ่มเติม) ตั้งค่าเป็น "จริง" เพื่อให้เครื่องมือเชื่อมต่อดัชนี sharepoint.server เป็นคอลเล็กชันเว็บไซต์แทนที่จะเป็นเซิร์ฟเวอร์เสมือน ค่าเริ่มต้นคือ Null (ตรวจหาอัตโนมัติ)

การแมปข้อมูลประจำตัวของ SharePoint

การเกริ่นนำ พารามิเตอร์
รหัสแหล่งที่มาของข้อมูลประจำตัว api.identitySourceId=1234567890abcdef

ต้องระบุ รหัสแหล่งที่มาของข้อมูลประจำตัวสำหรับการซิงค์กลุ่มในพื้นที่ของ SharePoint รหัสแหล่งที่มาของ Google Cloud Search ที่ผู้ดูแลระบบ Google Workspace เป็นผู้ตั้งค่า ตามที่อธิบายไว้ในเพิ่มแหล่งข้อมูลเพื่อค้นหา

แหล่งที่มาของข้อมูลประจำตัวอ้างอิง api.referenceIdentitySources=CONTOSO,contoso

รายการแหล่งที่มาของข้อมูลประจำตัวอ้างอิงที่คั่นด้วยคอมมาสำหรับผู้ใช้หลักของไดเรกทอรีที่ใช้งานอยู่ ค่าตรงกับชื่อ NETBIOS ของ Active Directory ของผู้ใช้หลักของไดเรกทอรีที่ใช้งานอยู่

รหัสแหล่งที่มาของข้อมูลประจำตัวอ้างอิง api.referenceIdentitySource.DOMAIN.id=identity-source-id

ต้องระบุ รหัสแหล่งที่มาของข้อมูลประจำตัวสำหรับการซิงค์ผู้ใช้หลักของ Active Directory

การค้นหา Active Directory

การเกริ่นนำ พารามิเตอร์
โฮสต์ Active Directory adLookup.host=host

ต้องระบุ ชื่อโฮสต์ไดเรกทอรีที่ใช้งานอยู่ เช่น dc.contoso.com หรือที่อยู่ IP

พอร์ตการค้นหา Active Directory adLookup.port=port

ไม่บังคับ ค่าเริ่มต้นคือ 389 ใช้ 686 สำหรับ SSL

วิธีค้นหา Active Directory adLookup.method=value

ไม่บังคับ ค่าเริ่มต้นคือ "มาตรฐาน" สำหรับการเชื่อมต่อ HTTPS ให้ตั้งค่าเป็น "ssl"

ผู้ใช้การค้นหา Active Directory adLookup.username=CONTOSO\user1

ต้องระบุ ผู้ใช้ได้รับอนุญาตให้ค้นหาไดเรกทอรีที่ใช้งานอยู่

รหัสผ่านการค้นหา Active Directory adLookup.password=password123

ต้องระบุ รหัสผ่านสำหรับผู้ใช้ที่ระบุโดย adLookup.user

การสร้างเนื้อหา 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

  • ต่อท้าย - เครื่องมือเชื่อมต่อจะสร้างเนื้อหา HTML ที่มีช่องทั้งหมด รวมถึงช่องที่ไม่ได้ตั้งค่าไว้ด้วยระดับคุณภาพ (สูง ปานกลาง หรือต่ำ)
  • IGNORE - เครื่องมือเชื่อมต่อจะสร้างเนื้อหา HTML ที่มีเฉพาะช่องที่แมปเท่านั้น