Melakukan Deployment Konektor Microsoft SharePoint On-Prem

Panduan ini ditujukan untuk administrator konektor Google Cloud Search SharePoint On-Prem, yaitu siapa saja yang bertanggung jawab untuk mendownload, mengonfigurasi, menjalankan, dan memantau konektor.

Panduan ini berisi petunjuk untuk melakukan beberapa tugas utama terkait deployment konektor SharePoint On-Prem:

Mendownload software konektor Google Cloud Search SharePoint On-Prem
Mengonfigurasi konektor untuk digunakan dengan sumber data SharePoint On-Prem tertentu
Melakukan deployment dan menjalankan konektor

Untuk memahami konsep-konsep dalam dokumen ini, Anda harus mengenal dasar-dasar G Suite, SharePoint lokal.

Ringkasan

Secara default, Google Cloud Search dapat menemukan, mengindeks, dan menayangkan konten dari data G Suite, seperti Google Dokumen dan Gmail. Anda dapat memperluas jangkauan Google Cloud Search untuk menyertakan penayangan konten SharePoint On-Prem kepada pengguna, dengan menggunakan konektor Sharepoint On-Prem.

File properti konfigurasi

Agar konektor dapat menemukan konten dari SharePoint lokal dan menguploadnya ke API pengindeksan, Anda harus memberikan informasi khusus ke konektor dengan membuat file konfigurasi. Selama melakukan langkah-langkah konfigurasi yang dijelaskan dalam Langkah-langkah deployment, Anda membuat file konfigurasi dengan menambahkan parameter.

Selain parameter konektor SharePoint On-Prem yang dijelaskan dalam dokumen ini, ada beberapa parameter konfigurasi yang digunakan oleh semua konektor Cloud Search. Untuk mengetahui informasi selengkapnya, lihat parameter konektor yang disediakan Google.

Sistem operasi yang didukung

Konektor Cloud Search SharePoint On-Prem mendukung sistem operasi berikut:

Windows Server 2016
Ubuntu
Red Hat Enterprise Linux 5.0
SUSE Enterprise Linux 10 (64 bit)

Versi SharePoint yang didukung

Konektor Cloud Search SharePoint On-Prem mendukung SharePoint Server 2016 dan SharePoint Server 2013.

Mengindeks dokumen yang tidak dipublikasikan

Konektor Cloud Search SharePoint On-Prem selalu mengikuti setelan Visibilitas Penelusuran di SharePoint (Anda tidak dapat mengganti setelan ini). Untuk draf dokumen, pengindeksan bergantung pada izin yang diberikan ke akun pengguna konektor. Jika pengguna konektor hanya memiliki izin "Baca Penuh", konektor akan mengikuti semua setelan "Visibilitas draf item" di SharePoint.

Mekanisme autentikasi yang didukung

Konektor Cloud Search SharePoint On-Prem mendukung autentikasi NTLM, Kerberos, HTTP Basic, dan ADFS.

Batasan umum konektor

Berikut adalah daftar batasan umum untuk konektor ini:

Jumlah database konten akan memengaruhi latensi deteksi perubahan dokumen.
Jumlah pengguna dan grup unik yang digunakan dalam ACL untuk setiap koleksi situs akan memengaruhi konsumsi memori.
Versi konektor saat ini hanya mendukung identitas dari satu Domain Direktori Aktif.
Versi konektor saat ini tidak mendukung entity utama Direktori Aktif dan Windows sudah sering digunakan, seperti Everyone, BUILTIN\Users, All Authenticated Users.
Versi konektor saat ini tidak menghasilkan notifikasi penghapusan instan.
Versi konektor saat ini mengandalkan pengindeksan ulang konten untuk mengidentifikasi penghapusan dari repositori sumber. Untuk konten yang telah diindeks sebelumnya, menghapus latensi deteksi dapat memakan waktu lebih dari 4 jam.

Sebelum Anda melakukan deployment konektor Cloud Search SharePoint On-Prem

Konektor Google Cloud Search SharePoint On-Prem dapat diinstal di Linux atau Windows. Sebelum menerapkan konektor Google Cloud Search SharePoint On-Prem, pastikan Anda memiliki komponen yang diperlukan berikut ini:

