Zoekbasissen beheren

Met de Crawl Scope Manager (CSM) kunt u zoekaanzetten toevoegen aan en verwijderen uit het verkenningsbereik van Windows Search voor uw gegevensarchieven.

Dit onderwerp bevat de volgende onderwerpen:

• Over Zoekwortelementen
• voordat u begint met
• Windows 7: Nieuwe API voor verkenningsbereikbeheer
• Roots toevoegen aan het verkenningsbereik
• Wortels uit het verkenningsbereik verwijderen
• wortels opsommen in het verkenningsbereik
• Verwante onderwerpen

Over zoekwortels

Een zoekbasis definieert de basis van een Shell-naamruimte waarin specifieke bereiken kunnen worden opgenomen of uitgesloten en is meestal de container op het hoogste niveau binnen een protocol dat kan worden geïnventariseerd. Er wordt niet aangegeven welke delen van dit archief moeten worden geïndexeerd of niet mogen worden geïndexeerd; het geeft alleen aan dat er een inhoudsarchief bestaat en is gekoppeld aan een geregistreerde protocolhandler. De syntaxis voor het identificeren van een zoekhoofd-URL bevat het protocol, de beveiligings-id van de winkel of gebruiker, het pad en eventueel een specifiek item (zoals een bestand). In de volgende voorbeelden ziet u twee vormen van de syntaxis voor een zoekbasis.

<protocol>://<store or SID>\<path>\[item]
or
<protocol>://<store or SID>/<path>/[item]

