Mengindeks konten SharePoint di Microsoft 365 (pratinjau)

pengindeks SharePoint di Microsoft 365 (pratinjau) mengimpor dokumen dari pustaka dokumen SharePoint dan menjadikannya dapat dicari di Pencarian Azure AI. Langkah-langkah konfigurasi adalah yang pertama, diikuti oleh perilaku dan skenario.

Di Pencarian Azure AI, pengindeks mengekstrak data dan metadata yang dapat dicari dari sumber data. SharePoint dalam pengindeks Microsoft 365 menyediakan fungsionalitas berikut:

• Mengindeks file dan metadata dari satu atau beberapa pustaka dokumen.
• Mengindeks daftar SharePoint dan nilai bidang item, dengan setiap kolom daftar tersedia sebagai bidang sumber untuk pemetaan bidang. Kemampuan ini berada dalam pratinjau, mulai tersedia di REST API 2026-05-01-preview.
• Mengindeks halaman situs ASPX (halaman situs modern). Kemampuan ini berada dalam pratinjau, mulai tersedia di REST API 2026-05-01-preview.
• Indeks konten SharePoint campuran (pustaka dokumen, daftar, dan halaman situs) dalam satu pengindeks menggunakan nilai kontainer allSiteContent. Kemampuan ini berada dalam pratinjau, mulai tersedia di REST API 2026-05-01-preview.
• Mengindeks konten di seluruh subsitus saat includeSubsites=true diatur dalam kueri sumber data. Kemampuan ini berada dalam pratinjau, mulai tersedia di REST API 2026-05-01-preview.
• Mengindeks secara bertahap, hanya memproses file, item daftar, halaman, dan metadata yang baru atau diubah.
• Mendeteksi konten yang dihapus secara otomatis. Penghapusan file, item daftar, atau halaman akan terdeteksi saat pengindeks dijalankan berikutnya, dan dokumen penelusuran terkait akan dihapus dari indeks.
• Mengekstrak teks dan gambar yang dinormalisasi dari dokumen terindeks secara otomatis. Secara opsional, Anda dapat menambahkan set keterampilan untuk pengayaan AI yang lebih dalam, seperti pengenalan karakter optik (OCR) atau pengenalan entitas.
• Mendukung pengimporan daftar kontrol akses dasar (ACL) untuk dokumen dalam versi pratinjau. Mulai pratinjau 2026-05-01, perubahan ACL terdeteksi dan diperbarui secara bertahap pada setiap pengindeks yang berhasil dijalankan untuk item dengan izin unik. Rilis ini juga memperluas penyerapan ACL ke item daftar, halaman situs ASPX, dan grup SharePoint. Untuk langkah-langkah peringatan dan konfigurasi, lihat Gunakan pengindeks SharePoint untuk menyerap metadata izin.
• Mendukung penyerapan label sensitivitas Microsoft Purview dan pengakuan pada waktu kueri. Fungsionalitas ini sedang dalam pratinjau.

Prasyarat

• Lengkapi formulir pendaftaran pratinjau pengindeks. Pendaftaran disetujui secara otomatis.

• Pencarian Azure AI, Tingkat harga dasar atau yang lebih tinggi.

• SharePoint di layanan cloud Microsoft 365 (OneDrive bukan sumber data yang didukung).

• File dalam pustaka dokumen.

• Visual Studio Code dengan ekstensi Klien REST untuk menyiapkan dan menjalankan alur pengindeks.

Pilih penyetelan izin Anda

Sebelum Anda membuat pendaftaran aplikasi di Langkah 3, identifikasi skenario Anda dalam tabel berikut. Perhatikan izin Microsoft Graph yang diperlukan, izin API SharePoint, dan jenis kredensial. Kemudian, ikuti langkah-langkah yang ditautkan di bagian selanjutnya artikel ini untuk menerapkannya.

Saat menyiapkan izin, pertimbangkan informasi berikut:

• Izin yang didelegasikan hanya cocok untuk pengujian skala kecil dan tidak mendukung ingesti ACL.
• Kredensial federasi merupakan metode autentikasi tanpa rahasia yang direkomendasikan. Ini mencakup autentikasi pengindeks dan resolusi grup SharePoint saat kueri.
• Saat Anda menggunakan Sites.Selected, berikan aplikasi akses eksplisit ke setiap situs SharePoint target sebelum mengindeks. Persetujuan admin untuk Sites.Selected di Microsoft Entra ID tidak dengan sendirinya mengotorisasi aplikasi untuk mengakses konten situs. Anda juga harus menetapkan izin pada setiap situs target. Jika Anda menambahkan situs ke sumber data tanpa pemberian izin situs eksplisit, pengindeks gagal. Lihat Memberi akses ke situs saat menggunakan Sites.Selected.

Format dokumen yang didukung

SharePoint dalam pengindeks Microsoft 365 dapat mengekstrak teks dari format dokumen berikut:

• CSV (lihat Mengindeks blob CSV)
• EML
• EPUB
• GZ
• HTML
• JSON (lihat bagian Mengindeks blob JSON)
• KML (XML untuk representasi geografis)
• Markdown
• format Microsoft Office: DOCX/DOC/DOCM, XLSX/XLS/XLSM, PPTX/PPT/PPTM, MSG (email Outlook), XML (XML WORD 2003 dan 2006)
• Format Dokumen Terbuka: ODT, ODS, ODP
• PDF
• File teks biasa (lihat juga Mengindeks teks biasa)
• RTF
• XML
• ZIP

