Mengelola aturan cakupan

Crawl Scope Manager (CSM) memungkinkan Anda menentukan aturan cakupan yang menyertakan atau mengecualikan URL dari lingkup perayapan Windows Search.

CSM memungkinkan Anda melakukan hal berikut:

  • Menambahkan aturan cakupan baru ke seperangkat aturan kerja
  • Menghapus aturan cakupan yang ada
  • Menjabarkan aturan cakupan default
  • Menemukan apakah URL tertentu disertakan atau dikecualikan dari cakupan perayapan atau memiliki aturan cakupan induk atau turunan

 

Topik ini mencakup subjek berikut:

Tentang aturan cakupan

Aturan cakupan adalah aturan yang menyertakan atau mengecualikan URL dalam akar pencarian agar tidak dirayapi dan diindeks. Aturan penyertaan menyebabkan pengindeks menyertakan URL tersebut dalam cakupan scrawl, dan aturan pengecualian menyebabkan pengindeks mengecualikan URL tersebut (dan turunannya) dari cakupan perayapan.

Misalnya, Anda telah menginstal aplikasi baru yang file datanya terletak di folder WorkteamA\ProjectFiles di komputer lokal. Misalkan Anda ingin semuanya dalam folder ProjectFiles diindeks kecuali untuk item di subfolder Prototypes. Dalam situasi ini, Anda memerlukan aturan inklusi untuk myPH:///C:\WorkteamA\ProjectFiles\ dan aturan pengecualian untuk myPH:///C:\WorkteamA\ProjectFiles\Prototypes\.

Ada tiga jenis aturan, dengan urutan prioritas berikut:

  1. Aturan Kebijakan Grup diatur oleh administrator dan dapat mengambil alih semua aturan lainnya.
  2. Aturan pengguna diatur oleh pengguna yang memodifikasi cakupan di antarmuka pengguna opsi Pencarian Windows. Pengguna atau aplikasi lain dapat menghapus semua aturan pengguna dan kembali ke aturan default.
  3. Aturan default biasanya diatur oleh aplikasi untuk menentukan cakupan default. Misalnya, aturan default mungkin diatur ketika penangan protokol atau kontainer baru ditambahkan ke sistem.

Bersama, jenis aturan ini terdiri dari kumpulan aturan kerja yang digunakan oleh Crawl Scope Manager (CSM) untuk menghasilkan daftar lengkap URL yang akan dirayapi. Meskipun aturan default dapat ditimpa oleh aturan kebijakan grup dan oleh aturan pengguna, aturan tersebut dipertahankan dalam seperangkat aturan default mereka sendiri, yang dapat Anda kembalikan kapan saja. Pengindeks merayapi URL dari seperangkat aturan kerja dan menambahkan item, properti, dan konten ke katalog.

Nota

Pengguna dengan akses ke Panel Kontrol dapat memodifikasi aturan melalui antarmuka tersebut. Oleh karena itu, aplikasi yang menawarkan manajemen cakupan harus selalu mendapatkan aturan langsung dari CSM dengan menggunakan metode enumerasi alih-alih mengandalkan salinan aturan pengguna yang disimpan.

 

Aturan pengecualian dapat menentukan URL pola dengan karakter wildcard '*'; misalnya: file:///C:\ProjectA\*\. Aturan pengecualian menggunakan pola ini mencegah pengindeks merayapi folder apa pun di bawah direktori ProjectA. Untuk contoh yang lebih rumit, misalkan ada aturan penyertaan untuk file:///C:\ProjectA\ dan aturan pola pengecualian untuk file:///C:\ProjectA\*\data\*. Dalam hal ini, pengindeks akan merayapi item di:

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

Tetapi pengindeks tidak akan merayapi item di:

  • C:\ProjectA\version1\data\

 

Sebelum Anda mulai

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

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

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

 

Menambahkan aturan ruang lingkup

Aturan kerja yang ditetapkan untuk CSM mencakup aturan pengguna dan default, serta aturan apa pun yang dipaksa oleh kebijakan grup. Aturan pengguna disiapkan oleh pengguna di antarmuka pengguna, dan aturan default dapat diatur oleh salah satu hal berikut ini:

  • Kebijakan grup yang diterapkan oleh administrator sistem (Ini tidak menggunakan antarmuka ISearchCrawlScopeManager.)
  • Penginstalan atau pembaruan aplikasi seperti Windows Search atau handler protokol
  • Aplikasi penyiapan untuk penambahan penyimpanan data atau kontainer baru

