Activation de la recherche en texte intégral sur la base de données SAMPL

Activation de la recherche en texte intégral sur la base de données prête à l'emploi SAMPL de ClearQuest afin d'en apprendre plus sur la configuration de la fonction et sur ses fonctionnalités.

Avant de commencer

Il vous faudra environ 15 minutes pour effectuer ce scénario car la base de données SAMPL ne contient que quelques enregistrements.

Pourquoi et quand exécuter cette tâche

Ce scénario utilise un référentiel de schémas avec une connexion appelée TextSearch et une base de données utilisateur appelée SAMPL. Les spécifications de chemin d'accès supposent que vous utilisez le système d'exploitation Windows. Effectuez les substitutions appropriées si vous utilisez le système UNIX ou Linux.

Procédure

  1. Exécutez la commande cqtsadmin.pl, avec les options init_cq_fts et create_fts_was_profile, dans une fenêtre d'invite de commande :

    cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile automatic --fts_was_profile_home D:\CQFTS.WASprofiles

    Lorsque cette commande est terminée, les données de configuration correspondant à votre schéma sont placées dans le répertoire suivant : D:\CQ.Search\TextSearch_SAMPL\
  2. Editez le fichier d'entité associé au déploiement : D:\CQ.Search\TextSearch_SAMPL\Entity-TextSearch-SAMPL.txt. Pour chaque type d'enregistrement, sélectionnez une zone d'affichage à afficher dans les résultats de la recherche en texte intégral en ajoutant une perluète (&) en préfixe. Par exemple, remplacez :
    Customer=Attachment,CallTrackingID,Name,Phone,...
    Defect=Attachments,Description,Headline,Keywords,...
    Email_Rule=Action_types,Actions,Name,Operator_Value,...
    Project=Description,Name,dbid,...
    par :
    Customer=Attachment,CallTrackingID,&Name,Phone,...
    Defect=Attachments,Description,&Headline,Keywords,...
    Email_Rule=Action_types,Actions,&Name,Operator_Value,...
    Project=Description,&Name,dbid,...
    Vous n'avez pas besoin de sélectionner une zone d'affichage pour chaque type d'enregistrement. Toutefois, si vous ne le faites pas, la zone dbid est utilisée en tant que zone d'affichage par défaut, ce qui ne sera probablement pas très utile dans les résultats de la recherche. Notez que vous pouvez toujours changer ultérieurement la zone d'affichage sans réindexer les données. Reportez-vous à la rubrique Changement de la zone d'affichage pour les types d'enregistrement indexés pour plus de détails.
    Important : Lorsque vous configurez la recherche en texte intégral sur votre base de données de production, vous devez, en plus de la sélection des zones d'affichage, sélectionner les types d'enregistrement et les zones associées à indexer. Par exemple, si vous ne voulez pas indexer le type d'enregistrement Email_Rule, supprimez-le de la liste. Pour indexer uniquement les zones Name et Phone pour le type d'enregistrement Customer, supprimez les autres zones.
  3. Editez le fichier de configuration D:\CQ.Search\TextSearch_SAMPL\cqtsadmin-TextSearch-SAMPL.xml.
    1. Remplacez la valeur de la balise <updateIndexDelay> :
      <newValue required="no"></newValue>

      par :

      <newValue required="no">60</newValue>

      Cela permet de modifier la valeur par défaut du délai d'indexation en mode de mise à jour de 10 minutes (600 secondes) en 60 secondes, ce qui signifie qu'il faudra environ 60 secondes pour qu'un changement apporté à un enregistrement apparaisse dans un ensemble de résultats de recherche en texte intégral.

    2. Facultatif : Remplacez la valeur de la balise <updateIndexLoginInterval> :
      <newValue required="no"></newValue>

      par :

      <newValue required="no">10</newValue>

      Cela permet de faire passer le nombre de cycles de l'extraction des enregistrements en mode de mise à jour avant d'émettre une reconnexion au compte ClearQuest de la valeur par défaut égale à 1 à 10.

  4. Exécutez à nouveau la commande cqtsadmin.pl avec l'option setup_cq_fts pour effectuer votre déploiement :

    cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --setup_cq_fts

    Important : Dans un environnement de production, les utilisateurs du client ClearQuest Web peuvent utiliser la recherche en texte intégral lors de l'indexation en mode de traitement par lots. Toutefois, les résultats peuvent être incomplets tant que l'indexation n'est pas terminée.
  5. Système UNIX et Linux : Si vous utilisez le système UNIX ou Linux, vérifiez que la commande suivante est exécutée dans le cadre de votre démon de démarrage afin de vous assurer que Solr et l'indexeur d'enregistrements démarrent automatiquement lors du redémarrage du système :
    accueil-profil-was-fts/nom-profil/bin/startServer.sh
    avec les variables :
    accueil-profil-was-fts
    Répertoire où se trouve le profil WebSphere Application Server pour la recherche en texte intégral
    nom-profil
    Nom du profil WebSphere Application Server pour la fonction de recherche en texte intégral
    Exemple :
    /opt/CQFTS.WASprofiles/cqfts_TextSearch_SAMPL/bin/startServer.sh server1 -profileName cqfts_TextSearch_SAMPL

Résultats

Vous avez activé la recherche en texte intégral sur la base de données SAMPL.


Retour d'informations