Skema Deskripsi Konektor Pencarian
Memperkenalkan skema Deskripsi Konektor Pencarian yang digunakan oleh pustaka Windows Explorer dan penyedia pencarian federasi. Skema menentukan struktur dan persyaratan untuk file Deskripsi Konektor Pencarian (*.searchConnector-ms) dan untuk searchConnectorDescriptionType elemen file Deskripsi Pustaka Shell (*.library-ms).
Topik ini menjelaskan skema karena berkaitan dengan konektor pencarian federasi. Untuk informasi selengkapnya tentang pustaka dan skema Deskripsi Pustaka, lihat Skema Deskripsi Pustaka .
Topik ini mencakup bagian berikut:
- Apa itu Konektor Pencarian?
- Cara Kerja File Deskripsi Konektor Pencarian?
- Apa Itu Skema Deskripsi Konektor Pencarian?
- Apa Saja Bagian Utama dari Skema?
- Contoh File Deskripsi Konektor Pencarian
- Sumber Daya Tambahan
- Topik terkait
Konektor pencarian menghubungkan pengguna dengan data yang disimpan di layanan web atau lokasi penyimpanan jarak jauh. Dengan Windows 7, pengguna dapat menginstal konektor pencarian untuk lokasi, seperti layanan web, sehingga mereka mencari lokasi tersebut langsung dari Windows Explorer. Konektor pencarian adalah file Deskripsi Konektor Pencarian (*.searchConnector-ms) yang menentukan cara menyambungkan, mengirim kueri ke, dan menerima hasil dari lokasi.
Selain layanan web, konektor pencarian dapat digunakan untuk mencari cakupan indeks lokal yang dibuat oleh penangan protokol. Misalnya, pengguna dapat mencari email yang diindeks secara lokal dengan handler protokol MAPI dengan menggunakan konektor pencarian untuk penyimpanan email tersebut.
Saat file Deskripsi Konektor Pencarian diinstal pada sistem pengguna, pengguna dapat membuka Windows Explorer, klik konektor pencarian di panel navigasi, dan memasukkan kueri pencarian. Windows Explorer mengirim kueri menggunakan informasi dari file Deskripsi Konektor Pencarian, seperti penyedia mana yang akan digunakan dan cakupan pencarian. Hasilnya dikembalikan sebagai item umpan RSS atau Atom dan ditampilkan kepada pengguna seolah-olah mereka adalah item Shell biasa.
Cara Anda menyebarkan file Deskripsi Konektor Pencarian bergantung pada jenis lokasi yang didukung konektor pencarian:
- Dalam file konfigurasi OpenSearch (*.osdx) untuk layanan web Anda
- Sebagai bagian dari penginstalan handler protokol Anda
Anda harus memastikan bahwa hal-hal berikut terjadi ketika pengguna membuka file .osdx atau menginstal handler protokol:
- File .searchconnector-ms dibuat di folder Windows Searches pengguna (%userprofile%/Searches).
- Pintasan ke file .searchconnector-ms dibuat di folder Tautan pengguna (%userprofile%/Links).
Skema Deskripsi Konektor Pencarian adalah skema XML yang menentukan struktur file Deskripsi Konektor Pencarian (*.searchConnector-ms). Setiap konektor pencarian harus memiliki file Deskripsi Konektor Pencarian yang menentukan cara menyambungkan, mengirim kueri ke, dan menerima hasil dari lokasi.
Tabel berikut mencantumkan bagian utama skema.
Elemen turunan | Deskripsi |
---|---|
isSearchOnlyItem | Mengidentifikasi apakah lokasi yang didukung oleh konektor pencarian hanya untuk pencarian atau cari dan telusuri. |
isDefaultSaveLocation | Hanya untuk penggunaan pustaka. |
adalahDefaultNonOwnerSaveLocation | Hanya untuk penggunaan pustaka. |
deskripsi | Menjelaskan konektor pencarian. |
ikon Referensi | Mengidentifikasi lokasi ikon kustom untuk konektor pencarian. |
imageLink | Mengidentifikasi lokasi gambar mini kustom untuk konektor pencarian. |
penulis | Mengidentifikasi penulis konektor pencarian. |
tanggalBuat | Mengidentifikasi tanggal konektor pencarian dibuat. |
templateInfo | Menentukan tipe folder untuk konektor pencarian. |
locationProvider | Menentukan penyedia pencarian yang akan digunakan oleh konektor pencarian ini. |
cakupan | Menentukan lokasi yang akan disertakan dan dikecualikan dari cakupan pencarian. |
propertyStore | Menentukan lokasi IPropertyStore berbasis XML untuk konektor pencarian ini. IPropertyStore mendukung metadata terbuka konektor pencarian. |
termasuk InStartMenuScope | Menentukan apakah lokasi yang diwakili oleh konektor pencarian harus disertakan dalam lingkup pencarian menu Mulai. |
domain | Mengidentifikasi domain tingkat atas konektor pencarian. |
mendukung AdvancedQuerySyntax | Menentukan apakah konektor pencarian mendukung Advanced Query Syntax (AQS). |
isIndexed | Menentukan apakah lokasi yang diwakili oleh konektor pencarian diindeks. |
Berikut ini adalah contoh file Deskripsi Konektor Pencarian untuk layanan web pencarian gabungan.
<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
<description>Search powered by live.com</description>
<isSearchOnlyItem>true</isSearchOnlyItem>
<domain>https://social.msdn.microsoft.com</domain>
<supportsAdvancedQuerySyntax>false</supportsAdvancedQuerySyntax>
<templateInfo>
<folderType>{8FAF9629-1980-46FF-8023-9DCEAB9C3EE3}</folderType>
</templateInfo>
<propertyStore>
<property name="OpenSearchHTMLRolloverTemplate">https://social.msdn.microsoft.com/Search/?Query={searchTerms}</property>
</propertyStore>
<locationProvider clsid="{48E277F6-4E74-4cd6-BA6F-FA4F42898223}">
<propertyBag>
<property name="OpenSearchShortName">MSDN</property>
<property name="OpenSearchQueryTemplate">https://social.msdn.microsoft.com/Search/Feed.aspx?locale=en-US&Query={searchTerms}&format=RSS&StartIndex={startIndex}</property>
<property name="MaximumResultCount" type="uint32">100</property>
</propertyBag>
</locationProvider>
</searchConnectorDescription>
Berikut ini adalah contoh file Deskripsi Konektor Pencarian untuk penangan protokol MAPI.
<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
<description>Microsoft Outlook</description>
<isSearchOnlyItem>true</isSearchOnlyItem>
<includeInStartMenuScope>true</includeInStartMenuScope>
<templateInfo>
<folderType>{91475FE5-586B-4EBA-8D75-D17434B8CDF6}</folderType>
</templateInfo>
<simpleLocation>
<url>mapi://{S-1-5-21-2127521184-1604012920-1887927527-2779359}/</url>
</simpleLocation>
</searchConnectorDescription>
- Untuk informasi selengkapnya tentang skema Deskripsi Pustaka, lihat Skema Deskripsi Pustaka .
- Untuk informasi selengkapnya tentang menginstal konektor pencarian, lihat Pencarian Federasi di Windows.