Compartilhar via

Usando o Gerenciador de Escopo de Rastreamento

  • Artigo

O Gerenciador de Escopo de Rastreamento (CSM) é um conjunto de interfaces que fornece métodos para informar o mecanismo de Pesquisa do Windows sobre contêineres para rastrear e itens nesses contêineres a serem incluídos ou excluídos no catálogo. Os desenvolvedores podem usar o CSM para definir um escopo de rastreamento programaticamente para um novo armazenamento de dados ou manipulador de protocolo. Os administradores podem usar o CSM para exibir índices, raízes de pesquisa e regras de escopo de todos os usuários.

Esta seção é organizada da seguinte maneira:

O que é o Gerenciador de Escopo de Rastreamento?

Para entender o Gerenciador de Escopo de Rastreamento, você deve entender os seguintes termos:

  • Um escopo de rastreamento é um conjunto de URLs que apontam para armazenamentos de dados ou contêineres (armazenamentos de dados de email, bancos de dados, compartilhamentos de arquivos de rede e assim por diante) que o indexador rastreia para itens de índice. Para um armazenamento de dados hierárquico, o escopo de rastreamento pode incluir uma URL pai, mas excluir uma URL filho e vice-versa. Os itens dentro do escopo de rastreamento são indexados; itens fora do escopo de rastreamento são ignorados.
  • Uma raiz de pesquisa é a URL de nível superior que identifica um contêiner ou armazenamento de dados associado a um manipulador de protocolo específico. As raízes de pesquisa podem identificar locais específicos de um usuário, que estão em um computador remoto ou que correspondem a um padrão curinga. Ao adicionar um novo armazenamento de dados ou manipulador de protocolo, você também deve adicionar uma raiz de pesquisa ao escopo do rastreamento.
  • Uma regra de escopo é uma regra que inclui ou exclui URLs em uma raiz de pesquisa de serem rastreadas e indexadas. Por exemplo, suponha que você queira tudo dentro da pasta ProjectFiles indexada, exceto para os Protótipos da subpasta. Você precisaria de uma regra de inclusão para file:///C:\WorkteamA\ProjectFiles\ e uma regra de exclusão para file:///C:\WorkteamA\ProjectFiles\Prototypes\.

O Gerenciador de Escopo de Rastreamento (CSM) é um conjunto de APIs que permite adicionar, remover e enumerar raízes de pesquisa e regras de escopo para o indexador da Pesquisa do Windows. Quando quiser que o indexador comece a rastrear um novo contêiner, você pode usar o CSM para definir as raizes de pesquisa e as regras de escopo para caminhos dentro das raizes de pesquisa. Por exemplo, se você instalar um novo manipulador de protocolo, poderá criar uma raiz de pesquisa e adicionar uma ou mais regras de inclusão; em seguida, o indexador pode iniciar um rastreamento para a indexação inicial. O CSM oferece as interfaces a seguir para ajudá-lo a fazer isso programaticamente.

Embora você possa usar as APIs do CSM para definir um escopo de rastreamento programaticamente, o CSM foi projetado para dar suporte também aos usuários finais. Por exemplo, suponha que você tenha desenvolvido um manipulador de protocolo para um novo armazenamento de dados e queira permitir que usuários ou administradores gerenciem quais caminhos devem ser indexados. Você pode usar o Gerenciador de Escopo de Rastreamento para definir uma ou mais raízes de pesquisa (por exemplo, file:///C:\MyContainer\) e a interface do usuário da Pesquisa do Windows para definir opções de indexação exibirá cada raiz de pesquisa com uma caixa de marcar. Em seguida, os usuários podem incluir ou excluir esse caminho ou filhos desse caminho.

Pesquisar raízes e regras de escopo

As raízes de pesquisa e as regras de escopo juntas definem um conjunto de trabalho de URLs que compõem o escopo de rastreamento do indexador.

Raízes de Pesquisa

Definir uma raiz de pesquisa não especifica quais partes desse repositório devem ser indexadas; ele apenas sinaliza que um repositório de conteúdo existe e está associado a um manipulador de protocolo registrado. A sintaxe de uma raiz de pesquisa inclui um protocolo, um identificador de segurança do site ou do usuário e um caminho para os locais a serem rastreados.

Você deve criar novas raízes de pesquisa ao:

  • Instalar um manipulador de protocolo OR
  • Deseja indexar um novo armazenamento de dados

AND

  • que o armazenamento de dados ainda não está no escopo de rastreamento do indexador.

Consulte Gerenciar raízes de pesquisa para obter instruções sobre como adicionar, remover e enumerar raízes de pesquisa.

Regras de escopo

As regras de escopo incluem ou excluem URLs em uma raiz de pesquisa de serem rastreadas e indexadas. As regras de escopo podem ser definidas por usuários finais, por política de grupo ou por desenvolvedores de terceiros. Você deve definir regras de escopo programaticamente quando definir uma nova raiz de pesquisa. Suas raízes de pesquisa e regras de escopo compõem o escopo de rastreamento padrão para o armazenamento de dados e o manipulador de protocolo.

Observação

Os usuários com acesso a Painel de Controle podem modificar o escopo de rastreamento padrão. Portanto, qualquer aplicativo que ofereça gerenciamento de escopo deve sempre obter as regras diretamente do CSM usando os métodos de enumeração em vez de depender de sua própria cópia salva das regras do usuário.

 

Consulte Gerenciar regras de escopo para obter instruções sobre como adicionar, remover, reverter e enumerar regras de escopo.

Políticas de grupo compatíveis com o Gerenciador de Escopo de Rastreamento

Os administradores do sistema podem definir escopos de rastreamento em suas organizações usando Políticas de Grupo. Essas regras de política de grupo também podem atuar como regras padrão, que os usuários podem substituir. Por exemplo, você pode ter um conjunto de diretórios indexados para um grupo de usuários e um conjunto diferente para outro grupo de usuários, permitindo que os usuários desmarquem esses padrões. As regras de política de grupo também podem agir como regras de exclusão forçadas que os usuários não podem substituir, impedindo que determinados usuários indexem determinados compartilhamentos de rede, por exemplo.

Gerenciar raízes de pesquisa

Gerenciando regras de escopo

O processo de indexação