Batasan dan pertimbangan

Berikut adalah batasan fitur ini:

• File buku catatan OneNote tidak didukung.

• Batasan pengindeksan inkremental:

  • Mengganti nama folder SharePoint akan memutus pengindeksan inkremental. Folder yang diganti namanya diperlakukan sebagai konten baru.

  • Microsoft 365 proses yang memperbarui metadata sistem file SharePoint dapat memicu pengindeksan bertahap, bahkan jika tidak ada perubahan lain pada konten. Uji penyiapan Anda sebelum mengandalkan pengindeks atau pengayaan AI. Verifikasi bagaimana Microsoft 365 memproses dokumen Anda.

• Batasan keamanan:

  • Tidak ada dukungan untuk titik akhir privat. Konfigurasi jaringan aman harus diaktifkan melalui firewall.

  • Tidak ada dukungan untuk penyewa dengan Microsoft Entra ID Akses Bersyarat diaktifkan.

  • Tidak ada dukungan untuk file terenkripsi pengguna dan file ZIP yang dilindungi kata sandi. Namun, konten terenkripsi diizinkan jika dilindungi oleh label sensitivitas Microsoft Purview dan jika konfigurasi untuk mempertahankan dan menghormati label tersebut (pratinjau) diaktifkan.

  • Dukungan terbatas untuk izin akses tingkat dokumen. Tingkat dasar sinkronisasi ACL saat ini sedang dalam pratinjau. Untuk detail dan penyiapan, lihat dokumentasi konfigurasi ACL SharePoint. Untuk izin yang diperlukan per skenario, lihat Memilih penyiapan izin Anda.

Berikut adalah beberapa pertimbangan saat menggunakan fitur ini:

• Untuk membuat aplikasi Copilot kustom atau pembuatan tertambah pengambilan (RAG) yang berinteraksi dengan data SharePoint menggunakan Pencarian Azure AI, Microsoft merekomendasikan penggunaan sumber pengetahuan jarak jauh SharePoint. Sumber pengetahuan ini menggunakan API pengambilan Copilot untuk mengkueri konten tekstual langsung dari SharePoint di Microsoft 365, mengembalikan hasil ke mesin pengambilan agenik untuk penggabungan, peringkat, dan rumusan respons. Tidak ada indeks pencarian yang digunakan oleh sumber pengetahuan ini, dan hanya konten tekstual yang dikueri. Pencarian Azure AI tidak mereplikasi data. Ini memberlakukan model izin SharePoint dengan mengembalikan hanya hasil yang diizinkan untuk dilihat oleh setiap pengguna.

• Jika Anda perlu membuat aplikasi Copilot/RAG kustom atau agen AI untuk mengobrol dengan data SharePoint di lingkungan produksi, pertimbangkan untuk terlebih dahulu membangunnya langsung melalui Microsoft Copilot Studio. Jika Copilot Studio tidak memenuhi kebutuhan Anda, pertimbangkan:

  • Membuat konektor kustom dengan webhook SharePoint, memanggil Microsoft Graph API untuk mengekspor data ke kontainer Blob Azure, lalu menggunakan pengindeks blob Azure untuk pengindeksan bertahap.

  • Membuat alur kerja Azure Logic Apps anda sendiri yang menggunakan konektor Azure Logic Apps SharePoint dan konektor Pencarian Azure AI. Konektor Pencarian Azure AI tersedia setelah mencapai ketersediaan umum. Gunakan alur kerja yang dihasilkan oleh wizard portal Azure sebagai titik awal, lalu sesuaikan di perancang Azure Logic Apps untuk menambahkan langkah transformasi yang Anda butuhkan. Alur kerja yang dibuat oleh panduan Pencarian Azure AI adalah alur kerja konsumsi. Untuk beban kerja produksi, beralihlah ke alur kerja aplikasi logika standar untuk menggunakan fitur perusahaan tambahannya.

Terlepas dari pendekatan yang Anda pilih, apakah membangun konektor kustom dengan webhook SharePoint atau membuat alur kerja Azure Logic Apps, pastikan untuk menerapkan langkah-langkah keamanan yang kuat. Langkah-langkah ini termasuk mengonfigurasi tautan privat yang dibagikan, menyiapkan firewall, dan mempertahankan izin pengguna dari sumber serta menghormati izin tersebut saat pemrosesan kueri. Anda juga harus mengaudit dan memantau alur Anda secara teratur.

Jika Anda mengindeks ACL SharePoint, tinjau hubungan grup yang didukung. Grup Microsoft Entra yang berada di dalam grup SharePoint tidak diekspansi.

Mengonfigurasi SharePoint di pengindeks Microsoft 365

Untuk menyiapkan SharePoint di pengindeks Microsoft 365, gunakan REST API pratinjau. Bagian ini menyediakan langkah-langkahnya.

(Opsional) Langkah 1: Aktifkan identitas terkelola yang ditetapkan sistem

Aktifkan identitas terkelola yang ditetapkan sistem agar secara otomatis mendeteksi penyewa Microsoft Entra tempat layanan pencarian diprovisikan.