Windows Server 2016
SharePoint Server 2016 atau SharePoint Server 2013
Java JRE 1.8 yang diinstal pada komputer yang menjalankan konektor Google Cloud Search SharePoint On-Prem
Informasi G Suite yang diperlukan untuk menghubungkan Google Cloud Search dan sumber data:
- Kunci pribadi G Suite (yang berisi ID akun layanan). Untuk mengetahui informasi tentang cara mendapatkan kunci pribadi, lihat Mengonfigurasi akses ke Google Cloud Search REST API.
- ID sumber data G Suite. Untuk mengetahui informasi tentang cara mendapatkan ID sumber data, lihat Menambahkan sumber data untuk melakukan penelusuran.
Biasanya, administrator Google Apps untuk domain dapat menyediakan kredensial ini untuk Anda.
Akun pengguna untuk konektor, dengan izin Baca Penuh untuk Aplikasi Web SharePoint dalam Kebijakan Pengguna
Pastikan bahwa Aplikasi Web telah membuat koleksi situs root. Konektor ini tidak mendukung pengindeksan konten dari aplikasi web yang tidak memiliki koleksi situs root.
Jika ada koleksi situs yang terkunci, jalankan skrip ReadyWriteLockedSitesForAdaptor.ps1 di SharePoint menggunakan akun yang memiliki hak istimewa Admin sebelum menginstal konektor.
Untuk membantu Anda mengonfigurasi konektor ini, login ke server SharePoint menggunakan hak istimewa administrasi layanan dan jalankan diagnose_sp.ps1.

Output dari perintah ini, termasuk jumlah aplikasi web, jumlah dokumen, dan jumlah keanggotaan grup pengguna, dapat membantu memperkirakan jumlah instance konektor yang diperlukan, persyaratan memori, dan jumlah dokumen yang diharapkan.

Langkah-langkah deployment

Untuk melakukan deployment konektor Google Cloud Search SharePoint On-Prem, ikuti langkah-langkah berikut:

Instal software konektor Google Cloud Search SharePoint On-Prem.
Tentukan konfigurasi konektor SharePoint On-Prem.
Konfigurasikan akses ke sumber data Google Cloud Search.
Konfigurasikan akses ke SharePoint On-Prem.
Tambahkan SharePoint sebagai host tepercaya.
Konfigurasikan koleksi situs.
Aktifkan logging.
Konfigurasikan Pemetaan Identitas SharePoint dengan Google Cloud Search.
Konfigurasikan Pencarian Direktori Aktif.
Konfigurasikan dukungan Pembuatan HTML dan Data Terstruktur

1. Instal software konektor Google Cloud Search SharePoint On-Prem.

Instal SDK ke dalam repositori Maven lokal Anda.

Clone repositori SDK dari GitHub. git clone https://github.com/google-cloudsearch/connector-sdk.git cd connector-sdk
Periksa versi SDK yang diinginkan: git checkout tags/v1-0.0.3
Instal komponen SDK: mvn install

Buat konektor.

Clone repositori konektor dari GitHub. git clone https://github.com/google-cloudsearch/sharepoint-connector.git cd sharepoint-connector
Periksa versi konektor yang diinginkan dan buat file ZIP: git checkout tags/v1-0.0.3 mvn package (Untuk melewati tes saat membuat konektor, gunakan mvn package -DskipTests .)

2. Tentukan konfigurasi konektor SharePoint On-Prem

Agar konektor dapat mengakses SharePoint On-Prem dengan benar dan mengindeks konten yang relevan, Anda harus membuat file konfigurasinya terlebih dahulu. Anda mengontrol perilaku dan atribut konektor SharePoint On-Prem dengan menetapkan parameter di file konfigurasi konektor. Kontrol parameter yang dapat dikonfigurasi:

Akses ke sumber data
Akses ke server SharePoint On-Prem
Server SharePoint On-Prem yang diindeks sebagai koleksi situs

Untuk membuat file konfigurasi:

Buka editor teks pilihan Anda dan beri nama file konfigurasi.
Tambahkan pasangan key=value ke konten file seperti yang dijelaskan di bagian berikut.
Simpan dan beri nama file konfigurasi. Google merekomendasikan Anda untuk memberi nama file konfigurasi dengan connector-config.properties sehingga tidak ada parameter command line tambahan yang diperlukan untuk menjalankan konektor.

