Comment utiliser Windows Desktop Search au sein de vos applications

Il est de plus en plus courant qu'un utilisateur lambda, comme vous ou moi, stocke un nombre considérable d'informations sur différents systèmes de stockage et en particulier les disques durs. Ces disques durs ont une capacité toujours plus grande et le nombre de fichiers peut rapidement devenir excessif pour pouvoir s'y retrouver rapidement. Il va donc forcément arriver un jour où vous allez chercher un fichier sur votre disque dur et où la recherche Windows mettra plusieurs minutes pour trouver ledit fichier. Différentes entreprises ont alors amené l'indexation (ce qu'utilisent les gros moteurs de recherche Internet) au sein de l'ordinateur du particulier; Microsoft l'a fait grâce à son outil Windows Desktop Search. Ce dernier peut être installé sur Windows XP et l'est déjà par défaut au sein de Windows Vista.
Nous allons voir au sein de cet article comment nous pouvons utiliser cet outil dans vos applications qu’elles soient personnelles ou professionnelles.

D'un point de vue contextuel, plusieurs raisons peuvent vous pousser à utiliser WDS (Windows Desktop Search) au sein d'une application. Cela peut tout d'abord servir pour retrouver un certain nombre de fichiers à utiliser ou alors, proposer à l'utilisateur de retrouver rapidement un fichier particulier pour agir avec ce dernier. Bien entendu, ces recherches de fichiers peuvent se faire via un certain nombre de paramètres comme le titre, la date du fichier et bien d'autres choses que la recherche par défaut de Windows ne permet pas toujours.

Il existe un certain nombre de façons d'utiliser WDS.

1- Le protocole search-ms. Comme le protocole Internet HTTP, il permet avec une seule ligne de faire une recherche au sein de Windows Explorer. Vous pouvez ainsi cliquer sur Démarrer > Exécuter et saisir :

search-ms:query=plage&crumb=folder:C:\MesPhotos&

Ce qui lancera une recherche de tous les fichiers ayant utilisant le mot « plage » et étant situés dans le dossier MesPhotos. Pour plus d'infos sur le protocole search-ms, cliquez ici.

2- En utilisant la syntaxe SQL Windows Search qui ne permet que de faire des sélections et des regroupements, mais aucune modification. La syntaxe ressemble à du T-SQL et permet d'interroger les champs des tables d'indexation. En voici un exemple :

SELECT System.ItemName FROM systemindex WHERE CONTAINS("System.FileName", "*plage*")

Pour plus d'informations, cliquez ici.

3- En utilisant Advanced Query Syntax. AQS est un peu comme le SQL vu précédemment, mais plus puissant puisqu'il contient des agrégats permettant de simplifier énormément les recherches. Ces facilités d'usage sont nombreuses (cf la documentation). Il est ainsi possible de rechercher des photos contenant le mot plage, sans retourner les autres fichiers se nommant « *plage* ». Pour cela, il suffit de filtrer les résultats en utilisant le filtre : « kind:pics ». Il est possible avec AQS de faire des requêtes très complexes et très fines.

4- En utilisant OLE DB à travers ADO.Net, ce que nous allons voir en détail par la suite.

5- Et enfin en implémentant l'interface ISearchQueryHelper que nous allons également voir en détail.

Toutes ces méthodes sont utiles, mais les deux utilisables de façon efficace et rapide au sein d'une application .Net sont les deux dernières. L'une aura pourra avantage d'être très simple tandis que l'autre sera plus « propre ».

La méthode la plus simple pour interroger une source de données en .Net reste l'utilisation d'ADO.Net. C'est non seulement la plus simple, mais aussi la plus couramment utilisée. Avec Windows Desktop Search, nous ne dérogerons pas à la règle et nous n'aurons que deux petites choses sur lesquelles faire attention.
Tout d'abord en choisissant un provider adapté : il s'agit du provider OleDb, et ensuite en spécifiant une chaine de connexion particulière pour nous permettre d'interroger le gestionnaire de l'indexation de Windows Desktop Search. La chaine de connexion est particulière à WDS et reste simple: « Provider=Search.CollatorDSO;Extended Properties='Application=Windows'; »

Commençons par créer notre connexion puis par l'ouvrir

OleDbConnection connection = new OleDbConnection("Provider=Search.CollatorDSO;Extended Properties='Application=Windows';");
connection.Open();

Puis déclarons notre objet OleDbCommand qui représentera notre requête auprès de l'index :

var command = new OleDbCommand {Connection = connection, CommandText = "ma requete"};

Note : notez que le code précédent provient de C# 3.0 et utilise le mot clé var ainsi que les nouveaux initialiseurs d'objets. En 2.0, il correspondrait à :

OleDbCommand co = new OleDbCommand();
co.Connection = connection;
co.CommandText = "ma requete";

Et enfin le code de lecture du résultat :

OleDbDataReader reader = command.ExecuteReader();
while (reader.Read())
{
    // traitement de votre choix sur les résultats retournés
    // exemple MessageBox.Show(reader.GetString(0));
}
reader.Close();

Cela n'est pas plus complexe que cela, et il est ainsi possible d'afficher très rapidement les informations de fichiers retrouvés via WDS à condition bien entendu que la requête soit correcte.

Voici donc un exemple complet de recherche :

OleDbConnection connection = new OleDbConnection("Provider=Search.CollatorDSO;Extended Properties='Application=Windows';");
connection.Open();
var command = new OleDbCommand { Connection = connection, 
CommandText = String.Format("SELECT Top 5  System.ItemUrle, System.ItemName,System.Title 
                             FROM systemindex WHERE CONTAINS(\"System.FileName\", '\"*{0}*\"')", "plage") };
OleDbDataReader reader = command.ExecuteReader();
lsvSearch1.Items.Clear();
while (reader.Read())
{
    lsvSearch1.Items.Add(new ListViewItem(new[] { reader.GetString(0) }));
}
reader.Close();

Une autre solution, plus correcte, car permettant de faire des requêtes plus avancées, est l'utilisation de l'interface ISearchQueryHelper. Ici, la manipulation est plus complexe, car non seulement le traitement de vos requêtes ne sera pas tout à fait identique, mais surtout, vous n'utiliserez plus du tout le même type de requête.
Tout d'abord, nous allons « presque » en finir avec nos requêtes au format SQL Windows Search, nous allons maintenant utiliser ADS (Advanced Query Syntax) qui a une syntaxe bien particulière puisqu'il s'agit de placer le caractère « : » entre la propriété du filtre et la valeur du filtre. Exemple :

name:plage

Revenons à notre interface. Pour utiliser cette interface, vous allez devoir télécharger et installer le SDK de Window Vista et repérer le fichier SearchAPI.tlb qui se trouve dans C:\Program Files\Microsoft SDKs\Windows\v6.0\Lib. Une fois celui-ci trouvé, vous allez devoir utiliser tlbimp afin de gérer une assembly managée à partir des informations déclarées dans le fichier *.tlb. Vous pourriez avoir besoin de télécharger le SDK du framework .Net pour avoir l'outil TLBImp.

tlbimp.exe SearchApi.tlb /out:SearchApi.dll

À quoi cela va-t-il nous servir ? Tout simplement à faciliter la connexion en nous fournissant la connexion adaptée, puis en transformant nos requêtes AQS en SQL.

Pour cela, nous allons commencer par importer la librairie dans votre projet puis en ajoutant le namespace correspondant :

using SearchAPILib;

Nous aurons ensuite besoin de deux objets. Tout d'abord un CSearchManager, qui nous servira à obtenir notre deuxième object, un objet implémentant IsearchQueryHelper : un CSearchQueryHelper. Pour cela, deux lignes suffisent :

CSearchManager manager = new CSearchManagerClass();
CSearchQueryHelper helper = cManager.GetCatalog("SYSTEMINDEX").GetQueryHelper();

Nous allons ensuite configurer notre CSearchQueryHelper qui se chargera de générer une requête personnalisée pour nous grâce à sa méthode GenerateSQLFromUserQuery(). Commençons par limiter le nombre de résultats retournés puis précisons l'information que nous souhaitons récupérer :

helper.QuerySelectColumns = "\"System.ItemNameDisplay\"";
helper.QueryMaxResults = 5;

Nous devons ensuite récupérer une connexion valide; cette fois-ci, nous n'avons pas besoin de préciser la chaine de connexion :

var connection = new OleDbConnection(cHelper.ConnectionString);

Puis, pour créer notre objet commande, nous demandons à notre helper de générer la commande :

var cmd = new OleDbCommand(helper.GenerateSQLFromUserQuery(txtSearch2.Text)

Et il ne nous reste plus qu'à lire les résultats comme nous l'avions fait précédemment

using (OleDbDataReader reader = cmd.ExecuteReader())
{
    lsvSearch2.Items.Clear();
    while (!reader.IsClosed && reader.Read())
    {
        lsvSearch2.Items.Add(new ListViewItem(new[] { reader.GetString(0) }));
    }
    reader.Close();
}

Ainsi, si à première vue, cette méthode ne semble pas apporter grand-chose, elle permet avant tout de se passer de chaine de connexion, mais aussi et surtout de pouvoir utiliser les paramètres d'Advanced Query Search pour exécuter des recherches très fines, il est ainsi possible de concaténer « kind:image » au texte que l'utilisateur aura saisi pour ne retourner que des fichiers de type image. Cela est bien entendu possible avec tous les critères que permet AQS.

Windows Desktop Search n'est néanmoins pas un SGBD à part entière et dans de nombreux cas il vous faudra faire preuve de ruse pour atteindre le résultat souhaité. En voici quelques exemples.

IV-A. La recherche fulltext▲

SELECT Top 5  System.ItemUrl, System.ItemName,System.Title FROM systemindex WHERE CONTAINS(\"System.FileName\", '\"*plage*\"')

SELECT Top 5  System.ItemUrl, System.ItemName,System.Title FROM systemindex WHERE CONTAINS('\"*plage*\"')

IV-B. Les dates et heures▲

SELECT ... WHERE System.DateCreated = '2008-10-1'

SELECT ... WHERE System.DateCreated <= '2008-10-1' AND  System.DateCreated < '2008-10-2'

SELECT ... WHERE System.DateCreated <= '2008-10-1 10:00:00' AND  System.DateCreated < '2008-10-1 12:00:00'

IV-C. Les regroupements▲

IV-D. Connaitre la version de WDS installée▲

Il n'est pas courant que vous ayez à faire une recherche parmi les fichiers de votre disque dur, mais si un jour cela devait arriver, quel que soit l'algorithme utilisé (méthode récursive, multithreading), le temps de recherche sera toujours bien plus long que l'utilisation de Windows Desktop Search. Bien entendu, cela nécessite que le service d'indexation soit activé et la recherche ne pourra se faire que sur les dossiers ou partitions pour lesquels l'indexation est autorisée. Garder donc toujours en tête que Windows Desktop Search peut vous être utile pour référencer des fichiers ou au contraire pour les proposer à l'utilisateur.

Pour les sources de l'article, c'est ici