É possível incluir tipos de registro no índice de procura de texto completa
para que esses tipos de registro sejam pesquisáveis.
Antes de Iniciar
Este cenário requer algum planejamento. Para cada tipo de registro que você
inclui no índice de procura, deverá decidir quais campos indexar e o campo de
exibição para o tipo de registro.
Sobre Esta Tarefa
Este cenário presume que você tenha implementado a procura de texto completa
no banco de dados SAMPL conforme descrito em
Ativando a procura
de texto completa no banco de dados SAMPL. Você deseja incluir um ou mais tipos de
registro no índice de procura para que esses tipos de registro sejam pesquisáveis.
Este
cenário deve demorar aproximadamente 10 minutos para ser concluído porque o
banco de dados SAMPL tem poucos registros.
Procedimento
- Edite o arquivo de configuração cqtsadmin-TextSearch-SAMPL.xml
para incluir ChangeRequest como tipo de registro a ser incluído no
índice de procura de texto completa. Faça isso mudando o valor da
identificação XML
<addRecordType> deste:
<newValue required="no"></newValue>
para esta:
<newValue required="no">ChangeRequest=Description,&Headline,Keywords,Owner,Project,Team</newValue>
Observe que & é pré-anexado ao Headline. Essa
é a codificação XML do caractere de e comercial (&), que é usado
para selecionar o campo de exibição para o tipo de registro.
- Opcional: Para incluir vários tipos de registro, separe cada um com um
ponto-e-vírgula (;).
O próximo exemplo também inclui
TestCase como tipo de registro a ser incluído no índice de procura:
<newValue required="no">ChangeRequest=Description,&Headline,Keywords,Owner,Project,Team;TestCase=Description,&Headline,Keywords,Owner,Project,Team</newValue>
- Execute o comando cqtsadmin.pl, com a opção
add_record_type, em uma janela de prompt de comandos.
Importante: Em um ambiente de produção, certifique-se de fazer backup de sua
implementação antes de executar o comando cqtsadmin.pl com a opção
add_record_type.
Execute esse comando durante horas de menor
atividade porque a operação pode levar de alguns minutos a alguns dias para ser
concluída, dependendo do tamanho do banco de dados e do número de registros afetados.
cqperl
cqtsadmin.pl --username admin --password secret --dbset TextSearch
--userdb SAMPL --ftshome D:\CQ.Search --add_record_type
A execução do comando cqtsadmin.pl com a opção
add_record_type é uma operação stateful. Se você parar o comando ou
ele for interrompido devido a um erro, quando você executar novamente o comando, ele
continuará de onde parou e prosseguirá até a conclusão.
- Edite o arquivo cqtsadmin-TextSearch-SAMPL.xml novamente para
remover os tipos de registro incluídos na tag <addRecordType> nas
Etapas 1 e
2.
Resultados
Você incluiu um ou mais tipos de registro no índice de procura.
Os usuários do
ClearQuest Web client devem efetuar logoff e logon novamente para ver os tipos de
registro recentemente incluídos nos resultados da procura.