3. Konfigurasikan akses ke sumber data Google Cloud Search

Parameter pertama yang harus ditentukan oleh setiap file konfigurasi adalah paramenter yang diperlukan untuk mengakses sumber data Cloud Search, seperti yang ditunjukkan pada tabel berikut. Biasanya, Anda akan memerlukan ID sumber data, ID sumber identitas dan jalur ke file kunci pribadi dari akun layanan untuk mengonfigurasi akses konektor ke Cloud Search. Untuk mengetahui lebih lanjut tentang langkah-langkah yang diperlukan untuk menyiapkan sumber data, lihat Menambahkan sumber data untuk melakukan penelusuran.

Setelan	Parameter
ID sumber data	`api.sourceId=1234567890abcdef` Wajib diisi. ID sumber Google Cloud Search yang disiapkan oleh administrator G Suite, seperti yang dijelaskan di bagian Mengelola sumber data pihak ketiga.
Jalur ke file kunci pribadi akun layanan	`api.serviceAccountPrivateKeyFile=./PrivateKey.json` Wajib diisi. File kunci akun layanan Google Cloud Search untuk aksesibilitas konektor SharePoint On-Prem Google Cloud.
ID sumber identitas	`api.identitySourceId=x0987654321` Wajib diisi. ID sumber identitas Cloud Search yang disiapkan oleh administrator G Suite.

4. Konfigurasikan akses ke SharePoint On-Prem

Sebelum konektor dapat mengakses SharePoint On-Prem dan mengekstrak data dari SharePoint untuk pengindeksan, Anda harus mengonfigurasi akses ke server SharePoint. Gunakan parameter berikut untuk menambahkan informasi akses ke file konfigurasi.

Setelan	Parameter
Nama domain yang memenuhi syarat sepenuhnya untuk server SharePoint	`sharepoint.server=http://yoursharepoint.example.com/` Wajib diisi. Jika nama domain tidak memenuhi syarat sepenuhnya, maka Anda harus menyetel penggantian DNS pada host konektor.
Nama pengguna SharePoint	`sharepoint.username=YOURDOMAIN\\ConnectorUser` Wajib diisi saat menjalankan konektor di Linux atau mesin windows yang bukan bagian dari domain Server SharePoint AD.
Sandi SharePoint	`sharepoint.password=user_password` Wajib diisi saat menjalankan konektor di Linux atau mesin windows yang bukan bagian dari domain Server SharePoint AD.
Gunakan Autentikasi Live untuk terhubung ke SharePoint	`sharepoint.username=AdaptorUser Live Authentication Id` `sharepoint.password uS3R_passWoRD` `sharepoint.formsAuthenticationMode=LIVE`
Gunakan Autentikasi ADFS untuk terhubung ke 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` atau `https://yoursharepoint.example.com/_trust` `sharepoint.formsAuthenticationMode=ADFS`

5. Tambahkan SharePoint sebagai host tepercaya

Jika SharePoint dikonfigurasi untuk menggunakan HTTPS, dapatkan sertifikat SharePoint untuk menambahkannya sebagai host tepercaya untuk konektor dengan melakukan langkah-langkah berikut:

Buka SharePoint di browser. Halaman peringatan akan muncul dengan pesan seperti "Koneksi Ini Tidak Tepercaya". Pesan ini muncul karena sertifikat ditandatangani sendiri dan tidak ditandatangani oleh Certificate Authority yang tepercaya. Klik Saya Memahami Risikonya dan Menambahkan Pengecualian.
Tunggu hingga tombol Lihat dapat diklik, lalu klik.
Ubah ke tab "Detail" dan klik "Ekspor".
Simpan sertifikat di direktori konektor Anda dengan nama sharepoint.crt.
Klik Tutup dan Batalkan untuk menutup jendela.
Untuk mengizinkan konektor memercayai SharePoint, buka permintaan perintah dan masukkan perintah berikut: keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint
Saat ditanya "Anda memercayai sertifikat ini?", jawab ya.

6. Konfigurasikan koleksi situs

Secara opsional, Anda bisa mengonfigurasi konektor untuk mengindeks server SharePoint sebagai koleksi situs.