ISearchCrawlScopeManager menyediakan dua metode untuk menambahkan aturan cakupan baru, seperti yang dijelaskan dalam tabel berikut. Jalur untuk aturan inklusi untuk sistem file harus diakhir dengan garis miring terbelakang '\' (misalnya, file:///C:\files\), dan jalur untuk aturan pengecualian harus diakhapi dengan tanda bintang (misalnya, file:///c:\files\*). Hanya aturan pengecualian yang dapat berisi URL pola. Selain itu, sebaiknya masukkan pengidentifikasi keamanan pengguna (SID) dalam jalur, untuk keamanan yang lebih baik. Jalur per pengguna lebih aman karena kueri kemudian akan berjalan dalam proses per pengguna, memastikan bahwa satu pengguna tidak dapat melihat item yang diindeks dari kotak masuk pengguna lain, misalnya.

Tabel berikut menjelaskan metode antarmuka ISearchCrawlScopeManager yang digunakan untuk menambahkan aturan cakupan baru.

Metode Deskripsi
AddUserScopeRule Menambahkan aturan untuk URL, seperti yang ditentukan oleh pengguna. Aturan ini mengambil alih aturan default. Gunakan metode ini jika Anda telah menerapkan antarmuka pengguna yang memungkinkan pengguna mengelola aturan cakupan dan URL mereka sendiri.
AddDefaultScopeRule Menambahkan aturan untuk URL, seperti yang ditentukan oleh aplikasi lain seperti handler protokol. Gunakan metode ini ketika Anda telah menerapkan handler protokol baru atau menambahkan penyimpanan data baru. Aturan ini dapat ditimpa oleh aturan pengguna.

 

Setiap metode membawa URL ke lokasi dan bendera yang dapat diindeks yang menentukan apakah URL harus disertakan atau dikecualikan. Parameter fFollowFlags dicadangkan untuk keperluan di masa depan. Saat Anda menambahkan aturan cakupan baru dan Crawl Scope Manager menentukan bahwa aturan sudah ada (berdasarkan URL atau pola yang disediakan), kumpulan aturan kerja diperbarui sehingga (1) aturan lama digantikan oleh aturan baru dan (2) aturan pengguna apa pun yang bertentangan dengan aturan tersebut dihapus.

Tip : Meskipun akar file:// disertakan secara default dalam lingkup perayapan, Program Files tidak diindeks secara default. Oleh karena itu, aplikasi dengan data yang disimpan ke direktori Program Files mereka perlu menambahkan lokasinya sebagai aturan default.

Catatan tentang aturan pengguna

Jika aturan pengguna baru sama dengan aturan default yang ada, aturan pengguna baru akan mengambil alih aturan default dalam seperangkat aturan kerja. Jika aturan pengguna baru sama dengan aturan pengguna yang sudah ada, aturan pengguna lama akan diganti.

Mengatur bendera fOverrideChildren memiliki hasil berikut dalam seperangkat aturan kerja:

  • TRUE mengakibatkan dihapusnya semua aturan anak dari seperangkat aturan kerja (baik aturan pengguna maupun aturan default).
  • FALSE menyebabkan semua aturan default yang merupakan bagian dari aturan pengguna baru ditambahkan kembali ke set aturan kerja. Jika aturan default anak adalah penyertaan dan aturan pengguna baru adalah pengecualian, aturan default diubah menjadi aturan pengguna inklusi.

 

Menghapus aturan cakupan

Anda dapat menggunakan antarmukaISearchCrawlScopeManager untuk menghapus aturan cakupan dari seperangkat aturan kerja. Antarmuka ini menyediakan dua metode berikut untuk menghapus aturan cakupan.

Metode Deskripsi
RemoveScopeRule Menghapus aturan pengguna untuk URL tertentu dari seperangkat aturan kerja. Jika aturan pengguna adalah duplikat dari atau mengambil alih aturan default, aturan default tetap berada dalam seperangkat aturan kerja.
RemoveDefaultScopeRule Menghapus aturan default untuk URL tertentu dari seperangkat aturan kerja dan seperangkat aturan default. Setelah memanggil metode ini, Anda tidak dapat kembali ke aturan default ini dengan menggunakan RevertToDefaultScopes.

 

Setiap metode mengambil URL dan bendera yang menunjukkan apakah aturan yang akan dihapus adalah aturan penyertaan atau pengecualian. Metode ini mengembalikan kesalahan jika aturan dengan URL dan bendera inklusi/pengecualian tersebut tidak ditemukan.

Tip: Jika Anda ingin menghapus cakupan dari cakupan perayapan sepenuhnya, gunakan metode RemoveRoot, yang menghapus akar pencarian dan semua aturan cakupan terkait. Melakukan ini saat menghapus instalasi, misalnya, dianggap sebagai praktik terbaik.

Dimungkinkan juga untuk menghapus semua pengaturan ulang akar pencarian oleh pengguna dan kembali ke akar pencarian asli serta aturan cakupan default. Untuk informasi selengkapnya, lihat bagian berikutnya.

Nota

Di Windows Vista, jika pengguna dihapus melalui Profil Pengguna di Panel Kontrol, CSM menghapus semua aturan dan akar yang menyertakan SID mereka dan menghapus item terindeks mereka dari katalog. Pada Windows XP, Anda harus menghapus akar dan aturan pengguna secara manual.

 

 