Lakukan langkah ini jika situs SharePoint dan layanan pencarian berada di penyewa Microsoft Entra yang sama. Lewati langkah ini jika mereka berada di tenant Microsoft Entra yang berbeda. Identitas digunakan untuk deteksi penyewa. Anda juga dapat melewati langkah ini jika Anda ingin memasukkan ID penyewa Microsoft Entra di string koneksi. Untuk menggunakan identitas terkelola yang ditetapkan sistem atau ditetapkan pengguna untuk pengindeksan tanpa rahasia, konfigurasikan izin aplikasi dengan autentikasi tanpa rahasia.

Setelah memilih Simpan, Anda menerima ID objek yang ditetapkan ke layanan pencarian Anda.

Langkah 2: Memutuskan izin mana yang diperlukan pengindeks

Untuk matriks keputusan yang mencakup skenario ACL dan non-ACL, lihat Memilih penyiapan izin Anda. Jika Anda memilih izin yang didelegasikan, token yang didelegasikan pengguna kedaluwarsa setiap 75 menit dan memerlukan pengindeksan manual menggunakan Run Indexer (pratinjau) saat kedaluwarsa. Izin yang didelegasikan hanya direkomendasikan untuk operasi pengujian kecil.

Langkah 3: Membuat pendaftaran aplikasi Microsoft Entra

SharePoint di pengindeks Microsoft 365 menggunakan aplikasi Microsoft Entra untuk autentikasi. Buat pendaftaran aplikasi sebelum Anda mengonfigurasi izin dan kredensialnya.

1. Masuk ke portal Azure.

2. Cari atau navigasi ke Microsoft Entra ID.

3. Pada halaman Gambaran Umum , pilih + Tambahkan>Pendaftaran aplikasi.

   1. Masukkan nama untuk aplikasi Anda.
   2. Pilih Penyewa tunggal saja - nama penyewa.
   3. Lewati langkah penetapan URI. Tidak diperlukan URI pengalihan.
   4. Pilih Daftar.

4. Dari panel kiri, pilih Kelola>izin API.

5. Pilih + Tambahkan izin, lalu pilih Microsoft Graph.

   • Jika pengindeks Anda menggunakan izin API aplikasi, pilih Izin aplikasi.

     • Untuk pengindeksan standar, pilih:

       • Files.Read.All
       • Sites.Read.All

       

     • Jika Anda mengaktifkan ACL penyerapan (pratinjau), izin yang diperlukan bergantung pada jenis item mana (file pustaka dokumen, item daftar, halaman ASPX) dan jenis grup (Microsoft Entra vs. grup situs SharePoint) yang Anda indeks. Sebelum Anda menyelesaikan langkah ini, lihat Izin menurut skenario ACL. Untuk ringkasan berbagai skenario, lihat Pilih penyiapan izin Anda.

       Menggunakan izin aplikasi berarti pengindeks mengakses situs SharePoint dalam konteks layanan. Oleh karena itu, ketika Anda menjalankan pengindeks, pengindeks memiliki akses ke semua konten di penyewa SharePoint, yang memerlukan persetujuan admin penyewa. Rahasia klien atau konfigurasi tanpa rahasia juga diperlukan untuk autentikasi. Menyiapkan mekanisme autentikasi dijelaskan nanti dalam artikel ini di bawah Metode autentikasi yang tersedia hanya untuk izin API aplikasi.

   • Jika pengindeks Anda menggunakan izin API yang didelegasikan, pilih Izin yang didelegasikan, lalu pilih:

     • Files.Read.All
     • Sites.Read.All
     • User.Read

     

     Izin yang didelegasikan memungkinkan klien pencarian tersambung ke SharePoint di bawah identitas keamanan pengguna saat ini.

6. Pilih Berikan persetujuan admin untuk nama penyewa.

   Persetujuan admin penyewa diperlukan saat menggunakan izin API aplikasi. Beberapa tenant dikunci sedemikian rupa sehingga persetujuan admin tenant juga diperlukan untuk izin API yang didelegasikan. Jika salah satu kondisi berlaku, administrator penyewa harus memberikan persetujuan untuk aplikasi Microsoft Entra ini sebelum membuat pengindeks.

   Screenshot yang menunjukkan pemberian izin admin untuk aplikasi Microsoft Entra.

7. Dari panel kiri, pilih Kelola>Autentikasi (Pratinjau).

8. Pada tab Alihkan konfigurasi URI , pilih + Tambahkan URI Pengalihan.

   1. Pilih Aplikasi seluler dan desktop.
   2. Pilih https://login.microsoftonline.com/common/oauth2/nativeclient URI pengalihan.
   3. Pilih Konfigurasikan.

9. Pada tab Pengaturan , aktifkan tombol Perbolehkan alur klien publik , lalu pilih Simpan.

10. Konfigurasikan metode autentikasi pengindeks sesuai dengan kebutuhan solusi Anda.

Memberikan akses situs saat menggunakan Sites.Selected

Jika Anda mengonfigurasi pendaftaran aplikasi dengan Sites.Selected, selesaikan langkah-langkah berikut sebelum menjalankan pengindeks. Persetujuan admin untuk Sites.Selected di Microsoft Entra ID hanya memungkinkan aplikasi untuk menggunakan izin SharePoint terlingkup. Ini tidak memberikan akses ke situs apa pun sampai Anda menetapkan izin situs secara terpisah.