Setelan	Parameter
Apakah server sharepoint adalah koleksi situs, bukan server virtual	`sharepoint.siteCollectionOnly=true` Default terdeteksi secara otomatis. Jika benar maka konektor akan mengindeks `sharepoint.server` sebagai koleksi situs.

7. Aktifkan logging

Buat folder dengan nama logs di direktori yang sama yang berisi biner konektor. Buat file ASCII atau UTF-8 dengan nama logging.properties di direktori yang sama dan tambahkan konten berikut:

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

8. Konfigurasikan Pemetaan Identitas SharePoint dengan Google Cloud Search

Google Cloud Search memungkinkan pelanggannya untuk menerapkan trim ACL pada hasil penelusuran. ACL ini dapat ditetapkan menggunakan entity utama Google serta entity utama eksternal.

Penyiapan SharePoint On-Prem pada umumnya melibatkan tiga entity utama berikut.

Pengguna Direktori Aktif
Grup Direktori Aktif
Grup Lokal SharePoint (dengan pengguna dan grup Direktori Aktif sebagai anggota)

Untuk menerapkan trim keamanan yang sesuai untuk Konten SharePoint, Anda juga perlu menyinkronkan identitas eksternal ini dengan Google.

Gunakan fitur Google Cloud Directory Sync (dengan dukungan tambahan untuk grup yang dipetakan identitasnya) untuk menyinkronkan pengguna dan grup Direktori Aktif.
Gunakan Konektor Identitas SharePoint untuk menyinkronkan grup lokal SharePoint.

Untuk mendukung penyiapan seperti itu, Anda perlu membuat dua sumber identitas.

Sumber identitas untuk menyinkronkan pengguna dan grup Direktori Aktif.
Sumber identitas untuk grup Lokal SharePoint

Setelan	Parameter
ID Sumber Identitas	`api.identitySourceId=1234567890abcdef` ID sumber identitas untuk sinkronisasi Grup Lokal SharePoint. Wajib diisi. ID sumber Google Cloud Search yang disiapkan oleh administrator G Suite, seperti yang dijelaskan dalam Menambahkan sumber data untuk melakukan penelusuran.
Referensi Sumber Identitas	`api.referenceIdentitySources=CONTOSO,contoso` Daftar referensi sumber Identitas untuk entity utama direktori aktif. Nilai harus cocok dengan nama NETBIOS Direktori Aktif untuk entity utama direktori aktif yang dirujuk.
Referensi ID Sumber Identitas	`api.referenceIdentitySource.CONTOSO.id=112233abcd` Wajib diisi. ID Sumber Identitas untuk sinkronisasi entity utama Direktori Aktif untuk domain CONTOSO.

9. Konfigurasikan Pencarian Direktori Aktif

Sementara konektor lain mengandalkan Google Cloud Directory Sync untuk menyinkronkan pengguna dan grup Direktori Aktif, konektor SharePoint perlu melakukan pencarian dengan AD untuk mengambil informasi tambahan tentang entity utama yang disinkronkan. Kasus penggunaan mencakup

Memetakan SID untuk grup domain ke sAMAccountName yang sesuai.
Memetakan sAMAccountName pengguna ke alamat email untuk keanggotaan grup lokal SharePoint.

Setelan	Parameter
Host Direktori Aktif	`adLookup.host=dc.contoso.com` Wajib diisi. Hostname direktori aktif atau alamat IP.
Port pencarian Direktori Aktif	`adLookup.port=389` Opsional. Port defaultnya adalah 389. Gunakan port 686 untuk ssl.
Metode pencarian Direktori Aktif	`adLookup.method=standard` Opsional. Metode defaultnya adalah standar. Gunakan "ssl" untuk koneksi yang aman.
Pengguna pencarian Direktori Aktif	`adLookup.username=CONTOSO\user1` Wajib diisi. Pengguna diizinkan untuk melakukan pencarian direktori aktif.
Sandi pencarian Direktori Aktif	`adLookup.passowrd=password123` Wajib diisi. Sandi untuk pengguna yang ditentukan oleh `adLookup.user`.

10. Konfigurasikan Dukungan Data Terstruktur dan Pembuatan Konten HTML untuk Item Daftar SharePoint

Untuk mengindeks metadata tambahan untuk Item Daftar SharePoint, konfigurasikan konektor untuk mendukung pembuatan konten HTML dan/atau data terstruktur.

