1. Créer un index full-text dans le fichier de données concerné par cette recherche.
2. Créer une requête pour effectuer la recherche full-text.
3. Analyser et afficher le résultat de la requête.

1. Dans l'éditeur d'analyses, affichez la description des rubriques du fichier concerné (option "Description des rubriques" du menu contextuel).
2. Cliquez sur l'icône . La fenêtre de définition de l'index full-text apparaît. Sélectionnez les rubriques intervenant dans la composition de l'index full-text. Seules les rubriques de type "Texte" et "Mémo Texte" présentes dans la description du fichier sont proposées. Validez.
3. La rubrique de type "Index full-text" apparaît dans la liste des rubriques.
4. Sélectionnez la rubrique et si nécessaire modifiez ses caractéristiques :
   • dans la liste des rubriques, il est possible de modifier directement le nom de l'index full-text.
   • dans la partie droite de la fenêtre, sélectionnez les paramètres de l'index full-text :
     • taille minimale des mots indexés (option "Ne pas indexer les mots de taille inférieure ou égale à") : seuls les mots supérieurs à cette taille seront indexés. Par défaut, cette taille est de 2 caractères.
     • gestion des balises RTF : l'option "Mon texte peut contenir du RTF (ne pas indexer les balises RTF)" permet de spécifier si le texte contient du RTF. Dans ce cas, les balises RTF ne seront pas prises en compte lors de l'indexation.
     • gestion des balises HTML : l'option "Mon texte peut contenir du HTML (ne pas indexer les balises HTML)" permet de spécifier si le texte contient du HTML. Dans ce cas, les balises HTML ne seront pas prises en compte lors de l'indexation.
     • Gestion de la ponctuation Unicode : cette option permet de spécifier si le texte contient des caractères de ponctuation spécifiques à Unicode (guillemets incurvés, ...).
     • gestion de la casse : Si l'option "Sensible à la casse" est cochée, la casse des mots (majuscule/minuscule) sera prise en compte lors de l'indexation.
     • gestion de l'accentuation : Si l'option "Sensible à l'accentuation" est cochée, l'accentuation sera prise en compte lors de l'indexation. Cette option est nécessaire si la racinisation est demandée.
     • gestion des mots creux : La gestion des mots creux permet de définir les mots creux qui ne doivent pas être pris en compte par l'indexation. Les mots creux sont le plus souvent les articles, les mots de liaison, ... Le bouton "Éditer les mots creux" permet de définir les mots creux à prendre en compte. Pour plus de détails, consultez le paragraphe Définition des mots creux.
     • gestion des synonymes : La gestion des synonymes permet de définir les mots qui devront être considérés comme synonymes. Pour plus de détails, consultez le paragraphe Définition des synonymes.
     • gestion de la racinisation : Si la gestion des synonymes n'est pas activée, il est possible d'activer la racinisation. La racinisation permet d'effectuer des recherches sur un index full-text en tenant compte des variantes d'un mot donné. Cette fonctionnalité est intéressante pour les bases de connaissance et permet de rechercher indifféremment les mots au singulier ou au pluriel. La racinisation dépend de la langue utilisée.
       Si vous activez cette option, sélectionnez la langue utilisée.
5. Validez la fenêtre de description des rubriques.
6. Enregistrez et générez l'analyse. Lors de la génération de l'analyse, la description des fichiers de données est modifiée et l'index full-text est créé (fichier d'extension ".FTX").

Remarques

