Mengelola akar pencarian

Crawl Scope Manager (CSM) memungkinkan Anda untuk menambahkan dan menghapus titik awal pencarian untuk penyimpanan data Anda ke dalam dan dari lingkup cakupan perayapan Windows Search.

Topik ini mencakup subjek berikut:

 

Tentang akar pencarian

Akar pencarian mendefinisikan dasar namespace Shell di mana cakupan tertentu dapat disertakan atau dikecualikan, dan biasanya merupakan kontainer tingkat tertinggi dalam protokol yang dapat dijumlahkan. Ini tidak menentukan bagian mana dari penyimpanan ini yang harus atau tidak boleh diindeks; ini hanya memberi sinyal bahwa penyimpanan konten ada dan dikaitkan dengan penangan protokol terdaftar. Sintaks untuk mengidentifikasi URL akar pencarian mencakup protokol, pengidentifikasi keamanan penyimpanan atau pengguna, jalur, dan secara opsional item tertentu (seperti file). Contoh berikut menunjukkan dua bentuk sintaks untuk akar pencarian.

<protocol>://<store or SID>\<path>\[item]
or
<protocol>://<store or SID>/<path>/[item]

Protokol <> segmen harus diikuti oleh dua (2) garis miring ('/') kecuali jika itu adalah file: protokol, yang memerlukan tiga garis miring (file:///). Segmen situs <atau SID> mewakili penyimpanan konten atau pengidentifikasi keamanan pengguna jika akar pencarian dimaksudkan khusus untuk pengguna. Jalur segmen <> adalah sekumpulan kontainer, seperti direktori atau folder, dan dapat menyertakan karakter wildcard '*'. Item <segmen> bersifat opsional dan juga dapat menyertakan karakter kartu bebas '*'. Jika Anda tidak menyertakan item, pastikan untuk menyelesaikan segmen jalur Anda dengan garis miring atau pengindeks akan mengasumsikan bahwa subkontainer terakhir adalah item.

Misalnya, Anda telah menerapkan handler protokol (myPH) untuk menangani file jenis *.myext untuk aplikasi kustom. Semua file ini akan terletak di folder WorkteamA\ProjectFiles di komputer lokal. Akar pencarian untuk itu mungkin terlihat seperti ini:

  • myPH:///C:\WorkteamA\ProjectFiles\

Misalkan Anda berencana untuk menyertakan semua file .myext tetapi tidak ada yang lain dari kontainer tersebut dalam indeks. Akar pencarian untuk itu mungkin terlihat seperti ini:

  • myPH:///C:\WorkteamA\ProjectFiles\*.myext.

Pola wildcard menunjukkan URL dengan karakter wildcard '*', dan dianggap pola, bukan URL, namun istilah tersebut sering digunakan secara bergantian. Misalnya, file:///C:\ProjectA\*\data\ akan cocok dengan URL berikut:

  • C:\ProjectA\version1\data\
  • C:\ProjectA\version2\data\

Tetapi pola itu tidak akan cocok dengan URL ini:

  • C:\ProjectA\version1\temp\data\

Anda harus membuat akar pencarian baru untuk kontainer yang belum berada dalam lingkup perayapan pengindeks. Jika jalur C:\ParentScope sudah disertakan dalam lingkup perayapan, Anda tidak perlu menambahkan akar pencarian yang baru untuk C:\ParentScope\ChildScope kecuali Anda tahu bahwa cakupan anak sebelumnya dikecualikan.

Antarmuka pengguna untuk mengatur opsi Pencarian Windows menampilkan akar pencarian kepada pengguna sehingga mereka dapat menyempurnakan aturan cakupan untuk pencarian mereka. Sebagai bagian dari proses penginstalan untuk penangan protokol kustom, kontainer, dan/atau aplikasi, Anda dapat menentukan cakupan perayapan default, dengan aturan penyertaan dan pengecualian. Aturan ini disajikan kepada pengguna akhir sebagai lokasi. Pengguna dapat menavigasi dalam subdirektori akar pencarian yang telah ditentukan sebelumnya dan memilih yang ingin mereka sertakan dalam pencarian atau menghapus yang ingin mereka kecualikan.

 

Sebelum Anda mulai

Sebelum dapat menggunakan salah satu antarmuka Crawl Scope Manager (CSM), Anda harus melakukan langkah-langkah prasyarat berikut:

  1. Buat objek CrawlSearchManager dan dapatkan antarmuka ISearchManager.
  2. Panggil ISearchManager::GetCatalog untuk "SystemIndex" guna mendapatkan instans dari antarmuka ISearchCatalogManager.
  3. Panggil ISearchCatalogManager::GetCrawlScopeManager untuk mendapatkan instans antarmuka ISearchCrawlScopeManager.

Setelah membuat perubahan apa pun pada Crawl Scope Manager (CSM), Anda harus memanggil ISearchCrawlScopeManager::SaveAll. Metode ini tidak memerlukan parameter dan mengembalikan S_OK jika berhasil.

 

Windows 7: API Crawl Scope Manager baru

Di Windows 7 dan yang lebih baru, ISearchCrawlScopeManager2 memperluas fungsionalitas antarmukaISearchCrawlScopeManager. Metode ISearchCrawlScopeManager2::GetVersion mendapatkan versi Crawl Scope Manager (CSM), yang memberi tahu klien jika status CSM telah berubah. ISearchCrawlScopeManager2::GetVersion tidak menghasilkan panggilan lintas proses. Jika fungsi berhasil, maka pointer yang dikembalikan tetap valid hingga klien memanggil UnmapViewOfFile pada pointer dan CloseHandle pada handel yang dikembalikan.

 

Menambahkan akar ke cakupan perayapan

ISearchCrawlScopeManager memberi tahu mesin pencari tentang kontainer untuk ditelusuri dan/atau diawasi, serta item di bawah kontainer tersebut yang akan disertakan atau dikecualikan. Untuk menambahkan akar pencarian baru, buat objek ISearchRoot, tetapkan atribut akar, lalu panggil ISearchCrawlScopeManager::AddRoot dan operkan penunjuk ke objek ISearchRoot Anda. URL akar pencarian mengikuti format yang sama dengan akar pencarian yang dijelaskan sebelumnya.

Tabel berikut menjelaskan metode put yang relevan untuk ISearchRoot; metode-metode put dalam antarmuka lainnya saat ini tidak digunakan oleh Windows Search. Sebaiknya masukkan pengidentifikasi keamanan (SID) pengguna di semua akar untuk keamanan yang lebih baik. Akar per pengguna lebih aman karena kueri dijalankan dalam proses per pengguna, memastikan bahwa satu pengguna tidak dapat melihat item yang diindeks dari kotak masuk pengguna lain, misalnya.

Metode Deskripsi
sediakan_Notifikasi Atur ke TRUE jika handler protokol atau aplikasi lain akan memberi tahu mesin pencari tentang perubahan pada URL di bawah akar pencarian. Pemberitahuan menunjukkan bahwa URL perlu diindeks ulang.
put_RootURL Mengatur URL akar dari pencarian saat ini. URL mengambil formulir akar pencarian yang dijelaskan sebelumnya.

 

 

Secara default, pengindeks tidak merayapi cakupan saat Anda menambahkan akar pencarian. Anda juga harus menambahkan aturan sertakan untuk root. Jika Anda ingin menambahkan akar khusus pengguna untuk aplikasi, aplikasi tersebut harus menambahkan akar yang sesuai untuk pengguna baru saat aplikasi dimulai.

Untuk menambahkan akar yang sesuai untuk pengguna baru:

  1. Dapatkan SID pengguna.
  2. Enumerasikan semua akar untuk memeriksa apakah ada untuk SID ini.
  3. Tambahkan root baru, menggunakan SID, jika perlu.

 

Menghapus akar dari cakupan perayapan

Anda dapat menggunakan ISearchCrawlScopeManager untuk menghapus akar dari cakupan perayapan saat Anda tidak lagi ingin URL tersebut diindeks. Menghapus akar juga menghapus semua aturan cakupan untuk URL tersebut. Misalnya, Anda ingin menghapus instalasi penyimpanan konten dan/atau handler protokolnya dari sistem. Anda dapat mencopot pemasangan aplikasi, menghapus semua data, kemudian menghapus akar pencarian dari cakupan perayapan, dan Crawl Scope Manager akan menghapus akar tersebut beserta semua aturan cakupan yang terkait.

Untuk menghapus akar pencarian yang ada, panggil ISearchCrawlScopeManager::RemoveRoot dengan akar pencarian yang ingin Anda hapus. URL akar pencarian mengikuti format yang sama dengan akar pencarian yang dijelaskan sebelumnya. Metode ini mengembalikan S_FALSE jika akar tidak ditemukan dan kode kesalahan jika ada kesalahan saat menghapus akar yang ditemukan.

Menghapus akar pencarian juga menghapus URL dari antarmuka pengguna untuk opsi Windows Search, sehingga pengguna mungkin tidak dapat menambahkan kembali kontainer atau lokasi tersebut menggunakan antarmuka pengguna. Dimungkinkan juga untuk menghapus semua penggantian yang ditetapkan oleh pengguna pada akar pencarian dan mengembalikan ke akar pencarian asli serta aturan cakupan. Untuk informasi selengkapnya, lihat Pengelolaan Aturan Lingkup.

Nota

Di Windows Vista, jika pengguna dihapus melalui Profil Pengguna di Panel Kontrol, CSM akan menghapus semua aturan dan akar sertifikat terkait dengan SID mereka dan menghapus item yang diindeks milik mereka dari katalog. Pada Windows XP, Anda perlu menghapus akar dan aturan pengguna secara manual.

 

 

Menghitung akar dalam cakupan perayapan

CSM menghitung akar pencarian menggunakan antarmuka enumerator gaya COM standar, IEnumSearchRoots. Anda dapat menggunakan antarmuka ini untuk menghitung akar pencarian untuk sejumlah tujuan. Misalnya, Anda mungkin ingin menampilkan seluruh cakupan perayapan di antarmuka pengguna, atau mengetahui apakah akar tertentu atau anak dari akar tersebut sudah termasuk dalam cakupan perayapan.

 

Referensi

ISearchCrawlScopeManager

ISearchRoot

IEnumSearchRoots

Konseptual

Menggunakan Pengelola Lingkup Perayapan

Mengelola Ketentuan Cakupan

 

 

  • Terakhir diperbarui pada