Pembuatan konten HTML

Gunakan parameter pada tabel berikut untuk mengonfigurasi pembuatan konten HTML. Untuk mengetahui informasi tentang parameter pembuatan konten HTML opsional, lihat Pembuatan Konten HTML.

Setelan	Parameter
Kolom judul template HTML	`contentTemplate.sharePointItem.title=Title` Kolom SharePoint untuk digunakan sebagai "Judul" untuk HTML yang dibuat.
Konten HTML dengan kolom penelusuran berkualitas tinggi	`contentTemplate.sharePointItem.quality.high=highField1,highField2…` Kolom yang akan disertakan dalam HTML yang dibuat sebagai kolom berkualitas tinggi. Pencocokan istilah kueri penelusuran di kolom ini akan diberi peringkat lebih tinggi.
Konten HTML dengan kolom penelusuran berkualitas sedang	`contentTemplate.sharePointItem.quality.medium=mediumField1, mediumField2…` Kolom yang akan disertakan dalam HTML yang dibuat sebagai kolom berkualitas sedang.
Konten HTML dengan kolom penelusuran berkualitas rendah	`contentTemplate.sharePointItem.quality.low=lowField1, lowField2…` Kolom yang akan disertakan dalam HTML yang dibuat sebagai kolom berkualitas rendah.
Konten HTML dengan kolom yang belum dipetakan	`contentTemplate.sharepointItem.unmappedColumnsMode=IGNORE` Setelan defaultnya adalah abaikan. Konektor membuat HTML hanya dengan menggunakan kolom yang dipetakan. Setel ke APPEND jika Anda ingin menyertakan kolom yang belum dipetakan (tidak menjadi bagian dari konfigurasi tinggi, sedang, rendah) dalam konten HTML yang dibuat.

Dukungan data terstruktur

Konektor akan mengisi data terstruktur untuk item daftar SharePoint, jika skema untuk sumber data ditentukan menggunakan pedoman berikut:

Konektor memetakan nama jenis konten SharePoint ke definisi objek terkait dengan menormalkan nama jenis konten SharePoint sesuai spesifikasi yang ditentukan oleh CloudSearch API. API Cloud Search hanya mendukung A-Z, a-z, dan 0-9 sebagai karakter yang valid untuk definisi objek. Konektor menormalkan nama jenis konten dengan mengecualikan karakter yang tidak didukung. Misalnya, jenis konten "Pengumuman" memetakan ke definisi objek "Pengumuman" sedangkan jenis konten "Artikel Berita" memetakan ke "ArtikelBerita".
Konektor juga mendukung konfigurasi jenis objek fallback melalui konfigurasi itemMetadata.objectType. Konektor menggunakan jenis objek fallback jika tidak ada definisi objek yang sesuai dengan jenis konten SharePoint yang tersedia di skema.
Konektor memetakan nama properti SharePoint ke definisi properti dengan menormalkan nama tampilan untuk kolom SharePoint.

Contoh: File konfigurasi

Contoh file konfigurasi berikut menunjukkan pasangan parameter key=value yang menentukan perilaku konektor contoh.

api.sourceId=08ef8becd116faa4546b8ca2c84b2879
api.serviceAccountPrivateKeyFile=service_account.json
api.identitySourceId=08ef8becd116faa475de26d9b291fed9

# Optional
contentTemplate.sharepointItem.title=Title
contentTemplate.sharepointItem.unmappedColumnsMode=APPEND

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

adLookup.host=dc.contoso.com
adLookup.port=389
adLookup.username=contoso\\admin
adLookup.password=pa$sw0rd

api.referenceIdentitySources=CONTOSO,contoso
api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa

Jalankan konektor identitas SharePoint On-Prem

Agar pengguna dapat memperoleh hasil di Cloud Search untuk konten SharePoint yang dapat mereka akses, penting untuk memetakan entity utama terlebih dahulu baik di Direktori Aktif lokal maupun kumpulan situs SharePoint ke identitas di layanan Google Cloud Identity. Sinkronisasi ini dilakukan melalui aplikasi Google Cloud Directory Sync (GCDS) dan konektor identitas SharePoint On-Prem. Untuk mengetahui langkah-langkah menggunakan GCDS, lihat Tentang Google Directory Sync . Untuk mengetahui informasi tambahan tentang cara mengaktifkan grup yang dipetakan identitasnya, lihat Menyinkronkan grup ke sumber identitas Cloud Search

