Share via

Gestion des règles d’étendue

  • Article

Le Gestionnaire d’étendues d’analyse (CSM) vous permet de définir des règles d’étendue qui incluent ou excluent des URL de l’étendue d’analyse Recherche Windows.

Le CSM vous permet d’effectuer les opérations suivantes :

  • Ajouter de nouvelles règles d’étendue à l’ensemble de règles de travail
  • Supprimer les règles d’étendue existantes
  • Énumérer les règles d’étendue par défaut
  • Découvrez si une URL particulière est incluse ou exclue de l’étendue d’analyse ou si elle a une règle d’étendue parent ou enfant

 

Cette rubrique traite des sujets suivants :

À propos des règles d’étendue

Une règle d’étendue est une règle qui inclut ou exclut les URL d’une racine de recherche d’être analysées et indexées. Les règles d’inclusion obligent l’indexeur à inclure cette URL dans l’étendue scrawl, et les règles d’exclusion entraînent l’exclusion de cette URL (et de ses enfants) de l’étendue d’analyse.

Par exemple, supposons que vous ayez installé une nouvelle application dont les fichiers de données se trouvent dans le dossier WorkteamA\ProjectFiles sur un ordinateur local. Supposons que vous souhaitiez que tous les éléments du dossier ProjectFiles soient indexés, à l’exception des éléments du sous-dossier Prototypes. Dans ce cas, vous avez besoin d’une règle d’inclusion pour myPH:///C:\WorkteamA\ProjectFiles\ et d’une règle d’exclusion pour myPH:///C:\WorkteamA\ProjectFiles\Prototypes\.

Il existe trois types de règles, avec l’ordre de priorité suivant :

  1. stratégie de groupe règles sont définies par les administrateurs et peuvent remplacer toutes les autres règles.
  2. Les règles utilisateur sont définies par les utilisateurs qui modifient l’étendue dans l’interface utilisateur des options recherche Windows. Les utilisateurs ou d’autres applications peuvent supprimer toutes les règles utilisateur et revenir aux règles par défaut.
  3. Les règles par défaut sont généralement définies par une application pour définir une étendue par défaut. Par exemple, des règles par défaut peuvent être définies lorsqu’un nouveau gestionnaire de protocole ou conteneur est ajouté au système.

Ensemble, ces types de règles constituent l’ensemble de règles de travail à partir duquel le Gestionnaire d’étendues d’analyse (CSM) génère la liste complète des URL à analyser. Bien que les règles par défaut puissent être remplacées par des règles de stratégie de groupe et par des règles utilisateur, elles sont conservées dans leur propre ensemble de règles par défaut, auquel vous pouvez revenir à tout moment. L’indexeur analyse les URL de l’ensemble de règles de travail et ajoute des éléments, des propriétés et du contenu au catalogue.

Notes

Les utilisateurs ayant accès à Panneau de configuration peuvent modifier les règles via cette interface. Par conséquent, les applications offrant la gestion de l’étendue doivent toujours obtenir les règles directement à partir du CSM en utilisant les méthodes d’énumération au lieu de s’appuyer sur une copie enregistrée des règles utilisateur.

 

Les règles d’exclusion peuvent définir des URL de modèle avec le caractère générique « * » ; par exemple : file:///C:\ProjectA\*\. Une règle d’exclusion utilisant ce modèle empêche l’indexeur d’analyser les dossiers sous le répertoire ProjectA. Pour un exemple plus complexe, supposons qu’il existe une règle d’inclusion pour file:///C:\ProjectA\ et une règle de modèle d’exclusion pour file:///C:\ProjectA\*\data\*. Dans ce cas, l’indexeur analyse les éléments dans :

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

Mais l’indexeur n’analyse pas les éléments dans :

  • C:\ProjectA\version1\data\

 

Avant de commencer

Avant d’utiliser l’une des interfaces du Gestionnaire d’étendues d’analyse, vous devez effectuer les étapes préalables suivantes :

  1. Créez l’objet CSearchManager et obtenez son interface ISearchManager .
  2. Appelez ISearchManager::GetCatalog pour « SystemIndex » afin d’obtenir un instance de l’interface ISearchCatalogManager.
  3. Appelez ISearchCatalogManager::GetCrawlScopeManager pour obtenir une instance de l’interface ISearchCrawlScopeManager.

Après avoir apporté des modifications au Gestionnaire d’étendues d’analyse, vous devez appeler la méthode ISearchCrawlScopeManager::SaveAll . Cette méthode ne prend aucun paramètre et retourne S_OK en cas de réussite.

 

Ajout de règles d’étendue

Les règles de travail définies pour le CSM incluent les règles utilisateur et par défaut, ainsi que toutes les règles imposées par la stratégie de groupe. Les règles utilisateur sont configurées par les utilisateurs dans une interface utilisateur, et les règles par défaut peuvent être définies par l’un des éléments suivants :

  • Stratégies de groupe implémentées par un administrateur système (celles-ci n’utilisent pas l’interface ISearchCrawlScopeManager .)
  • Installation ou mise à jour d’une application comme Windows Search ou d’un gestionnaire de protocole
  • Une application de configuration pour l’ajout d’un nouveau magasin de données ou d’un nouveau conteneur