1. Di Microsoft Entra ID: Tambahkan Sites.Selected ke pendaftaran aplikasi dan berikan persetujuan admin. Tambahkan izin di bawah permukaan API yang diperlukan skenario Anda, seperti Microsoft Graph dan, untuk skenario penyerapan ACL, SharePoint.

2. Di SharePoint: Tetapkan peran izin aplikasi di setiap situs target. Untuk mengindeks konten, berikan setidaknya akses baca.

   Untuk memberikan izin situs, gunakan Microsoft Graph. Ganti {siteId} dengan ID situs Anda:

   POST https://graph.microsoft.com/v1.0/sites/{siteId}/permissions
   Content-Type: application/json
   
   {
     "roles": ["read"],
     "grantedToIdentities": [
       {
         "application": {
           "id": "<application-client-id>",
           "displayName": "<application-display-name>"
         }
       }
     ]
   }
   

   Untuk memberikan izin yang sama dengan menggunakan PnP PowerShell:

   Grant-PnPEntraIDAppSitePermission `
     -AppId "<application-client-id>" `
     -DisplayName "<application-display-name>" `
     -Site "https://<tenant>.sharepoint.com/sites/<site-name>" `
     -Permissions Read
   

Metode autentikasi yang tersedia hanya untuk izin API aplikasi

Untuk mengautentikasi aplikasi Microsoft Entra dengan izin aplikasi, pengindeks menggunakan rahasia klien atau konfigurasi tanpa rahasia.

Menggunakan rahasia klien

Instruksi ini mengonfigurasi aplikasi untuk menggunakan rahasia klien untuk mengautentikasi pengindeks, sehingga dapat menyerap data dari SharePoint.

• Pilih Sertifikat & Rahasia dari menu di sebelah kiri, lalu pilih Rahasia klien dan Rahasia klien baru.

  

• Di menu yang muncul, masukkan deskripsi untuk rahasia klien baru. Sesuaikan tanggal kedaluwarsa jika perlu. Jika rahasia kedaluwarsa, Anda perlu membuatnya kembali dan memperbarui pengindeks dengan rahasia baru.

  

• Rahasia klien baru muncul di daftar rahasia. Setelah Anda menavigasi jauh dari halaman, rahasia tidak terlihat, jadi salin nilai dengan menggunakan tombol salin dan simpan di lokasi yang aman.

  

Menggunakan autentikasi tanpa rahasia untuk mendapatkan token aplikasi

Gunakan kredensial federasi untuk masuk tanpa rahasia klien. Microsoft Entra mempercayai identitas terkelola untuk mendapatkan token aplikasi, sehingga pengindeks dapat menyerap data dari SharePoint tanpa rahasia yang disimpan. Bagian berikutnya menjelaskan cara mengonfigurasi identitas terkelola.

Mengonfigurasi aplikasi terdaftar dengan identitas terkelola

1. Buat (atau pilih) identitas terkelola yang ditetapkan pengguna dan tetapkan ke layanan pencarian Anda atau identitas terkelola yang ditetapkan sistem, tergantung pada persyaratan skenario Anda.

2. Ambil ID objek (utama). Gunakan nilai ini sebagai bagian dari konfigurasi kredensial saat Anda membuat sumber data.

3. Pilih Sertifikat & Rahasia dari menu di sebelah kiri.

4. Di bawah Kredensial federasi pilih + Tambahkan kredensial.

5. Di bawah Skenario kredensial terfederasi, kemudian pilih Identitas Terkelola.

6. Pilih identitas terkelola: Pilih identitas terkelola yang dibuat di langkah 1.

7. Tambahkan nama untuk kredensial Anda dan pilih Simpan.

Langkah 4: Membuat sumber data

Mulai dari bagian ini, gunakan pratinjau terbaru REST API dan klien REST atau SDK beta terbaru yang didukung dari preferensi Anda untuk langkah-langkah yang tersisa.

Sumber data menentukan data mana yang akan diindeks, kredensial, dan kebijakan untuk mengidentifikasi perubahan data secara efisien (baris baru, dimodifikasi, atau dihapus). Beberapa pengindeks dalam layanan pencarian yang sama dapat menggunakan sumber data yang sama.

Untuk pengindeksan SharePoint, sumber data harus memiliki properti yang diperlukan berikut:

• nama adalah nama unik sumber data dalam layanan pencarian Anda.
• jenis harus "sharepoint". Nilai ini peka huruf besar/kecil.
• credentials menyediakan titik akhir SharePoint dan metode autentikasi yang diizinkan bagi aplikasi untuk meminta token Microsoft Entra. Contoh titik akhir SharePoint adalah https://[your-tenant-name].sharepoint.com/teams/MySharePointSite. Anda bisa mendapatkan titik akhir dengan menavigasi ke halaman beranda situs SharePoint Anda dan menyalin URL dari browser. Tinjau format string koneksi untuk sintaks yang didukung.
• kontainer menentukan pustaka dokumen mana yang akan diindeks. Properti mengontrol dokumen mana yang diindeks.

Untuk membuat sumber data, panggil Buat Sumber Data (pratinjau).

Berikut adalah sampel definisi sumber data untuk kredensial dengan rahasia aplikasi atau identitas terkelola yang ditetapkan sistem.

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-datasource",
    "type" : "sharepoint",
    "credentials" : { "connectionString" : "[connection-string]" },
    "container" : { "name" : "defaultSiteLibrary", "query" : null }
}

