该命令安装在缺省产品安装目录中。
在将 -o Entity 指定为运行方式时,将生成实体文件。 该文件包含在数据库中找到的可提交实体。由于 ClearQuest 模式开发者都十分熟悉这些实体,因此无需进一步说明该实体文件。
在将 -o CQ 指定为运行方式时,将生成 ClearQuest 搜索属性文件。该文件包含以下几个部分:搜索引擎、数据库搜寻器、数据库和实体。如果复制了 ClearQuest 数据库,那么每个部分会有多个实例。每个实例对应一个副本,并且可能需要特定于该副本的配置。
搜索引擎部分
<!- 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>
数据库搜寻器部分
该部分描述了文件 CQ-db_name-dbset_name.xml 的数据库搜寻器部分中的 XML 标记。 下面是该部分的示例:
<!- 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>
对于复制数据库,每个副本都有一个单独的 <CQDbCrawler> 标记,并且每个 sitename 实例都指定一个副本的站点。对于复制数据库,记录抽取器会查找与其所运行在的站点的名称相匹配的 sitename 值。如果未找到,那么记录抽取器将无法启动。
示例
如果 login_iteration 的值为 10,并且您将 delay 的值从缺省值 600 秒更改为 60 秒,那么每 10 分钟会创建一个新的登录会话,同时每分钟都会检查是否出现新的或已修改的 ClearQuest 记录。这样全文搜索索引可以与 ClearQuest 数据库保持更紧密的同步。
数据库部分
该部分描述了文件 CQ-db_name-dbset_name.xml 的数据库部分中的 XML 标记。 下面是该部分的示例:
<!-- 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>
对于复制数据库,每个副本都有一个 CQDatabase 实例,并利用 sitename 指定该副本的站点。记录抽取器会查找与其所运行在的站点名称相匹配的 sitename;如果未找到,那么记录抽取器将无法启动。
您无需修改该标记。
否则,以批处理方式或更新方式运行记录抽取器 cqdbtscrawler.pl 时就会发生错误。
实体部分
该部分描述了文件 CQ-db_name-dbset_name.xml 的实体部分中的 XML 标记。 下面是该部分的示例:
<!- 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>
在将 -o Solr 指定为运行方式时,将生成 Solr 搜索模式文件。与 -o CQ 一样,该运行方式接受以实体方式(-o Entity)运行该命令生成的实体文件作为其输入。 请勿编辑 Solr 搜索模式文件;但是可将该文件的各个部分复制到 Solr 模式文件 schema.xml。(有关 schema.xml 的信息,请参阅 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
该命令会生成 Entity-SAMPL-TextSearch.txt 文件。该文件的内容类似于以下文本:
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,…,…,…
编辑该文件以指定可搜索的记录类型和字段。例如,如果只可搜索类型为 Defect 的记录,请删除该文件中除以 Defect= 开头的行外的所有其他行。如果只可搜索由该记录类型定义的部分字段,请只保留这些字段,删除其他字段。例如,如果只可搜索“标题”、“描述”和“严重性”,那么编辑后的该文件如下所示
Defect=record_type,dbid,version,Headline,Description,Severity
注:将保留字段“记录类型”、“数据库标识”和“版本”。这样便可以实施对这三个字段建立索引的全文搜索。
cqperl cqtssetup.pl -d SAMPL -s TextSearch -u admin -p "" -o CQ -f Entity_SAMPLE_TextSearch.txt
该命令生成文件 CQ-SAMPL-TextSearch.xml,可供记录抽取器(cqtsdbcrawler.pl)和搜索功能使用。
cqperl cqtssetup.pl -d SAMPL -s TextSearch -u admin -p "" -o Solr Entity-SAMPL-TextSearch.txt
该命令生成文件 Solr-SAMPL-TextSearch.xml。请勿编辑该文件:可将该文件的各个部分复制到 Solr 文件 schema.xml。