cpheader

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:

    1. 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.
    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 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:

    1. 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.
    2. Usar o comando cpheader para incluir o cabeçalho da página de códigos 932 em todos os arquivos que você exportou.
    3. 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.
    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á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.

    1. Exportar os itens da área de trabalho e os arquivos de formulários usando um cliente de versão 7.1.1.
    2. 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.
    3. 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

Consulte também

bkt_tool


Feedback