cpheader

Inclui e remove as informações do cabeçalho da página de códigos de dados para e dos itens da área de trabalho exportados (consultas, gráficos, relatórios, formatos de relatórios) e de arquivos de formato 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 do cabeçalho para os itens da área de trabalho exportados e para os 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 ClearQuest do qual os arquivos são exportados. O cabeçalho assegura que os arquivos exportados são importados corretamente em outros bancos de dados ClearQuest, que podem 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 arquivos de formulário não possuem um cabeçalho de página de códigos.

Se estiver usando uma combinação de versão pré e pós 7.1.1.0 dos clientes ClearQuest e deseja exportar ou importar os itens da área de trabalho e arquivos de formulário usando a versão pré e pós 7.1.1.0 dos clientes ClearQuest, use o comando cpheader para incluir e remover os cabeçalhos das páginas de códigos para ativar a compatibilidade de clientes com versões cruzadas. Isso permite que os arquivos exportados sejam convertidos em um 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 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 este comando, você evita a importação de itens da área de trabalho e arquivos de formulário em um banco de dados ClearQuest que não corresponde à página de códigos dos arquivos exportados e evita, assim, a distorção de dados. UTF-8 suporta caracteres de todas as páginas de códigos, então é possível importar todas as páginas de códigos em um banco de dados que suporta a página de códigos UTF-8.

Atenção: O ClearQuest Eclipse Designer exporta formulários no formato XML, que contém as 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 um cabeçalho da página de códigos de dados aos arquivos especificados no diretório especificado e seus subdiretórios.
-s
Remova o cabeçalho da página de códigos de dados do(s) arquivo(s) especificado(s) no diretório especificado e seus subdiretórios.
file-path
Especificação de caminho do arquivo ao qual incluir ou remover o cabeçalho da página de códigos.
directory-path { regular-expression }
Especificação de caminho do diretório contendo os arquivos nos quais incluir ou remover o cabeçalho da página de códigos. Se você especificar uma regular-expression, o cabeçalho da página de códigos é incluído ou removido apenas dos arquivos no diretório e seus subdiretórios com um nome que corresponda a regular-expression. Se você não especificar uma expressão regular, então o cabeçalho da página de códigos é 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 os 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 preferencial:

    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 no banco de dados UTF-8. Com esta solução, o ClearQuest automaticamente trata as informações do cabeçalho da página de códigos de dados, convertendo os arquivos de diferentes páginas de código para o formato UTF-8.

    Solução alternativa:

    1. Determine a página de códigos de dados do banco de dados do ClearQuest da qual deseja exportar os itens da área de trabalho e os arquivos de formulário do Designer original.
    2. 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.
    3. 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.
    4. 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.
    5. Use um cliente ClearQuest 7.1.1 para importar itens da área de trabalho e arquivos de formulário no banco de dados de 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 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:

    1. Use 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 os arquivos de formulário do Designer original, use o Designer original.
    2. Use o comando cpheader para incluir o cabeçalho da página de códigos 932 em todos os arquivos que exportou.
    3. Copie os arquivos exportados com o cabeçalho da página de códigos 932 no computador que estiver executando o ClearQuest 7.1.1.
    4. 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ário.

  • 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.

    1. Exporte os itens da área de trabalho e arquivos de formulário usando um cliente versão 7.1.1.
    2. Use o comando cpheader para remover o cabeçalho da página de códigos dos arquivos exportados.
      Atenção: A falha na execução desta etapa pode resultar em distorção de dados.
    3. Use um cliente anterior à versão 7.1.1 ou o comando bkt_tool para importar os itens da área de trabalho no segundo banco de dados. Use o Designer original para importar os arquivos de formulário no segundo banco de dados.

Exemplos

  • Inclua o cabeçalho para a página de códigos de dados da Europa Ocidental 1252 no arquivo c:/all_defects.qry:
    cqperl cpheader.pl -a c:/all_defects.qry 1252
  • Inclua o cabeçalho para a página de códigos de chinês simplificado 936 em todos os arquivos no diretório c:/queries e seus subdiretórios:
    cqperl cpheader.pl -a c:/queries 936
  • Inclua o cabeçalho para a página de códigos de chinês simplificado 936 em todos os arquivos no diretório c:/queries e seus subdiretórios correspondentes à expressão .cfg$:
    cqperl cpheader.pl -a c:/queries .cfg$ 936
  • Remova o cabeçalho da página de códigos do arquivo c:/alldefect.qry:
    cqperl cpheader.pl -s c:/alldefect.qry
  • Remova 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

Consulte Também

bkt_tool


Feedback