ISearchCrawlScopeManager fournit deux méthodes pour ajouter de nouvelles règles d’étendue, comme décrit dans le tableau suivant. Les chemins d’accès aux règles d’inclusion pour le système de fichiers doivent se terminer par une barre oblique inverse « \ » (par exemple, file:///C:\files\), et les chemins d’accès pour les règles d’exclusion doivent se terminer par un astérisque (par exemple, file:///c:\files\*). Seules les règles d’exclusion peuvent contenir des URL de modèle. En outre, nous vous recommandons d’inclure les identificateurs de sécurité (SID) des utilisateurs dans les chemins d’accès, pour une meilleure sécurité. Les chemins d’accès par utilisateur sont plus sécurisés, car les requêtes s’exécutent ensuite dans un processus par utilisateur, garantissant ainsi qu’un utilisateur ne peut pas voir les éléments indexés à partir de la boîte de réception d’un autre utilisateur, par exemple.

Le tableau suivant décrit les méthodes de l’interface ISearchCrawlScopeManager utilisée pour ajouter de nouvelles règles d’étendue.

Méthode Description
AddUserScopeRule Ajoute une règle pour une URL, comme spécifié par l’utilisateur. Ces règles remplacent les règles par défaut. Utilisez cette méthode si vous avez implémenté une interface utilisateur qui permet aux utilisateurs de gérer leurs propres règles d’étendue et URL.
AddDefaultScopeRule Ajoute une règle pour une URL, comme spécifié par une autre application, comme un gestionnaire de protocole. Utilisez cette méthode lorsque vous avez implémenté un nouveau gestionnaire de protocole ou ajouté un nouveau magasin de données. Ces règles peuvent être remplacées par des règles utilisateur.

 

Chaque méthode prend une URL vers un emplacement indexable et des indicateurs qui déterminent si l’URL doit être incluse ou exclue. Le paramètre fFollowFlags est réservé pour une utilisation ultérieure. Lorsque vous ajoutez une nouvelle règle d’étendue et que le Gestionnaire d’étendues d’analyse détermine que la règle existe déjà (en fonction de l’URL ou du modèle fourni), l’ensemble de règles de travail est mis à jour de sorte que (1) l’ancienne règle soit remplacée par la nouvelle règle et (2) toutes les règles utilisateur qui la contredisent sont supprimées.

Pointe: Alors que la racine file:// est incluse par défaut dans l’étendue d’analyse, Program Files n’est pas indexé par défaut. Par conséquent, les applications avec des données enregistrées dans leur répertoire Program Files doivent ajouter leur emplacement en tant que règle par défaut.

Remarques sur les règles utilisateur

Si une nouvelle règle utilisateur est identique à une règle par défaut existante, la nouvelle règle utilisateur remplace la règle par défaut dans l’ensemble de règles de travail. Si la nouvelle règle utilisateur est identique à une règle utilisateur existante, l’ancienne règle utilisateur est remplacée.

La définition de l’indicateur fOverrideChildren a les résultats suivants dans l’ensemble de règles de travail :

  • TRUE entraîne la suppression de toutes les règles enfants de l’ensemble de règles de travail (à la fois les règles utilisateur et les règles par défaut).
  • FALSE entraîne l’ajout d’une nouvelle règle aux règles de travail qui définissent toutes les règles par défaut qui sont des enfants de la nouvelle règle utilisateur. Si une règle par défaut enfant est une inclusion et que la nouvelle règle utilisateur est une exclusion, la règle par défaut est remplacée par une règle utilisateur d’inclusion.

 

Suppression de règles d’étendue

Vous pouvez utiliser l’interface ISearchCrawlScopeManager pour supprimer une règle d’étendue de l’ensemble de règles de travail. Cette interface fournit les deux méthodes suivantes pour supprimer des règles d’étendue.

Méthode Description
RemoveScopeRule Supprime une règle utilisateur pour une URL spécifiée de l’ensemble de règles de travail. Si la règle utilisateur est un doublon de ou remplace une règle par défaut, la règle par défaut reste dans l’ensemble de règles de travail.
RemoveDefaultScopeRule Supprime une règle par défaut pour une URL spécifiée de l’ensemble de règles de travail et de l’ensemble de règles par défaut. Après avoir appelé cette méthode, vous ne pouvez pas revenir à cette règle par défaut à l’aide de RevertToDefaultScopes.

 

Chaque méthode accepte une URL et un indicateur indiquant si la règle à supprimer est une règle d’inclusion ou d’exclusion. Ces méthodes retournent une erreur si une règle avec cette URL et cet indicateur d’inclusion/exclusion est introuvable.

Pointe: Si vous souhaitez supprimer entièrement une étendue de l’étendue d’analyse, utilisez la méthode RemoveRoot , qui supprime la racine de recherche et toutes les règles d’étendue associées. Cela lors de la désinstallation, par exemple, est considéré comme une bonne pratique.

Il est également possible de supprimer tous les remplacements de jeu d’utilisateurs d’une racine de recherche et de revenir aux règles d’étendue par défaut et à la racine de la recherche d’origine. Pour plus d’informations, reportez-vous à la section suivante.

Notes

Sur Windows Vista, si les utilisateurs sont supprimés via des profils utilisateur dans Panneau de configuration, CSM supprime toutes les règles et racines qui incluent leur SID et supprime leurs éléments indexés du catalogue. Sur Windows XP, vous devez supprimer manuellement les racines et les règles des utilisateurs.

 

 

Revenir aux règles par défaut

Le rétablissement des règles par défaut supprime toutes les règles utilisateur pour une URL ou une racine et restaure toutes les règles par défaut dans l’ensemble de règles de travail. Toutefois, elle ne supprime pas les règles définies par la stratégie de groupe. La méthode RevertToDefaultScopes ne prend aucun paramètre et retourne un code d’erreur si elle ne parvient pas à revenir aux règles par défaut.

 

Énumération des règles d’étendue

Le CSM énumère des règles d’étendue à l’aide d’une interface d’énumérateur de style COM standard, IEnumSearchScopeRules . Vous pouvez utiliser cette interface pour énumérer des règles d’étendue à plusieurs fins. Par exemple, vous pouvez afficher l’ensemble de l’ensemble de règles de travail dans une interface utilisateur ou découvrir si une règle ou l’enfant d’une règle se trouve déjà dans l’étendue de l’analyse.

 

Règles d’étendue de suivi

Le CSM vous permet également de déterminer si une URL spécifiée est incluse dans l’étendue de l’analyse et si elle a une règle d’étendue parent ou enfant. Vous pouvez également découvrir pourquoi une URL est incluse ou exclue de l’étendue de l’analyse. Ces méthodes ne sont pas destinées à être utilisées avec des URL de modèle.

Le tableau suivant décrit les méthodes de ISearchCrawlScopeManager utilisées pour ajouter de nouvelles règles d’étendue.

Méthode Description
GetParentScopeVersionId Obtient l’ID de version de l’URL d’inclusion parente. Vous pouvez utiliser cette méthode pour voir si l’étendue parente a changé depuis la dernière vérification.
Exemple : si une application de messagerie utilise des notifications gérées par le fournisseur, elle peut obtenir la version de l’étendue parente avant sa fermeture et case activée la version à l’ouverture. Ensuite, l’application peut déterminer si elle doit envoyer un nouvel ensemble de notifications à l’indexeur.
HasChildScopeRule Retourne TRUE si l’URL spécifiée a une règle enfant (règle s’appliquant à un enfant à n’importe quel niveau au sein de sa hiérarchie d’URL).
Exemple : si l’URL est file:///C:\Folder\, cette méthode retourne TRUE si le CSM a une règle d’étendue spécifiquement pour file:///C:\Folder\Subfolder\.
HasParentScopeRule Retourne TRUE si l’URL spécifiée a une règle parente (règle s’appliquant à un parent à n’importe quel niveau dans la hiérarchie d’URL).
Exemple : si l’URL est file:///C:\Folder\Subfolder, cette méthode retourne TRUE si le CSM a une règle d’étendue spécifiquement pour file:///C:\Folder\.
IncludedInCrawlScope Retourne TRUE si l’URL spécifiée est incluse dans l’étendue de l’analyse.
IncludedInCrawlScopeEx Retourne une valeur de l’énumération CLUSION_REASON expliquant pourquoi l’URL est incluse ou exclue de l’étendue de l’analyse, et récupère la valeur TRUE si l’URL est incluse dans l’étendue d’analyse. Cette méthode peut vous aider à identifier les conflits dans votre ensemble de règles de travail.

 

 

Notes

Les méthodes IncludedInCrawlScope et IncludedInCrawlScopeEx déterminent si l’URL sera analysée uniquement en fonction des règles du CSM. Il peut y avoir d’autres raisons pour lesquelles une URL n’est pas analysée, comme le bit FANCI défini (autrement dit, un utilisateur a refusé l’indexation rapide dans la boîte de dialogue Propriété du dossier).)

 

Si vous pensez qu’un chemin d’accès de fichier doit être exclu, mais qu’il est répertorié comme inclus, assurez-vous que les règles d’exclusion se terminent par «< path>\* ». Si vous pensez qu’un chemin d’accès de fichier ou de fichier doit être inclus, mais qu’il ne l’est pas, veillez à case activée le paramètre de bits FANCI pour le fichier ou le chemin d’accès. Pour ce faire, cliquez avec le bouton droit sur le chemin du fichier ou du fichier et sélectionnez Propriétés, puis vérifiez que la case Pour une recherche rapide, autoriser le service d’indexation à indexer ce dossier est cochée. Si le chemin d’accès au fichier ou au fichier n’est pas marqué pour l’indexation ici, il ne sera pas indexé même s’il se trouve dans une règle d’inclusion.

Informations de référence

ISearchCrawlScopeManager

ISearchCrawlScopeManager2

ISearchScopeRule

IEnumSearchScopeRules

Conceptuel

Gestion des racines de recherche