Setelah GCDS menyinkronkan pengguna dan grup di direktori aktif, jalankan konektor identitas SharePoint On-Prem untuk menyinkronkan grup koleksi situs SharePoint, seperti yang dijelaskan di bawah ini.

Konektor identitas menggunakan file konfigurasi yang mirip dengan file yang digunakan untuk mengindeks konten. Berikut ini adalah sampel file konfigurasi konektor identitas:

api.customerId=C05d3djk8
api.serviceAccountPrivateKeyFile=service_account.json
api.identitySourceId=08ef8becd116faa475de26d9b291fed9

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

adLookup.host=dc.contoso.com
adLookup.port=389
adLookup.username=contoso\\admin
adLookup.password=pa$sw0rd

api.referenceIdentitySources=CONTOSO,contoso
api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa

Perhatikan bahwa file ini berisi properti api.customerId. Properti ini berisi ID akun G Suite Anda. Untuk mengetahui informasi tentang cara membuat customerID, lihat Memetakan identitas pengguna di cloud search.

File JAR yang sama yang digunakan untuk mengindeks konten juga berisi konektor identitas. Untuk menjalankannya, masukkan perintah berikut di direktori yang berisi file konfigurasi:

java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-v<version>-withlib.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector

Jalankan konektor SharePoint On-Prem

Jalankan konektor dengan menggunakan cmd.exe di mesin host:

java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v<version>-withlib.jar

Untuk menjalankan konektor terhadap situs SharePoint yang diamankan oleh HTTP, tambahkan SharePoint sebagai host tepercaya seperti yang dijelaskan di atas.

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-v<version>-withlib.jar

Topik Lanjutan

Informasi di bagian ini tidak lagi menjelaskan tentang konfigurasi konektor SharePoint dasar.

Konfigurasi multi-tenant

Penerapan SharePoint Multi-Tenant biasanya menghosting beberapa situs pelanggan di bawah aplikasi Web yang sama. Pelanggan hanya mendapat izin untuk koleksi situsnya masing-masing. Dalam skenario seperti ini, tidak mungkin untuk mendapatkan izin Baca Penuh pada aplikasi web SharePoint seperti yang diminta oleh konektor SharePoint On-Prem.

Konfigurasi multi-tenant semacam ini didukung melalui mode Hanya Koleksi Situs. Untuk mendukung konfigurasi multi-tenant, mode koleksi situs harus diaktifkan dengan menggunakan opsi konfigurasi sharepoint.siteCollectionOnly di file connector-config.properties.

Untuk mengindeks koleksi situs di tingkat root dalam mode hanya koleksi situs, Anda perlu mengatur sharepoint.siteCollectionOnly menjadi true secara eksplisit.

Konektor akan mengindeks koleksi situs dan item turunannya. Karena alasan ini, akun pengguna konektor di SharePoint memerlukan izin administrator koleksi situs.

Jika Anda memiliki beberapa koleksi situs untuk diindeks di lingkungan multi-tenant, Anda perlu mengonfigurasi satu instance konektor untuk masing-masing koleksi situs.

Untuk mengonfigurasi konektor SharePoint On-Prem dalam mode hanya koleksi situs:

Tentukan sharepoint.server sebagai URL koleksi situs, seperti http://sharepoint.example.com/sites/sitecollection.
Jika URL koleksi situs merupakan koleksi situs root (mis. http://sharepoint.example.com ), setel sharepoint.siteCollectionOnly=true secara eksplisit.

URL non-kanonis dalam mode hanya koleksi situs

Konektor SharePoint On-Prem memungkinkan URL non-kanonis dalam mode hanya koleksi situs. Yaitu, URL konektor seperti yang ditentukan oleh opsi konfigurasi sharepoint.server di file connector-config.properties yang tidak harus sama persis dengan di SharePoint.

Mengganti Content-Type untuk file .msg Microsoft Outlook

Jika konektor menemukan file Outlook .msg saat meng-crawl konten, konektor akan mengganti Content-Type untuk file tersebut dan mengindeksnya sebagai application/vnd.ms-outlook.