Konfigurasi kredensial federasi memerlukan FederatedCredentialApplicationId dalam string koneksi. Nilai berbeda menurut jenis identitas:

• Identitas terkelola yang ditetapkan sistem: Atur FederatedCredentialApplicationId ke ID aplikasi (klien) identitas terkelola yang ditetapkan sistem milik layanan. Hilangkan blok identity.
• Identitas terkelola yang ditetapkan pengguna: Berikan identity blok dengan jalur sumber daya identitas terkelola yang ditetapkan pengguna. Atur FederatedCredentialApplicationId ke ID aplikasi (klien) identitas terkelola yang ditetapkan pengguna.

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-datasource",
    "type" : "sharepoint",
    "credentials" : { "connectionString" : "[connection-string]" },
    "container" : { "name" : "defaultSiteLibrary", "query" : null },
    "identity": {
      "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
      "userAssignedIdentity": "/subscriptions/[Azure subscription ID]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[user-assigned managed identity]"
    }
}

Format string koneksi

Format string koneksi berubah berdasarkan apakah pengindeks menggunakan izin API yang didelegasikan atau izin API aplikasi.

• Format string koneksi izin API yang didelegasikan

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID]

• Izin API Aplikasi dengan format string koneksi rahasia aplikasi

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];ApplicationSecret=[Microsoft Entra application client secret];TenantId=[SharePoint site's Microsoft Entra tenant ID]

• Izin API aplikasi dengan format string koneksi tanpa rahasia (kredensial identitas federasi):

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];FederatedCredentialApplicationId=[managed identity's application (client) ID];TenantId=[SharePoint site's Microsoft Entra tenant ID]

Tabel berikut ini menjelaskan setiap bidang string koneksi.

Saat menyiapkan izin, pertimbangkan informasi berikut:

Untuk kompatibilitas mundur, pengindeks SharePoint masih menerima FederatedCredentialObjectId (ID objek/utama kredensial identitas federasi pada aplikasi penyerapan) di string koneksi, sehingga sumber data yang ada tetap berfungsi tanpa perubahan. Gunakan FederatedCredentialApplicationId untuk sumber data baru dan yang diperbarui.

Untuk mendapatkan TenantId, buka pusat admin Microsoft Entra untuk penyewa yang memiliki situs SharePoint, dan salin ID Penyewa dari Gambaran Umum.

Anda bisa mendapatkan identitas object (principal) IDterkelola dari bagian Mengonfigurasi aplikasi terdaftar dengan identitas terkelola .

Saat menyiapkan izin, pertimbangkan informasi berikut:

Jika situs SharePoint dan layanan pencarian berada dalam penyewa Microsoft Entra yang sama dan identitas terkelola yang ditetapkan sistem diaktifkan, Anda tidak perlu menyertakan TenantId dalam string koneksi. Jika mereka berada di tenant Microsoft Entra yang berbeda, Anda harus menyertakan TenantId.

Contoh berikut menunjukkan sumber data yang dibuat dengan FederatedCredentialApplicationId:

Identitas terkelola yang ditetapkan sistem dengan kredensial federasi:

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
  "name": "sharepoint-ds",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[system-assigned managed identity's application (client) ID]"
  },
  "container": { "name": "defaultSiteLibrary" }
}

Identitas terkelola yang ditetapkan oleh pengguna dengan kredensial federasi (tenant tunggal):

{
  "name": "sharepoint-uami-fed",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[user-assigned managed identity application (client) ID]"
  },
  "container": { "name": "defaultSiteLibrary" },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
    "userAssignedIdentity": "/subscriptions/[subscription-id]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[uami-name]"
  }
}

Identitas terkelola yang ditetapkan pengguna lintas-tenant dengan kredensial gabungan (tingkat lanjut):

Sebelum menggunakan konfigurasi ini, pastikan identitas terkelola yang ditetapkan pengguna dikonfigurasi dengan kredensial identitas federasi yang memercayai aplikasi Microsoft Entra multitenan. Untuk langkah-langkah penyiapan, lihat Mengonfigurasi aplikasi terdaftar dengan identitas terkelola.

{
  "name": "sharepoint-uami-crosstenantfed",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[multitenant app client ID]"
  },
  "container": { "name": "defaultSiteLibrary" },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
    "userAssignedIdentity": "/subscriptions/[subscription-id]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[uami-name]",
    "federatedIdentityClientId": "[multi-tenant app client ID]"
  }
}

Gunakan konfigurasi identitas terkelola yang ditetapkan pengguna lintas penyewa saat identitas terkelola yang ditetapkan pengguna itu sendiri bergabung ke aplikasi Microsoft Entra multipenyewa. Dalam kasus ini, atur federatedIdentityClientId di blok identity menjadi ID klien aplikasi multitenant, dan atur FederatedCredentialApplicationId dalam string koneksi menjadi ID klien aplikasi multitenant yang sama. Pengaturan FederatedCredentialApplicationId ke ID klien identitas terkelola yang ditetapkan pengguna sendiri dalam skenario ini gagal validasi.

Jika pengindeks Anda menggunakan konfigurasi ACL SharePoint (pratinjau) atau mempertahankan dan mematuhi label sensitivitas Microsoft Purview (pratinjau), tinjau artikel terkait sebelum Anda membuat pengindeks. Setiap fitur memiliki langkah-langkah konfigurasi sumber data, indeks, dan skillset tertentu.

