Share via

Skema Deskripsi Konektor Pencarian

  • Artikel

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 elemen searchConnectorDescriptionType dari 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?

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.

Bagaimana cara kerja File Deskripsi Konektor Pencarian?

Saat file Deskripsi Konektor Pencarian diinstal pada sistem pengguna, pengguna dapat membuka Windows Explorer, mengklik 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).

Apa itu Skema Deskripsi Konektor Pencarian?

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.

Apa Saja Bagian Utama dari Skema?

Tabel berikut mencantumkan bagian utama skema.

Elemen anak Deskripsi
isSearchOnlyItem Mengidentifikasi apakah lokasi yang didukung oleh konektor pencarian hanya pencarian atau cari dan telusuri.
isDefaultSaveLocation Hanya untuk penggunaan pustaka.
isDefaultNonOwnerSaveLocation Hanya untuk penggunaan pustaka.
deskirpsi Menjelaskan konektor pencarian.
iconReference Mengidentifikasi lokasi ikon kustom untuk konektor pencarian.
imageLink Mengidentifikasi lokasi gambar mini kustom untuk konektor pencarian.
pembuat Mengidentifikasi pembuat konektor pencarian.
dateCreated 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 lingkup pencarian.
propertyStore Menentukan lokasi IPropertyStore berbasis XML untuk konektor pencarian ini. IPropertyStore mendukung metadata terbuka konektor pencarian.
includeInStartMenuScope Menentukan apakah lokasi yang diwakili oleh konektor pencarian harus disertakan dalam lingkup pencarian menu Mulai.
domain Mengidentifikasi domain tingkat atas konektor pencarian.
mendukungAdvancedQuerySyntax Menentukan apakah konektor pencarian mendukung Advanced Query Syntax (AQS).
isIndexed Menentukan apakah lokasi yang diwakili oleh konektor pencarian diindeks.

 

Contoh File Deskripsi Konektor Pencarian

Berikut ini adalah contoh file Deskripsi Konektor Pencarian untuk layanan web pencarian federasi.

<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
  <description>Search MSDN. 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>

Sumber Daya Tambahan

Referensi

Elemen searchConnectorDescriptionType (Skema Konektor Pencarian)

Sumber Daya Lainnya

OpenSearch

Pusat Unduh Microsoft