Este mandato está instalado en el directorio de instalación del producto predeterminado.
El archivo de entidades se genera cuando se especifica -o Entity como modalidad de operación. Contiene las entidades que se pueden enviar encontradas en la base de datos. Dado que el desarrollador de esquemas de ClearQuest entiende bien estas entidades, no es necesario explicar adicionalmente el archivo de entidades.
El archivo de propiedades de búsqueda de ClearQuest se genera cuando se especifica -o CQ como modalidad de operación. Contiene diversas secciones: motor de búsqueda, rastreador de bases de datos, base de datos y entidad. Si se replica la base de datos, existen diversas instancias de cada sección. Cada instancia corresponde a una réplica y puede requerir una configuración que sea específica de la réplica.
La sección del motor de búsqueda
<!- Solr Search Engine default parameters -–> <SearchEngine sitename="<local>" provider="Solr" version="1.2"> <searchrequest retries="3" url=http://localhost:14080/solr/select/?q=%s&start=%d&rows=%d /> <searchprop pagesize="25" cachesize="1000" /> </SearchEngine>
La sección del rastreador de bases de datos
Esta sección describe las etiquetas XML de la sección del rastreador de bases de datos del archivo, CQnombre_bd-nombreconjuntobd.xml. A continuación se proporciona un ejemplo de esta sección:
<!- ClearQuest Database Crawler default parameters --> <CQDbCrawler sitename="<local>"> <batch size="250" delay="5" directory="./batch-output" url=http://localhost/solr/update/" /> <update size="250" delay="300" login_iteration="1" directory="./update-output" url=http://localhost/solr/update/" /> </CQDbCrawler>
Para una base de datos replicada, existe una etiqueta <CQDbCrawler> independiente para cada réplica, y cada instancia de sitename especifica el sitio de una réplica. En el caso de una base de datos replicada, el extractor de registros busca un valor de opción sitename que coincida con el nombre del sitio en el cual se ejecuta. Si no se encuentra ninguno, el extractor de registros no puede iniciarse.
Ejemplo
Si el valor de login_iteration es 10 y se cambia delay del valor predeterminado de 600 segundos a 60 segundos, se crea un inicio de sesión nuevo cada 10 minutos, mientras se produce una comprobación de registros nuevos o modificados de ClearQuest cada minuto. Esta acción permite que el índice de búsqueda de texto completo se sincronice con mayor proximidad con la base de datos de ClearQuest.
La sección de la base de datos
Esta sección describe las etiquetas XML de la sección de la base de datos del archivo, CQnombre_bd-nombreconjuntobd.xml. A continuación se proporciona un ejemplo de esta sección:
<!-- ClearQuest database and CM Server parameters --> <CQDatabase sitename="<local>"> <cmserver>http://localhost/TeamWeb/services/Team/</cmserver> <repository dbset="TextSearch" dbname="SAMPL" <username="admin" password="" keyfile=""></repository> </CQDatabase>
Para una base de datos replicada, existe una instancia de CQDatabase para cada réplica, y sitename especifica el sitio de la réplica. El extractor de registros busca un sitename que coincida con el nombre del sitio en el cual se ejecuta; si no se encuentra ninguno, el extractor de registros no puede iniciarse.
No es necesario modificar esta etiqueta.
En caso contrario, se producirán errores a la hora de ejecutar el extractor de registros, cqdbtscrawler.pl, en modalidad de proceso por lotes o de actualización.
La sección de entidades
Esta sección describe las etiquetas XML de la sección de entidades del archivo, CQ-nombrebd-nombreconjuntobd.xml. A continuación se proporciona un ejemplo de esta sección:
<!- ClearQuest entity parameters --> <CQEntity name="Customer" index="true"> <field name="schema_mastership" disp_order="0" index="true" /> <field name="customer_name" disp_order="1" index="true" /> <field name="phone" disp_order="0" index="true" /> <field name="company_name" disp_order="0" index="true" /> . . . </CQEntity>
El archivo de esquema de búsqueda de Solr se genera cuando se especifica -o Solr como modalidad de operación. Dado que se trata del caso de -o CQ, esta modalidad de operación toma como su entrada el archivo de entidad generado mediante la ejecución de este mandato en modalidad de entidad (-o Entity). No edite el archivo de esquema de búsqueda de Solr; como alternativa, copie secciones de este archivo en el archivo de esquema de Solr, schema.xml. (Para obtener información acerca de schema.xml, consulte la documentación de Solr).
<Solr> <fields> <field name="Operator_Value" type="text" indexed="true" stored="false" required="false" multivalued="true"></field> <field name="misc_info" type="text" indexed="true" stored="false" required="false" multivalued="true"></field> ... <field name="Resolution" type="text" indexed="true" stored="false" required="false" multivalued="false"></field> ... <field name="comments" type="text" indexed="true" stored="false" required="false" multivalued="true"></field> ... <field name="RATL_CQ_UNIQUE_FIELD" type="string" indexed="true" stored="true" required="true" multivalued="false"></field> ... <field name="RATL_CQ_ALL_FIELDS" type="text" indexed="true" stored="false" required="false" multivalued="true"></field> </fields> </Solr> <uniqueKey>RATL_CQ_UNIQUE_FIELD</uniqueKey> <defaultSearchField>RATL_CQ_ALL_FIELDS</defaultSearchField> <copyField source="Operator_Value" dest="RATL_CQ_ALL_FIELDS"></copyField> <copyField source="misc_info" dest="RATL_CQ_ALL_FIELDS"></copyField> ... <copyField source="Resolution" dest="RATL_CQ_ALL_FIELDS"></copyField> ... <copyField source="Version" dest="RATL_CQ_ALL_FIELDS"></copyField> ... <copyField source="comments" dest="RATL_CQ_ALL_FIELDS"></copyField> ... <copyField source="Fax" dest="RATL_CQ_ALL_FIELDS"></copyField>
cqperl cqtssetup.pl -d SAMPL -s TextSearch -u admin -p "" -o Entity
Este mandato genera el archivo Entity-SAMPL-TextSearch.txt. El contenido del archivo es similar al del texto siguiente:
Email_Rule=ratl_mastership,ratl_keysite,record_type,dbid,is_active,version,lock_version,locked_by,name,…,…,… Customer=ratl_mastership,ratl_keysite,dbid,is_active,version,lock_version,locked_by,record_type,Name,Phone,Fax,Email,CallTrackingID,…,…,… Project=ratl_mastership,ratl_keysite,dbid,is_active,version,lock_version,locked_by,…,…,… Defect=ratl_mastership,record_type,dbid,is_active,id,state,version,lock_version,locked_by,isduplicate,unduplicate_state,Headline,Description,Priority,Severity,Submitter,…,…,…
Edite el archivo para especificar los tipos de registro y los campos que se pueden buscar. Por ejemplo, si únicamente pueden buscarse registros del tipo Defect, suprima todas las líneas del archivo excepto la que empieza por Defect=. Si únicamente pueden buscarse algunos de los campos definidos por este tipo de registro, conserve únicamente estos campos y suprima el resto. Por ejemplo, si únicamente pueden buscarse Headline, Description y Severity, el archivo editado sería
Defect=record_type,dbid,version,Headline,Description,Severity
Tenga en cuenta que los campos record_type, dbid y version se conservan. La implementación de la búsqueda de texto completo tiene como requisito la indexación de estos tres campos.
cqperl cqtssetup.pl -d SAMPL -s TextSearch -u admin -p "" -o CQ -f Entity_SAMPLE_TextSearch.txt
Este mandato genera el archivo, CQ-SAMPL-TextSearch.xml, que utilizan el extractor de registros (cqtsdbcrawler.pl) y la característica de búsqueda.
cqperl cqtssetup.pl -d SAMPL -s TextSearch -u admin -p "" -o Solr Entity-SAMPL-TextSearch.txt
Este mandato genera el archivo, Solr-SAMPL-TextSearch.xml. No edite este archivo: copie secciones de este archivo en el archivo de Solr, schema.xml.