Gestion des règles d’étendue

Le Gestionnaire d’étendue d’analyse (CSM) vous permet de définir des règles d’étendue qui incluent ou excluent des URL de l’étendue d’analyse de 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 des 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 a une règle d’étendue parent ou enfant

 

Cette rubrique comprend les sujets suivants :

À propos des règles de portée

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 entraînent l’inclusion de cette URL dans l’étendue de crawl, et les règles d’exclusion entraînent l’exclusion de cette URL (et de ses ressources associées) de l’étendue de l’analyse.

Par exemple, supposons que vous avez installé une nouvelle application dont les fichiers de données se trouvent dans le dossier WorkteamA\ProjectFiles sur un ordinateur local. Supposons que vous souhaitez tout dans le dossier ProjectFiles indexé à 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 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. Les règles de stratégie de groupe 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 De recherche Windows. Les utilisateurs ou d’autres applications peuvent supprimer toutes les règles utilisateur et rétablir les 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, les règles par défaut peuvent être définies lorsqu’un nouveau gestionnaire de protocole ou un conteneur est ajouté au système.

Ensemble, ces types de règles comprennent l’ensemble de règles de travail à partir duquel le Gestionnaire d’étendue 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.

Note

Les utilisateurs ayant accès au Panneau de configuration peuvent modifier les règles via cette interface. Par conséquent, les applications offrant une gestion de l’étendue doivent toujours obtenir les règles directement à partir du CSM à l’aide des 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 tous les dossiers sous le répertoire ProjectA. Pour un exemple plus compliqué, 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 de portée 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 » pour obtenir une 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’étendue 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 des règles utilisateur et par défaut, ainsi que toutes les règles forcé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’une des options suivantes :

  • 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 telle que Windows Search ou un gestionnaire de protocole
  • Application d’installation pour l’ajout d’un nouveau magasin de données ou d’un 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 du 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é des utilisateurs (SID) dans les chemins, 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, ce qui garantit 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 Descriptif
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, telle que spécifiée 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 accepte 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é à une utilisation ultérieure. Lorsque vous ajoutez une nouvelle règle d'étendue et que le Crawl Scope Manager détermine que la règle existe déjà (en fonction de l'URL ou du modèle fourni), l'ensemble de règles opérationnelles est mis à jour afin que (1) l'ancienne règle soit remplacée par la nouvelle règle et (2) toutes les règles utilisateur contradictoires soient supprimées.

Conseil : Bien que la racine file:// soit incluse par défaut dans l’étendue de l’analyse, le dossier 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 d’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 d’utilisateur est identique à une règle d’utilisateur existante, l’ancienne règle d’utilisateur est remplacée.

La définition de l’indicateur fOverrideChildren présente 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 (règles utilisateur et règles par défaut).
  • FAUX entraîne un nouvel ajout à l'ensemble de règles en cours, réintégrant 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 Descriptif
RemoveScopeRule Supprime une règle d’utilisateur pour une URL spécifiée de l’ensemble de règles de travail. Si la règle utilisateur est un doublon 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 du jeu de règles de travail et du jeu 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 prend 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.

Pourboire: 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 définis par l’utilisateur d’une racine de recherche et de revenir à la racine de recherche d’origine et aux règles d’étendue par défaut. Pour plus d’informations, reportez-vous à la section suivante.

Note

Sur Windows Vista, si les utilisateurs sont supprimés via des profils utilisateur dans le 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 règles des utilisateurs.

 

 

Restauration des règles par défaut

Rétablir les règles par défaut supprime toutes les règles utilisateur d’une URL ou d’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 s’il n’est pas en mesure de rétablir les règles par défaut.

 

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

Le CSM énumère les 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 les règles d’étendue à plusieurs fins. Par exemple, vous pouvez afficher l'ensemble des règles de travail dans une interface utilisateur, ou découvrir si une règle ou un descendant d'une règle figure déjà dans le périmètre d'analyse.

 

Règles de portée pour le traçage

Le CSM vous permet également de déterminer si une URL spécifiée est incluse dans l’étendue d’analyse et si elle a une règle d’étendue parent ou enfant. Vous pouvez également savoir 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 d’ISearchCrawlScopeManager utilisées pour ajouter de nouvelles règles d’étendue.

Méthode Descriptif
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 fois que vous l’avez vérifiée.
Exemple : Si une application de messagerie utilise des notifications gérées par le fournisseur, elle peut récupérer la version de la portée parente avant de se fermer et la vérifier à nouveau une fois rouverte. Ensuite, l’application peut déterminer s’il doit envoyer (push) un nouvel ensemble de notifications à l’indexeur.
HasChildScopeRule Retourne TRUE si l’URL spécifiée a une règle enfant (une règle s’appliquant à un enfant à n’importe quel niveau dans 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 (une règle s’appliquant à un parent à n’importe quel niveau de 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 d’analyse et récupère la valeur TRUE si l’URL est incluse dans l’étendue de l’analyse. Cette méthode peut vous aider à identifier les conflits dans votre ensemble de règles de travail.

 

 

Note

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, telle que le bit FANCI défini (autrement dit, un utilisateur n’a pas autorisé 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 fichier ou un chemin d'accès doit être inclus mais qu’il ne l’est pas, veillez à vérifier le paramètre du bit 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 recherche rapide permet au service d’indexation d’indexer ce dossier . Si le fichier ou le chemin d’accès 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.

Référence

ISearchCrawlScopeManager

ISearchCrawlScopeManager2

ISearchScopeRule

IEnumSearchScopeRules

conceptuelle

Gestion des racines de recherche

 

 

  • Last updated on