Condividi tramite

Schema di descrizione del connettore di ricerca

  • Articolo

Introduce lo schema Search Connector Description usato dalle librerie di Esplora risorse di Windows e dai provider di ricerca federati. Lo schema specifica la struttura e i requisiti per i file Search Connector Description (*.searchConnector-ms) e per gli elementi searchConnectorDescriptionType dei file Della libreria shell (*.library-ms).

In questo argomento viene descritto lo schema in relazione ai connettori di ricerca federati. Per altre informazioni sulle librerie e sullo schema Descrizione libreria, vedere Schema descrizione libreria.

Questo argomento include le sezioni seguenti:

Quali sono i connettori di ricerca?

I connettori di ricerca connettono gli utenti con i dati archiviati nei servizi Web o nelle posizioni di archiviazione remota. Con Windows 7, gli utenti possono installare connettori di ricerca per posizioni, ad esempio servizi Web, in modo da cercare tali posizioni direttamente da Esplora risorse. I connettori di ricerca sono file Search Connector Description (*.searchConnector-ms) che specificano come connettersi, inviare query a e ricevere risultati dalla posizione.

Oltre ai servizi Web, i connettori di ricerca possono essere usati per cercare gli ambiti di indice locali creati dai gestori di protocolli. Ad esempio, gli utenti possono cercare messaggi di posta elettronica indicizzati in locale con il gestore del protocollo MAPI usando un connettore di ricerca per tale archivio di posta elettronica.

Come funzionano i file di descrizione del connettore di ricerca?

Quando i file di descrizione del connettore di ricerca vengono installati nei sistemi degli utenti, gli utenti possono aprire Esplora risorse, fare clic sul connettore di ricerca nel riquadro di spostamento e immettere una query di ricerca. Esplora risorse invia la query usando informazioni dal file Descrizione connettore di ricerca, ad esempio il provider da usare e l'ambito della ricerca. I risultati vengono restituiti come elementi feed RSS o Atom e visualizzati agli utenti come se fossero elementi di Shell regolari.

La distribuzione del file Description del connettore di ricerca dipende dal tipo di percorso supportato dal connettore di ricerca:

  • In un file di configurazione OpenSearch (*.osdx) per il servizio Web
  • Come parte dell'installazione del gestore del protocollo

È necessario assicurarsi che gli elementi seguenti si verifichino quando un utente apre il file con estensione osdx o installa il gestore del protocollo:

  • Il file .searchconnector-ms viene creato nella cartella Ricerche windows degli utenti (%userprofile%/Search).
  • Viene creato un collegamento al file .searchconnector-ms nella cartella Collegamenti degli utenti (%userprofile%/ Links ).

Che cos'è lo schema di descrizione del connettore di ricerca?

Lo schema Search Connector Description è uno schema XML che definisce la struttura dei file Search Connector Description (*.searchConnector-ms). Ogni connettore di ricerca deve avere un file Search Connector Description che specifica come connettersi, inviare query a e ricevere risultati dalla posizione.

Quali sono le parti principali dello schema?

Nella tabella seguente sono elencate le parti principali dello schema.

Elementi figlio Descrizione
isSearchOnlyItem Identifica se i percorsi supportati dal connettore di ricerca sono solo ricerca o ricerca e esplorazione.
isDefaultSaveLocation Solo per l'uso della libreria.
isDefaultNonOwnerSaveLocation Solo per l'uso della libreria.
description Descrive il connettore di ricerca.
iconReference Identifica la posizione di un'icona personalizzata per il connettore di ricerca.
imageLink Identifica la posizione di un'anteprima personalizzata per il connettore di ricerca.
Autore Identifica l'autore del connettore di ricerca.
dateCreated Identifica la data di creazione del connettore di ricerca.
templateInfo Specifica un tipo di cartella per il connettore di ricerca.
locationProvider Specifica il provider di ricerca da usare da questo connettore di ricerca.
ambito Specifica i percorsi da includere e escludere dall'ambito di ricerca.
propertyStore Specifica il percorso di un archivio IPropertyStore basato su XML per questo connettore di ricerca. IPropertyStore supporta i metadati aperti del connettore di ricerca.
includeInStartMenuScope Specifica se il percorso rappresentato dal connettore di ricerca deve essere incluso nell'ambito di ricerca del menu Start.
Dominio Identifica il dominio di primo livello del connettore di ricerca.
supportAdvancedQuerySyntax Specifica se il connettore di ricerca supporta la sintassi di query avanzata (AQS).
isIndexed Specifica se la posizione rappresentata dal connettore di ricerca è indicizzata.

 

Esempi di file di descrizione del connettore di ricerca

Di seguito è riportato un esempio di file Search Connector Description per un servizio Web di ricerca federato.

<?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>

Di seguito è riportato un esempio di file Search Connector Description per un gestore del protocollo 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>

Risorse aggiuntive

Riferimento

elemento searchConnectorDescriptionType (Schema del connettore di ricerca)

Altre risorse

OpenSearch

Area download Microsoft