Kembali ke aturan default

Mengembalikan ke aturan default menghapus semua aturan pengguna untuk URL atau root dan memulihkan semua aturan default ke seperangkat aturan kerja. Namun, tidak menghapus aturan yang ditetapkan oleh kebijakan grup. MetodeRevertToDefaultScopes tidak mengambil parameter dan mengembalikan kode kesalahan jika tidak dapat kembali ke aturan default.

 

Menentukan aturan cakupan

CSM menghitung aturan cakupan dengan menggunakan antarmuka enumerator gaya COM standar, IEnumSearchScopeRules . Anda dapat menggunakan antarmuka ini untuk menghitung aturan cakupan untuk beberapa tujuan. Misalnya, Anda mungkin ingin menampilkan seluruh set aturan kerja di antarmuka pengguna, atau mengetahui apakah suatu aturan atau turunan dari aturan tersebut sudah termasuk dalam cakupan perayapan.

 

Aturan ruang lingkup penelusuran

CSM juga memungkinkan Anda menentukan apakah URL tertentu disertakan dalam cakupan perayapan dan apakah url tersebut memiliki aturan lingkup induk atau turunan. Anda juga dapat mengetahui mengapa URL disertakan atau dikecualikan dari cakupan perayapan. Metode ini tidak dimaksudkan untuk digunakan dengan URL pola.

Tabel berikut menjelaskan metode ISearchCrawlScopeManager digunakan untuk menambahkan aturan cakupan baru.

Metode Deskripsi
GetParentScopeVersionId Mendapatkan ID versi URL inklusi induk. Anda dapat menggunakan metode ini untuk melihat apakah cakupan induk telah berubah sejak terakhir kali Anda memeriksanya.
Contoh: Jika aplikasi email menggunakan pemberitahuan yang dikelola penyedia, aplikasi tersebut mungkin mendapatkan versi cakupan induk sebelum ditutup dan memeriksa versi lagi saat terbuka. Kemudian aplikasi dapat menentukan apakah perlu mendorong serangkaian pemberitahuan baru ke pengindeks.
MemilikiAturanLingkupAnak Mengembalikan TRUE jika URL yang ditentukan memiliki aturan turunan (aturan yang berlaku untuk aturan turunan di setiap tingkatan dalam hierarki URL-nya).
Contoh: Jika URL file:///C:\Folder\, metode ini mengembalikan TRUE jika CSM memiliki aturan cakupan khusus untuk file:///C:\Folder\Subfolder\.
MemenuhiAturanRuangLingkupInduk Mengembalikan TRUE jika URL yang ditentukan memiliki aturan induk (aturan yang berlaku untuk induk pada tingkat apa pun dalam hierarki URL).
Contoh: Jika URL file:///C:\Folder\Subfolder, metode ini mengembalikan TRUE jika CSM memiliki aturan cakupan khusus untuk file:///C:\Folder\.
IncludedInCrawlScope Mengembalikan TRUE jika URL yang ditentukan disertakan dalam cakupan perayapan.
TermasukDalamRuangLingkupMerayapiEx Mengembalikan nilai dari enumerasi CLUSION_REASON yang menjelaskan mengapa URL disertakan atau dikecualikan dari cakupan perayapan, dan mengambil nilai TRUE jika URL disertakan dalam cakupan perayapan. Metode ini dapat membantu Anda mengidentifikasi konflik dalam seperangkat aturan kerja Anda.

 

 

Nota

Metode IncludedInCrawlScope dan IncludedInCrawlScopeEx menentukan apakah URL akan dirayapi hanya berdasarkan aturan di CSM. Ada kemungkinan alasan lain mengapa URL tidak dirayapi, seperti bit FANCI yang diatur (misalnya, pengguna telah menonaktifkan pengindeksan cepat di kotak dialog Properti folder).

 

Jika Anda yakin bahwa jalur file harus dikecualikan, tetapi dicantumkan sebagai disertakan, pastikan bahwa aturan pengecualian berakhir dengan " jalur<>\*". Jika Anda yakin bahwa file atau jalur file harus disertakan tetapi tidak, pastikan untuk memeriksa pengaturan bit FANCI untuk file atau jalur. Anda dapat melakukan ini dengan mengklik kanan file atau jalur file dan memilih Properti, lalu pastikan Untuk pencarian cepat, izinkan Layanan Pengindeksan untuk mengindeks folder ini kotak centang dipilih. Jika file atau jalur file tidak ditandai untuk pengindeksan di sini, file tidak akan diindeks meskipun berada dalam aturan penyertaan.

Referensi

ISearchCrawlScopeManager

ISearchCrawlScopeManager2

ISearchScopeRule

IEnumSearchScopeRules

Konseptual

Mengelola Dasar-Dasar Pencarian

 

 

  • Terakhir diperbarui pada