Langkah 5: Membuat indeks

Indeks menentukan bidang dalam dokumen, atribut, dan konstruksi lain yang membentuk pengalaman pencarian.

Untuk membuat indeks, panggil Buat Indeks (pratinjau):

POST https://[service name].search.windows.net/indexes?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-index",
    "fields": [
        { "name": "id", "type": "Edm.String", "key": true, "searchable": false },
        { "name": "metadata_spo_item_name", "type": "Edm.String", "key": false, "searchable": true, "filterable": false, "sortable": false, "facetable": false },
        { "name": "metadata_spo_item_path", "type": "Edm.String", "key": false, "searchable": false, "filterable": false, "sortable": false, "facetable": false },
        { "name": "metadata_spo_item_content_type", "type": "Edm.String", "key": false, "searchable": false, "filterable": true, "sortable": false, "facetable": true },
        { "name": "metadata_spo_item_last_modified", "type": "Edm.DateTimeOffset", "key": false, "searchable": false, "filterable": false, "sortable": true, "facetable": false },
        { "name": "metadata_spo_item_size", "type": "Edm.Int64", "key": false, "searchable": false, "filterable": false, "sortable": false, "facetable": false },
        { "name": "content", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false }
    ]
}

Langkah 6: Membuat pengindeks

Pengindeks menyambungkan sumber data dengan indeks pencarian target dan menyediakan jadwal untuk mengotomatiskan refresh data. Setelah Anda membuat sumber data dan indeks, buat pengindeks.

Untuk membuat pengindeks:

1. Kirim permintaan Buat Pengindeks (pratinjau):

   POST https://[service name].search.windows.net/indexers?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   
   {
       "name" : "sharepoint-indexer",
       "dataSourceName" : "sharepoint-datasource",
       "targetIndexName" : "sharepoint-index",
       "parameters": {
       "batchSize": null,
       "maxFailedItems": null,
       "base64EncodeKeys": null,
       "maxFailedItemsPerBatch": null,
       "configuration": {
           "indexedFileNameExtensions" : ".pdf, .docx",
           "excludedFileNameExtensions" : ".png, .jpg",
           "dataToExtract": "contentAndMetadata"
         }
       },
       "schedule" : { },
       "fieldMappings" : [
           { 
             "sourceFieldName" : "metadata_spo_site_library_item_id", 
             "targetFieldName" : "id", 
             "mappingFunction" : { 
               "name" : "base64Encode" 
             } 
            }
       ]
   }
   

   Untuk sumber data yang menggunakan nilai kontainer allSiteLists, allSitePages, atau allSiteContent, petakan metadata_spo_site_asset_item_id alih-alih metadata_spo_site_library_item_id.

   Saat Anda menggunakan izin aplikasi, Anda dapat melakukan kueri pada indeks ketika proses awal pengindeksan sedang berlangsung, tetapi hanya item yang sudah terindeks yang akan menghasilkan hasil. Tunggu hingga proses selesai untuk cakupan penuh. Instruksi yang tersisa dalam langkah ini hanya berlaku untuk izin yang didelegasikan.

2. Saat Anda membuat pengindeks untuk pertama kalinya, permintaan Buat Pengindeks (pratinjau) menunggu hingga Anda menyelesaikan langkah berikutnya. Anda harus memanggil Dapatkan Status Pengindeks untuk mendapatkan tautan dan memasukkan kode perangkat baru Anda.

   GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

   Jika Anda tidak memanggil Dapatkan Status Pengindeks dalam waktu 10 menit, kode akan kedaluwarsa dan Anda harus membuat ulang sumber data.

3. Salin kode masuk perangkat dari respons Dapatkan Status Pengindeks . Kode masuk perangkat dapat ditemukan di "errorMessage".

   {
       "lastResult": {
           "status": "transientFailure",
           "errorMessage": "To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code <CODE> to authenticate."
       }
   }
   

4. Masukkan kode yang disertakan dalam pesan kesalahan.

   

5. Pengindeks SharePoint di Microsoft 365 mengakses konten SharePoint sebagai pengguna yang masuk. Pengguna yang masuk pada langkah ini adalah pengguna tersebut yang telah masuk. Jadi, jika Anda masuk dengan akun pengguna yang tidak memiliki akses ke dokumen di Pustaka Dokumen yang ingin Anda indeks, pengindeks tidak memiliki akses ke dokumen tersebut.

   Jika memungkinkan, buat akun pengguna organisasi baru dan berikan izin yang tepat yang Anda inginkan untuk dimiliki pengindeks.

6. Setujui izin yang diminta.

   

7. Permintaan awal Buat Pengindeks (pratinjau) selesai jika semua izin yang disediakan sebelumnya sudah benar dan dalam jangka waktu 10 menit.

Saat menyiapkan izin, pertimbangkan informasi berikut:

Jika aplikasi Microsoft Entra memerlukan persetujuan admin dan tidak disetujui sebelum masuk, Anda mungkin melihat layar berikut. Persetujuan admin diperlukan untuk melanjutkan.

Langkah 7: Periksa status pengindeks

Setelah membuat pengindeks, panggil Dapatkan Status Pengindeks:

GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

GET https://[service-name].search.windows.net/indexes/[index-name]/docs?search=*&$count=true&api-version=2026-08-01-preview
api-key: [admin-api-key]