• Pour créer directement un index full-text à partir d'une rubrique texte ou mémo texte, il suffit de sélectionner la rubrique dans la fenêtre de description des rubriques et de cliquer sur le lien "Créer un index full-text sur la rubrique".
• Il est possible de gérer les index full-text dans les fichiers de données décrits par programmation : il suffit d'utiliser une variable de type Description d'IndexFullText pour décrire l'index, puis la fonction HDécritIndexFullText pour valider la création de l'index.
• A tout moment, il est possible de modifier la composition d'un index full-text existant : il suffit de cliquer sur le bouton "Editer l'index" dans la partie gauche de la description de la rubrique sous l'éditeur d'analyses.
• Pour créer une rubrique de type Index full-text, une génération de l'analyse et une modification automatique des données sont obligatoires.
• Racinisation : A cause de certaines irrégularités grammaticales (verbes du 3ème groupe en français, verbes irréguliers en anglais, ...), certaines conjugaisons peuvent ne pas être regroupées (par exemple, une recherche de "peux" ne donnera pas les enregistrements contenant "pouvons") ou certains pluriels peuvent ne pas être regroupés avec leur singulier (exemple feux/feu).

Recherche full-text : Éditeur de requêtes

• La valeur de recherche. Cette valeur peut être saisie directement (un assistant permet de construire la chaîne à rechercher) ou correspondre à un paramètre. Pour plus de détails sur les caractéristiques de la chaîne à rechercher, consultez le paragraphe "Syntaxe de la valeur de recherche".
• Les options de tri du résultat.

Recherche full-text : Requête en code SQL

• <Index> correspond à la liste des rubriques de l'index séparées par des virgules (l'ordre des rubriques n'est pas important).
• <Condition> correspond à la chaîne à rechercher. Pour plus de détails sur les caractéristiques de la chaîne à rechercher, consultez le paragraphe "Syntaxe de la valeur de recherche".

REQ_Rech est une Source de Données


MaRequête est une chaîne = [
	SELECT * FROM Contacts
	WHERE MATCH(Contacts.Nom, Contacts.Prenom, Contacts.CommentaireHTML, 
	Contacts.CommentaireTexteBrut, Contacts.Commentaires, 
	Contacts.Telephone, Contacts.Bureau, 
	Contacts.Portable, Contacts.Mail, Contacts.MSN, Contacts.Site_internet, 
	Contacts.Pays, Contacts.NumFax, Contacts.Ville)
	AGAINST ('
]
MaRequête = MaRequête + SAI_Rechercher + [
')  
AND Contacts.IDUtilisateur =  
]
MaRequête = MaRequête + IDUserConnecté + [
ORDER BY Nom DESC
]

HExécuteRequêteSQL(REQ_Rech, hRequêteDéfaut, MaRequête)
POUR TOUT REQ_Rech
	TableAjouteLigne(TABLE_Contact_par_catégorie, ...
		REQ_Rech.IDContact, REQ_Rech.IDCategorie, IDUserConnecté, ...
		REQ_Rech.Nom, REQ_Rech.Prenom) 
FIN
CAS ERREUR: 
	Erreur(HErreurInfo())

Syntaxe de la valeur de recherche

Cas particuliers des mots composés séparés par un tiret

• Le texte contient "multiplateforme" : les deux mots "multi" et "plateforme" seront indexés de façon indépendante.
• Lors de la recherche, les documents contenant "multi" et/ou "plateforme" seront trouvés.
• Pour rechercher "multiplateforme", il est nécessaire de rechercher le mot entre guillemets : "multiplateforme".
  Attention : la recherche renverra tous les documents qui contiennent consécutivement les deux mots "multi" et "plateforme". Le séparateur des deux mots pourra ne pas être le tiret : il pourra s'agir de n'importe quel séparateur (espace, +, point, virgule, retour chariot, tabulation, ...).

• le nombre de fois où le mot recherché est présent dans l'enregistrement.
• le nombre de mots dans l'enregistrement et leur nombre de répétitions.
• le rapport entre les enregistrements qui contiennent les mots recherchés et ceux qui ne contiennent pas les mots recherchés. En effet, plus le mot recherché est présent dans tous les enregistrements, et moins la pertinence sera importante.
• ...

• La création d'un index full-text dans un fichier de données créé par programmation peut être réalisée grâce à une variable de type Description d'IndexFullText.
• La fonction HRéindexe permet de ré-indexer les index full-text.