Condividi tramite

Schema della descrizione del connettore di ricerca

Introduce lo schema Descrizione connettore di ricerca usato dalle librerie di Esplora risorse e dai provider di ricerca federati. Lo schema specifica la struttura e i requisiti per i file di descrizione del connettore di ricerca (*.searchConnector-ms) e per searchConnectorDescriptionType elementi dei file Descrizione libreria shell (*.library-ms).

Questo argomento descrive lo schema in relazione ai connettori di ricerca federati. Per altre informazioni sulle librerie e sullo schema della descrizione della libreria, vedere schema della descrizione della libreria .

Questo argomento include le sezioni seguenti:

Che cosa sono i connettori di ricerca?

I connettori di ricerca connettono gli utenti ai dati archiviati nei servizi Web o nei percorsi di archiviazione remota. Con Windows 7, gli utenti possono installare connettori di ricerca per posizioni, ad esempio i servizi Web, in modo da eseguire ricerche in tali posizioni direttamente da Esplora risorse. I connettori di ricerca sono file di descrizione del connettore di ricerca (*.searchConnector-ms) che specificano come connettersi, inviare query e ricevere risultati dal percorso.

Oltre ai servizi Web, i connettori di ricerca possono essere usati per eseguire ricerche negli ambiti degli indici locali creati dai gestori del protocollo. Ad esempio, gli utenti possono cercare messaggi di posta elettronica indicizzati localmente con il gestore del protocollo MAPI usando un connettore di ricerca per l'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 di descrizione del 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 normali elementi della shell.

La modalità di distribuzione del file di descrizione 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 le operazioni seguenti si verifichino quando un utente apre il file osdx o installa il gestore del protocollo:

  • Il file con estensione searchconnector-ms viene creato nella cartella ricerche di Windows (%userprofile%/Search).
  • Viene creato un collegamento al file .searchconnector-ms nella cartella Links degli utenti (%userprofile%/Links).

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

Lo schema della descrizione del connettore di ricerca è un XML Schema che definisce la struttura dei file di descrizione del connettore di ricerca (*.searchConnector-ms). Ogni connettore di ricerca deve avere un file di descrizione del connettore di ricerca che specifica come connettersi, inviare query e ricevere risultati dal percorso.

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.
descrizione Descrive il connettore di ricerca.
icona Reference Identifica la posizione di un'icona personalizzata per il connettore di ricerca.
imageLink Identifica il percorso 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 in ed escludere dall'ambito di ricerca.
propertyStore Specifica il percorso di un basato su XML IPropertyStore per questo connettore di ricerca. Il 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.
supportsAdvancedQuerySyntax 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 di descrizione connettore di ricerca 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 di descrizione connettore di ricerca 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

  • Per altre informazioni sullo schema della descrizione della libreria, vedere schema della descrizione della libreria .
  • Per altre informazioni sull'installazione di un connettore di ricerca, vedere Ricerca federata in Windows.

riferimento

elemento searchConnectorDescriptionType (schema del connettore di ricerca)

altre risorse

OpenSearch

dell'Area download Microsoft