Memperbarui sumber data

Jika Anda tidak memperbarui objek sumber data, pengindeks berjalan sesuai jadwal tanpa interaksi pengguna.

Jika Anda mengubah sumber data saat kode perangkat kedaluwarsa, masuk lagi untuk menjalankan pengindeks. Misalnya, jika Anda mengubah kueri sumber data, masuk lagi dengan menggunakan https://microsoft.com/devicelogin dan mendapatkan kode perangkat baru.

Untuk memperbarui sumber data, ikuti langkah-langkah berikut dengan asumsi kode perangkat yang kedaluwarsa:

1. Panggil Jalankan Pengindeks (pratinjau) untuk memulai eksekusi pengindeks secara manual.

   POST https://[service name].search.windows.net/indexers/sharepoint-indexer/run?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

2. Periksa status pengindeks.

   GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

3. Jika Anda mendapatkan kesalahan yang meminta Anda untuk mengunjungi https://microsoft.com/devicelogin, buka halaman dan salin kode baru.

4. Tempelkan kode ke dalam kotak dialog.

5. Jalankan pengindeks lagi secara manual dan periksa status pengindeks. Kali ini, proses pengindeksan yang dijalankan seharusnya berhasil dimulai.

Metadata dokumen indeks

Jika Anda mengindeks metadata dokumen ("dataToExtract": "contentAndMetadata"), Anda bisa menggunakan metadata berikut untuk pengindeksan.

Pengindeks SharePoint di Microsoft 365 juga mendukung metadata khusus untuk setiap jenis dokumen. Untuk informasi selengkapnya, lihat properti metadata Konten yang digunakan dalam Pencarian Azure AI.

Saat menyiapkan izin, pertimbangkan informasi berikut:

Untuk mengindeks metadata kustom, tentukan "additionalColumns" dalam parameter kueri sumber data.

Mengindeks daftar SharePoint

Daftar SharePoint dapat diindeks dalam pratinjau, mulai dari REST API 2026-05-01-preview. Atur sumber container.name data ke allSiteLists untuk mengindeks semua item daftar dari situs, atau untuk allSiteContent menggabungkan item daftar dengan pustaka dokumen dan halaman situs dalam satu pengindeks. Untuk menyertakan daftar subsitus, tambahkan includeSubsites=true ke container.query.

Untuk pengindeks berbasis daftar atau konten campuran, bidang kunci indeks harus dipetakan dari metadata_spo_site_asset_item_id. Konten item daftar muncul di content bidang sebagai nilai bidang berformat JSON, dan bidang standar metadata_spo_item_* (seperti metadata_spo_item_name, , metadata_spo_item_weburidan metadata_spo_item_last_modified) diisi untuk setiap item daftar.

Memetakan kolom daftar ke bidang indeks

Setiap kolom yang Anda tentukan pada Daftar SharePoint muncul sebagai bidang sumber dengan nama yang sama dengan kolom SharePoint. Gunakan pemetaan bidang untuk memetakan setiap kolom ke bidang indeks.

Misalnya, pertimbangkan Daftar SharePoint dengan kolom berikut.

Tambahkan bidang yang cocok ke definisi indeks Anda, lalu petakan setiap kolom ke bidang targetnya di pengindeks:

{
  "name": "my-sharepoint-list-indexer",
  "dataSourceName": "my-sharepoint-list-ds",
  "targetIndexName": "products-index",
  "fieldMappings": [
    {
      "sourceFieldName": "metadata_spo_site_asset_item_id",
      "targetFieldName": "id",
      "mappingFunction": { "name": "base64Encode" }
    },
    { "sourceFieldName": "Title", "targetFieldName": "productName" },
    { "sourceFieldName": "Price", "targetFieldName": "price" },
    { "sourceFieldName": "InStock", "targetFieldName": "available" },
    { "sourceFieldName": "Category", "targetFieldName": "category" },
    { "sourceFieldName": "metadata_spo_item_last_modified", "targetFieldName": "lastUpdated" },
    { "sourceFieldName": "metadata_spo_item_weburi", "targetFieldName": "itemUrl" }
  ]
}

Pastikan setiap bidang target ada di indeks Anda dengan jenis yang kompatibel (misalnya, Edm.String untuk Title, Edm.Double atau Edm.Int64 untuk Price, Edm.Boolean untuk InStock).

Mengindeks halaman situs ASPX

Anda dapat mengindeks halaman situs ASPX modern dalam pratinjau, mulai dengan REST API versi pratinjau 2026-05-01. Atur sumber data container.name ke allSitePages untuk mengindeks semua halaman di situs, atau ke allSiteContent untuk menggabungkan halaman dengan pustaka dokumen dan daftar dalam satu pengindeks. Untuk menyertakan halaman subsitus, tambahkan includeSubsites=true ke container.query.

Untuk pengindeks berbasis halaman atau konten campuran, bidang kunci indeks harus dipetakan dari metadata_spo_site_asset_item_id. Teks halaman diekstrak ke dalam content bidang, dan bidang standar metadata_spo_item_* (seperti metadata_spo_item_name, , metadata_spo_item_weburidan metadata_spo_item_last_modified) diisi untuk setiap halaman.

Sertakan atau kecualikan menurut jenis file

Atur kriteria penyertaan dan pengecualian di bagian "parameter" dari definisi pengindeks untuk mengontrol file mana yang diindeks.