Het <protocol> segment moet worden gevolgd door twee (2) schuine strepen ('/'), tenzij het om het bestandprotocol gaat, waarvoor drie schuine strepen (file:///) zijn vereist. Het <-site of SID->-segment vertegenwoordigt een inhoudsopslag of een gebruikersbeveiligings-id als de zoekroot specifiek voor de gebruiker bedoeld is. Het <pad> segment is een set containers, zoals directories of mappen, en kan het jokerteken '*' bevatten. Het <item> segment is optioneel en kan ook het jokerteken '*' bevatten. Als u geen item opneemt, moet u ervoor zorgen dat u het padsegment met een slash voltooit of dat de indexeerfunctie ervan uitgaat dat de laatste subcontainer een item is.

Stel dat u een protocolhandler (myPH) hebt geïmplementeerd om bestanden van het type *.myext voor een aangepaste toepassing te verwerken. Al deze bestanden bevinden zich in de map WorkteamA\ProjectFiles op een lokale computer. De zoekbasis hiervoor ziet er als volgt uit:

• myPH:///C:\WorkteamA\ProjectFiles\

Stel dat u van plan bent om alle .myext-bestanden op te nemen in de index, maar niets anders dan die container daarin op te nemen. De zoekbasis hiervoor ziet er als volgt uit:

• myPH:///C:\WorkteamA\ProjectFiles\*.myext.

Jokertekenpatronen definiëren URL's met behulp van het jokerteken '*' en worden beschouwd als een patroon in plaats van een URL, maar de terminologie wordt vaak door elkaar gebruikt. Bijvoorbeeld: file:///C:\ProjectA\*\data\ komt overeen met de volgende URL's:

• C:\ProjectA\versie1\data\
• C:\ProjectA\version2\data\

Dit patroon komt echter niet overeen met deze URL:

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

U moet nieuwe zoekwortels maken voor containers die zich nog niet in het verkenningsbereik van de indexeerder bevinden. Als pad C:\ParentScope al is opgenomen in het verkenningsbereik, hoeft u geen nieuwe zoekbasis toe te voegen voor C:\ParentScope\ChildScope, tenzij u weet dat het subbereik eerder is uitgesloten.

De gebruikersinterface voor het instellen van Windows Search-opties geeft zoekhoofdmappen weer voor gebruikers, zodat ze de bereikregels voor hun zoekopdrachten kunnen verfijnen. Als onderdeel van het installatieproces voor uw aangepaste protocolhandler, container en/of toepassing kunt u een standaard verkenningsbereik definiëren, met insluitings- en uitsluitingsregels. Deze regels worden aan eindgebruikers gepresenteerd als locaties. Gebruikers kunnen navigeren in de submappen van uw vooraf gedefinieerde zoekhoofdmap en de items selecteren die ze willen opnemen in zoekopdrachten of de items wissen die ze willen uitsluiten.

Voordat u begint

Voordat u een van de CSM-interfaces (Crawl Scope Manager) kunt gebruiken, moet u de volgende vereiste stappen uitvoeren:

1. Maak het CrawlSearchManager--object en haal de ISearchManager interface op.
2. Roep ISearchManager::GetCatalog aan voor SystemIndex om een exemplaar van een ISearchCatalogManager interface te verkrijgen.
3. Roep ISearchCatalogManager::GetCrawlScopeManager aan om een exemplaar van ISearchCrawlScopeManager interface te verkrijgen.

Nadat u wijzigingen hebt aangebracht in de Crawl Scope Manager (CSM), moet u ISearchCrawlScopeManager::SaveAllaanroepen. Deze methode heeft geen parameters en retourneert S_OK bij succes.

Windows 7: nieuwe Verkenningsbereikbeheer-API

In Windows 7 en hogerbreidt ISearchCrawlScopeManager2 de functionaliteit van de ISearchCrawlScopeManager interface uit. De ISearchCrawlScopeManager2::GetVersion methode haalt de CSM-versie (Crawl Scope Manager) op, waarmee clients worden geïnformeerd als de status van de CSM is gewijzigd. ISearchCrawlScopeManager2::GetVersion resulteert niet in een interprocess-aanroep. Als de functie slaagt, blijft de geretourneerde aanwijzer geldig totdat de client UnmapViewOfFile- op de aanwijzer aanroept en CloseHandle- op de geretourneerde ingang.

Wortels toevoegen aan het verkenningsbereik

De ISearchCrawlScopeManager vertelt de zoekmachine over containers die moeten worden verkend en/of bekeken, en items onder die containers die moeten worden opgenomen of uitgesloten. Om een nieuwe zoekroot toe te voegen, instantiëert u een ISearchRoot-object, stelt u de root-attributen in en roept u vervolgens ISearchCrawlScopeManager::AddRoot aan, en geeft u een aanwijzer door naar uw ISearchRoot-object. De zoekhoofd-URL heeft dezelfde vorm als de zoekroot die eerder is beschreven.

In de volgende tabel worden de relevante putmethoden voor ISearchRootbeschreven; de andere putmethoden van de interface worden momenteel niet gebruikt door Windows Search. We raden aan de beveiligings-id's (SIDs) van de gebruikers op te nemen in alle root-mappen voor betere beveiliging. Rootstructuren per gebruiker zijn veiliger omdat query's worden uitgevoerd in een gebruiker-specifiek proces, zodat een gebruiker bijvoorbeeld geen items kan zien die zijn geïndexeerd vanuit het postvak in van een andere gebruiker.

Standaard verkent de indexeerfunctie geen bereik wanneer u een zoekbasis toevoegt. U moet ook een insluitingsregel toevoegen voor de root. Als u een gebruikersspecifieke root voor een toepassing wilt toevoegen, moet die toepassing de juiste roots voor nieuwe gebruikers toevoegen wanneer de toepassing wordt gestart.

Ga als volgt te werk om de juiste basisinstellingen toe te voegen voor nieuwe gebruikers:

1. Haal de SID van de gebruiker op.
2. Inventariseer alle wortels om te controleren of er een bestaat voor deze SID.
3. Voeg indien nodig een nieuwe rootmap toe met de SID.

Basispaden verwijderen uit het crawlscope

U kunt ISearchCrawlScopeManager gebruiken om een knoop uit het doorzoekbereik te verwijderen wanneer u deze URL niet meer wilt indexeren. Als u een root verwijdert, worden ook alle bereikregels voor die URL verwijderd. Stel dat u een inhoudsarchief en/of de bijbehorende protocolhandler van een systeem wilt verwijderen. U kunt de toepassing verwijderen, alle gegevens wissen en vervolgens de zoekwortel uit het crawl-bereik verwijderen; daarna verwijdert de Crawl Scope Manager de wortel en alle bereikregels die aan deze wortel zijn gekoppeld.

Als u een bestaande zoekhoofdmap wilt verwijderen, roept u ISearchCrawlScopeManager::RemoveRoot aan met de zoekhoofdmap die u wilt verwijderen. De zoekhoofd-URL heeft dezelfde vorm als de zoekroot die eerder is beschreven. Deze methode retourneert S_FALSE als de hoofdmap niet wordt gevonden en een foutcode als er een fout is opgetreden bij het verwijderen van een hoofdmap die is gevonden.

Als u een zoekhoofdmap verwijdert, wordt de URL ook verwijderd uit de gebruikersinterface voor Windows Search-opties, zodat gebruikers die container of locatie mogelijk niet opnieuw kunnen toevoegen met behulp van de gebruikersinterface. Het is ook mogelijk om alle door de gebruiker ingestelde aanpassingen van een basiszoeklocatie te verwijderen en terug te keren naar de oorspronkelijke basiszoeklocatie en zoekbereikregels. Zie voor meer informatie Bereikregels beheren.

Wortels inventariseren in het verkenningsbereik

De CSM inventariseert zoekhoofdmappen door gebruik te maken van een enumerator-interface in standaard COM-stijl, IEnumSearchRoots. U kunt deze interface gebruiken om zoekrootmappen op te sommen voor diverse doeleinden. U wilt bijvoorbeeld het volledige verkenningsbereik weergeven in een gebruikersinterface of ontdekken of een bepaalde hoofdmap of het onderliggende element van een hoofdmap al in het verkenningsbereik valt.

Verwante onderwerpen

Referentie

ISearchCrawlScopeManager

ISearchRoot

IEnumSearchRoots

conceptuele

De Crawl Scope Manager gebruiken

Bereikregels beheren