Habilitación de la búsqueda de texto completo en la base de datos SAMPL

Habilite la búsqueda de texto completo en la base de datos predeterminada SAMPL para aprender cómo configurar esta característica y sus prestaciones.

Antes de empezar

Se necesitan aproximadamente 15 minutos para completar este caso de ejemplo, debido a que la base de datos SAMPL tiene pocos registros.

Acerca de esta tarea

Este caso de ejemplo utiliza un repositorio de esquemas con una conexión denominada TextSearch y una base de datos de usuario denominada SAMPL. Las vías de acceso se especifican presuponiendo que utiliza un sistema operativo Windows. Realice las sustituciones adecuadas si está utilizando un sistema UNIX o Linux.

Procedimiento

  1. Ejecute el mandato cqtsadmin.pl con las opciones init_cq_fts y create_fts_was_profile en una ventana del indicador de mandatos:

    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

    Cuando se haya completado este mandato, los datos de configuración correspondientes al esquema se encontrarán en el directorio siguiente: D:\CQ.Search\TextSearch_SAMPL\
  2. Edite el archivo de entidad asociado al despliegue: D:\CQ.Search\TextSearch_SAMPL\Entity-TextSearch-SAMPL.txt. Para cada tipo de registro, seleccione un campo de visualización para que aparezca en los resultados de búsqueda de texto completo estableciendo un ampersand (&) como prefijo. Por ejemplo, cambie lo siguiente:
    Customer=Attachment,CallTrackingID,Name,Phone,...
    Defect=Attachments,Description,Headline,Keywords,...
    Email_Rule=Action_types,Actions,Name,Operator_Value,...
    Project=Description,Name,dbid,...
    groups=dbid,is_active,lock_version,name,...
    users=dbid,email,encrypted_password,fullname,...
    a:
    Customer=Attachment,CallTrackingID,&Name,Phone,...
    Defect=Attachments,Description,&Headline,Keywords,...
    Email_Rule=Action_types,Actions,&Name,Operator_Value,...
    Project=Description,&Name,dbid,...
    groups=dbid,is_active,lock_version,&name,...
    users=dbid,email,encrypted_password,&fullname,...
    No es necesario que seleccione un campo de visualización para cada tipo de registro. No obstante, si no lo hace, se utilizará el campo dbid como campo de visualización predeterminado, lo cual probablemente no será útil en los resultados de búsqueda. Tenga en cuenta que siempre puede cambiar el campo de visualización más adelante sin volver a indexar los datos. Consulte Modificación del campo de visualización para tipos de registro indexados para obtener más información.
    Importante: Al configurar la búsqueda de texto completo en la base de datos de producción, además de seleccionar los campos de visualización, debe seleccionar también qué tipos de registro y campos asociados desea indexar. Por ejemplo, si no desea indexar el tipo de registro Email_Rule, suprímalo de la lista. Para indexar sólo los campos Name y Phone para el tipo de registro Customer, suprima los demás campos.
  3. Edite el archivo de configuración D:\CQ.Search\TextSearch_SAMPL\cqtsadmin-TextSearch-SAMPL.xml.
    1. Modifique el valor del código <updateIndexDelay> de:
      <newValue required="no"></newValue>

      a:

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

      De esta manera se modifica el valor predeterminado del retardo de indexación en modalidad de actualización de 10 minutos (600 segundos) a 60 segundos, es decir, deberán transcurrir aproximadamente 60 segundos para que un cambio que haya realizado aparezca en un conjunto de resultados de búsqueda de texto completo.

    2. Opcional: modifique el valor del código <updateIndexLoginInterval> de:
      <newValue required="no"></newValue>

      a:

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

      De esta manera se modifica el número de ciclos de extracción de registros en modalidad de actualización antes de emitir un nuevo inicio de sesión en una cuenta de ClearQuest de 1 (valor predeterminado) a 10.

  4. Ejecute de nuevo el mandato cqtsadmin.pl con la opción setup_cq_fts para completar el despliegue:

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

    Importante: En un entorno de producción, los usuarios del cliente ClearQuest Web pueden utilizar la búsqueda de texto completo durante la indexación en modalidad de proceso por lotes. Sin embargo, los resultados estarán incompletos hasta que finalice la indexación.
  5. Sistema UNIX y Linux: si está utilizando un sistema UNIX o Linux, verifique que el mandato siguiente se ejecuta como parte del daemon de inicio para garantizar que Solr y el indexador de registros se inician automáticamente cuando se reinicia el sistema:
    inicio-perfil-was-btc/nombre-perfil/bin/startServer.sh
    donde las variables son:
    inicio-perfil-was-btc
    Directorio donde reside el perfil de WebSphere Application Server para la búsqueda de texto completo
    nombre-perfil
    Nombre del perfil de WebSphere Application Server para la característica de búsqueda de texto completo
    Por ejemplo:
    /opt/CQFTS.WASprofiles/cqfts_TextSearch_SAMPL/bin/startServer.sh server1 -profileName cqfts_TextSearch_SAMPL

Resultados

Ha habilitado la búsqueda de texto completo en la base de datos SAMPL.


Comentarios