Untuk menyertakan ekstensi file tertentu, atur "indexedFileNameExtensions" ke daftar ekstensi file yang dipisahkan dengan koma dan diawali titik. Untuk mengecualikan ekstensi file tertentu, atur "excludedFileNameExtensions" ke ekstensi yang ingin Anda lewati. Jika ekstensi yang sama muncul di kedua daftar, pengindeks mengecualikannya dari pengindeksan.

PUT /indexers/[indexer name]?api-version=2026-08-01-preview
{
    "parameters" : { 
        "configuration" : { 
            "indexedFileNameExtensions" : ".pdf, .docx",
            "excludedFileNameExtensions" : ".png, .jpeg" 
        } 
    }
}

Mengontrol dokumen mana yang diindeks

Satu SharePoint dalam pengindeks Microsoft 365 dapat mengindeks konten dari satu atau beberapa pustaka dokumen. Untuk menentukan situs dan pustaka dokumen mana yang akan diindeks, gunakan parameter "kontainer" dalam definisi sumber data.

Bagian "kontainer" sumber data memiliki dua properti untuk tugas ini: "nama" dan "kueri".

Nama

Properti name diperlukan dan harus menjadi salah satu nilai berikut:

Untuk sumber data yang menggunakan allSiteLists, , allSitePagesatau allSiteContent, pemetaan bidang kunci pengindeks harus menggunakan metadata_spo_site_asset_item_id alih-alih metadata_spo_site_library_item_id. Untuk detailnya, lihat Langkah 6: Membuat pengindeks.

Query

Parameter "kueri" dari sumber data terdiri dari pasangan kata kunci/nilai. Gunakan kata kunci berikut. Nilainya adalah URL situs atau URL pustaka dokumen.

Saat menyiapkan izin, pertimbangkan informasi berikut:

Untuk mendapatkan nilai untuk kata kunci tertentu, buka pustaka dokumen yang ingin Anda sertakan atau kecualikan dan salin URI dari browser. Metode ini adalah cara termudah untuk mendapatkan nilai yang akan digunakan dengan kata kunci dalam kueri.

Menangani kesalahan

Untuk pesan Invalid AAD tenant, ID penyewa Microsoft Entra yang hilang, atau ketidakcocokan penyewa yang muncul dalam riwayat eksekusi pengindeks, lihat Memecahkan masalah kesalahan dan peringatan umum pengindeks.

Secara default, SharePoint di pengindeks Microsoft 365 berhenti segera setelah menemukan dokumen dengan jenis konten yang tidak didukung, seperti gambar. excludedFileNameExtensions Gunakan parameter untuk melewati jenis konten tertentu. Namun, Anda mungkin perlu mengindeks dokumen tanpa mengetahui semua tipe konten yang mungkin sebelumnya. Untuk melanjutkan pengindeksan saat pengindeks menemukan jenis konten yang tidak didukung, atur failOnUnsupportedContentType parameter konfigurasi ke false:

PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    ... other parts of indexer definition
    "parameters" : { "configuration" : { "failOnUnsupportedContentType" : false } }
}

Untuk beberapa dokumen, Pencarian Azure AI tidak dapat menentukan tipe konten atau tidak dapat memproses dokumen dari tipe konten yang didukung. Untuk mengabaikan mode kegagalan ini, atur failOnUnprocessableDocument parameter konfigurasi ke false:

"parameters" : { "configuration" : { "failOnUnprocessableDocument" : false } }

File sumber SharePoint menggunakan batas ukuran file sumber bersama dan batas karakter hasil ekstraksi untuk pengindeks mirip blob. Secara default, dokumen berukuran besar diperlakukan sebagai kesalahan. Namun, Anda masih dapat mengindeks metadata penyimpanan dokumen yang terlalu besar jika Anda mengatur indexStorageMetadataOnlyForOversizedDocuments parameter konfigurasi ke true:

"parameters" : { "configuration" : { "indexStorageMetadataOnlyForOversizedDocuments" : true } }

Jika Anda menambahkan kumpulan keterampilan, periksa batas input dan batas layanan downstream dari setiap keterampilan secara terpisah. Keahlian dapat menerima lebih sedikit data daripada yang diekstrak oleh pengindeks SharePoint.

Anda juga dapat melanjutkan pengindeksan jika kesalahan terjadi di titik pemrosesan mana pun, baik saat mengurai dokumen atau saat menambahkan dokumen ke indeks. Untuk mengabaikan sejumlah kesalahan tertentu, atur maxFailedItems parameter konfigurasi dan maxFailedItemsPerBatch ke nilai yang diinginkan. Misalnya:

{
    ... other parts of indexer definition
    "parameters" : { "maxFailedItems" : 10, "maxFailedItemsPerBatch" : 10 }
}

Konten terkait

• video YouTube: SharePoint di pengindeks Microsoft 365
• Pengindeks di Pencarian Azure AI
• Properti metadata konten yang digunakan dalam Pencarian Azure AI
• Indeks konten SharePoint dan sumber lainnya dalam Pencarian Azure AI menggunakan Azure Logic App connectors
• konfigurasi ACL Ingest SharePoint (pratinjau)
• Sinkronkan ACL antara SharePoint dan indeks
• Konfigurasi dukungan grup SharePoint
• Mempertahankan dan menghormati label sensitivitas Microsoft Purview (pratinjau)