Inclui e remove informações de cabeçalho da página de códigos de dados
de itens exportados da área de trabalho (consultas, gráficos, relatórios, formatos de relatórios)
e de arquivos de formulário criados usando o Rational ClearQuest Designer original.
Sinopse
- cqperl cpheader.pl -a [ file-path |
[ directory-path { regular-expression }
] ] code-page
- cqperl cpheader.pl -s [ file-path |
[ directory-path { regular-expression }
] ]
O comando cpheader está localizado no diretório de instalação do Rational ClearQuest.
Descrição
A partir da versão 7.1.1.0, o IBM® Rational ClearQuest inclui informações de cabeçalho nos
itens de área de trabalho exportados e nos arquivos de formulário criados usando o ClearQuest Designer original. O
cabeçalho contém informações sobre a página de códigos de dados do banco de dados do ClearQuest do qual
os arquivos são exportados. O cabeçalho assegura que os arquivos
exportados sejam importados corretamente para outros bancos de dados do ClearQuest que possam usar uma
página de códigos diferente.
Nas versões do ClearQuest
anteriores à 7.1.1.0, os itens de área de trabalho exportados e os arquivos de formulário não
possuem um cabeçalho de página de códigos.
Se você estiver usando uma combinação de versões
pré e pós 7.1.1.0 de clientes ClearQuest
e deseja exportar ou importar os itens da área de trabalho e os arquivos de formulário
usando versões pré e pós 7.1.1.0 diferentes dos clientes ClearQuest, use o comando cpheader
para incluir e remover os cabeçalhos das páginas de códigos e ativar a compatibilidade de clientes com
versão cruzada. Isso permite que os arquivos exportados sejam convertidos no
formato adequado para importação por um cliente ClearQuest
em uma versão diferente à do cliente que exportou os arquivos.
Use
o comando cpheader para migrar os itens da área de trabalho e os arquivos de
formulário criados usando o ClearQuest Designer original em um banco de dados do ClearQuest com uma página de códigos UTF-8 (8-bit
Unicode Transformation Format). Ao usar esse comando, você
evita a importação de itens da área de trabalho e de arquivos de formulário para um banco de dados do ClearQuest que não correspondem
à página de códigos dos arquivos exportados, evitando, assim, a distorção de dados.
O UTF-8 suporta caracteres de todas as páginas de códigos, para
que você possa importar todas as páginas de códigos em um banco de dados que suporte
a página de códigos UTF-8.
Atenção: O ClearQuest Eclipse
Designer exporta formulários no formato XML, que contém informações da página de códigos.
Não use o comando cpheader em formulários exportados
do ClearQuest Eclipse
Designer.
Opções e Argumentos
- -a
- Inclua o cabeçalho da página de códigos de dados no arquivo ou arquivos especificados
no diretório especificado e seus subdiretórios.
- -s
- Remove o cabeçalho da página de códigos de dados do arquivo ou arquivos especificados
no diretório especificado e seus subdiretórios.
- file-path
- Especificação do caminho do arquivo no qual o cabeçalho da página de códigos é
incluído ou removido.
- directory-path { regular-expression }
- Especificação do caminho do diretório que contém os arquivos para os quais o cabeçalho da página de códigos será
incluído ou removido. Se você especificar uma regular-expression,
o cabeçalho da página de códigos será incluído ou removido apenas dos arquivos
no diretório e seus subdiretórios que contêm um nome que corresponda a regular-expression.
Se você não especificar uma expressão regular,
o cabeçalho da página de códigos será incluído ou removido de todos os arquivos
no diretório e seus subdiretórios.
- code-page
- Página de códigos de dados do Rational ClearQuest.
Casos de Uso
- Caso de uso 1: Migre itens da área de trabalho e arquivos de formulário do Designer
original de um banco de dados do ClearQuest anterior à
versão 7.1.1 para um banco de dados UTF-8 (65001) do ClearQuest
7.1.1.
Solução preferida:
Use
um cliente ClearQuest 7.1.1
para exportar os itens da área de trabalho e os arquivos de formulário do Designer original
do banco de dados do ClearQuest anterior
à versão 7.1.1 e para importar itens da área de trabalho e arquivos de formulário para
o banco de dados UTF-8. Com esta solução, o ClearQuest trata automaticamente as informações
do cabeçalho da página de códigos de dados, convertendo os arquivos das diferentes
páginas de código no formato UTF-8.
Solução alternativa:
- Determine a página de códigos de dados do banco de dados do ClearQuest da qual você deseja
exportar os itens da área de trabalho e os arquivos de formulário do Designer original.
- Use um cliente ClearQuest anterior à
versão 7.1.1 ou o comando bkt_tool para exportar os itens da área
de trabalho do banco de dados do ClearQuest anterior
à versão 7.1.1.
- Use o Designer original da versão anterior à 7.1.1 para exportar os arquivos de
formulário do banco de dados do ClearQuest anterior à
versão 7.1.1.
- Use o comando cpheader, apresentado no ClearQuest 7.1.1, para incluir o cabeçalho da página de
códigos UTF-8 (65001) nos arquivos que acabaram de ser exportados nas etapas 2 e
3.
- Use um cliente ClearQuest 7.1.1
para importar itens da área de trabalho e arquivos de formulário para o banco de
dados UTF-8.
Exemplo:
Você possui um banco de dados do ClearQuest 7.0 com a página de códigos
932 em um computador. Em um segundo computador, você instalará o ClearQuest 7.1.1 e criará um banco de dados do ClearQuest com
a página de códigos de dados 65001 (UTF-8). Seu objetivo é mover itens da área de
trabalho e arquivos de formulário do banco de dados do ClearQuest 7.0
para o banco de dados UTF-8 do ClearQuest 7.1.1
sem primeiro fazer upgrade do banco de dados do ClearQuest 7.0.
Solução de exemplo:
- Usar um cliente ClearQuest 7.0 se desejar exportar apenas alguns itens da área de trabalho. Para exportar todos os itens da área de trabalho, use o comando bkt_tool. Para exportar arquivos de formulários do Designer original, use o Designer original.
- Usar o comando cpheader para incluir o cabeçalho da página de códigos 932 em
todos os arquivos que você exportou.
- Copie os arquivos exportados com o cabeçalho da página de códigos 932 para o computador
que estiver executando o ClearQuest 7.1.1.
- Use o cliente ClearQuest 7.1.1
ou o comando bkt_tool para importar os itens da área de trabalho
para o banco de dados UTF-8 do ClearQuest
7.1.1. Use o Designer original para importar os arquivos de formulários.
- Caso de uso 2: Migre itens da área de trabalho e arquivos de formulário do
Designer original de um banco de dados do ClearQuest anterior à
versão 7.1.1 para outro usando um cliente versão 7.1.1 para exportar
os arquivos e um cliente anterior à versão 7.1.1 e o Designer original
para importar os arquivos.
Solução:
Você deve certificar-se de que o banco de dados do qual está exportando e o banco de dados para o qual está importando tenham a mesma página de códigos.
- Exportar os itens da área de trabalho e os arquivos de formulários usando um cliente de versão 7.1.1.
- Usar o comando cpheader para remover o cabeçalho da página de códigos dos arquivos exportados.
Atenção: Falha ao executar esta etapa pode resultar em distorção de dados.
- Usar o cliente de uma versão anterior à 7.1.1 ou o comando bkt_tool para
importar os itens da área de trabalho para o segundo banco de dados. Use o Designer original
para importar os arquivos de formulários para o segundo banco de dados.
Exemplos
- Incluir o cabeçalho na página de códigos de dados 1252 do Oeste Europeu no arquivo c:/all_defects.qry:
cqperl cpheader.pl -a c:/all_defects.qry 1252
- Incluir o cabeçalho na página de códigos de dados 936 do chinês simplificado em
todos os arquivos no diretório c:/queries e seus subdiretórios:
cqperl cpheader.pl -a c:/queries 936
- Incluir o cabeçalho da página de códigos de dados 936 do chinês simplificado em
todos os arquivos no diretório c:/queries e seus subdiretórios correspondidos pela expressão .cfg$:
cqperl cpheader.pl -a c:/queries .cfg$ 936
- Remover o cabeçalho da página de códigos do arquivo c:/alldefect.qry:
cqperl cpheader.pl -s c:/alldefect.qry
- Remover o cabeçalho da página de códigos de todos os arquivos no diretório c:/qrydir e seus
subdiretórios:
cqperl cpheader.pl -s c:/qrydir