cpheader

Añade y elimina datos de cabecera de página de códigos de datos hacia y desde elementos del espacio de trabajo exportados (consultas, gráficas, informes, formatos de informes) y archivos de formularios creados con el Rational ClearQuest Designer original.

Sinopsis

cqperl cpheader.pl -a [ file-path | [ directory-path { regular-expression } ] ] code-page
cqperl cpheader.pl -s [ file-path | [ directory-path { regular-expression } ] ]

El mandato cpheader se encuentra en el directorio de instalación de Rational ClearQuest.

Descripción

Comenzando en la versión 7.1.1.0, IBM® Rational ClearQuest añade datos de cabecera hacia elementos de espacio de trabajo exportados y hacia archivos de formularios creados con ClearQuest Designer. La cabecera contiene información sobre la página de códigos de datos de la base de datos de ClearQuest desde la que se exportan los archivos. La cabecera asegura que los archivos exportados se importen correctamente a otras bases de datos de ClearQuest que puedan utilizar una página de códigos diferente.

En las versiones de ClearQuest anteriores a 7.1.1.0, los elementos de espacio de trabajo exportados y los archivos de formulario no tienen una cabecera de página de códigos.

Si utiliza una combinación de clientes de ClearQuest de la versión 7.1.1.0 anterior y posterior y desea exportar o importar los elementos del espacio de trabajo y los archivos de formulario utilizando distintos clientes de ClearQuest de la versión 7.1.1.0 anterior y posterior, utilice el mandato cpheader para añadir y eliminar cabeceras de página de códigos a fin de habilitar la compatibilidad de clientes entre versiones. Esto permitirá a los archivos exportados que se conviertan en el formato apropiado para que un cliente de ClearQuest los importe en una versión distinta a la del cliente que exportó los archivos.

Utilice el mandato cpheader para migrar los elementos del espacio de trabajo y los archivos de formulario creados con ClearQuest Designer original en una base de datos de ClearQuest con una página de códigos UTF-8 (8-bit Unicode Transformation Format). Si utiliza este mandato, impide que se importen elementos del espacio de trabajo y archivos de formulario en una base de datos de ClearQuest que no coincidan con la página de códigos de los archivos exportados y, así, se impide la corrupción de los datos. UTF-8 soporta caracteres de todas las páginas de códigos, por lo que puede importar todas las páginas de códigos en una base de datos que soporte la página de códigos UTF-8.

Atención: ClearQuest Eclipse Designer exporta formularios a formato XML, que contiene información de página de código. No utilice el mandato cpheader en formularios exportados desde ClearQuest Eclipse Designer.

Opciones y argumentos

-a
Añadir la cabecera de página de códigos de datos al archivo o archivos especificados en el directorio especificado y en sus subdirectorios.
-s
Eliminar la cabecera de página de códigos de datos del archivo o archivos especificados en el directorio especificado y de sus subdirectorios.
file-path
Especificación de vía de acceso del archivo para el que añadir o eliminar la cabecera de página de códigos.
directory-path { regular-expression }
Especificación de vía de acceso del directorio que contiene los archivos para los que añadir o eliminar la cabecera de página de códigos. Si especifica una regular-expression, la cabecera de la página de códigos se añadirá o se eliminará sólo de los archivos situados en el directorio y en sus subdirectorios con un nombre que concuerde con la regular-expression. Si no especifica una expresión regular, la cabecera de la página de códigos se añadirá o se eliminará de todos los archivos situados en el directorio y en sus subdirectorios.
code-page
Página de códigos de datos de Rational ClearQuest.

Casos de uso

  • Caso de uso 1: Migrar elementos del espacio de trabajo y los archivos de formulario de Designer original de una base de datos ClearQuest anterior a la versión 7.1.1 a una base de datos de ClearQuest 7.1.1 en UTF-8 (65001).

    Solución preferida:

    Utilice un cliente ClearQuest 7.1.1 para exportar los elementos del espacio de trabajo y los archivos de formulario de Designer original de la base de datos ClearQuest anterior a la versión 7.1.1 y para importar los elementos del espacio de trabajo y los archivos de formulario en la base de datos UTF-8. Con esta solución, ClearQuest maneja automáticamente la información de cabecera de página de códigos de los datos, convirtiendo los archivos de páginas de códigos distintas al formato UTF-8.

    Solución alternativa:

    1. Determine la página de códigos de los datos de la base de datos de ClearQuest de la que desea exportar los elementos del espacio de trabajo y los archivos de formulario de Designer original.
    2. Utilice un cliente ClearQuest anterior a la versión 7.1.1 o el mandato bkt_tool, para exportar los elementos del espacio de trabajo desde la base de datos de ClearQuest anterior a la versión 7.1.1.
    3. Utilice el Designer original anterior a la versión 7.1.1 para exportar los archivos de formulario de la base de datos de ClearQuest anterior a la versión 7.1.1.
    4. Utilice el mandato cpheader, incorporado en ClearQuest 7.1.1, para añadir la cabecera de página de códigos UTF-8 (65001) a los archivos que acaba de exportar en los pasos 2 y 3.
    5. Utilice un cliente ClearQuest 7.1.1 para importar los elementos del espacio de trabajo y los archivos de formulario en la base de datos UTF-8.

    Ejemplo:

    Tiene una base de datos de ClearQuest 7.0 con código de página 932 en un sistema. En un segundo sistema, instala ClearQuest 7.1.1 y crea una base de datos de ClearQuest con página de códigos de datos 65001 (UTF-8). El objetivo es mover los elementos del espacio de trabajo y los archivos de formulario de la base de datos de ClearQuest 7.0 a la base de datos UTF-8 de ClearQuest 7.1.1 sin actualizar en primer lugar la base de datos de ClearQuest 7.0.

    Solución de ejemplo:

    1. Utilice un cliente ClearQuest 7.0 si desea exportar sólo algunos elementos del espacio de trabajo. Para exportar todos los elementos del espacio de trabajo, utilice el mandato bkt_tool. Para exportar archivos de formulario del Designer original, utilice el Designer original.
    2. Utilice el mandato cpheader para añadir la cabecera de página de códigos 932 a todos los archivos que ha exportado.
    3. Copie los archivos exportados con la cabecera de página de códigos 932 al sistema que ejecuta ClearQuest 7.1.1.
    4. Utilice el cliente de ClearQuest 7.1.1 o el mandato bkt_tool para importar elementos del espacio de trabajo en la base de datos UTF-8 de ClearQuest 7.1.1. Utilice el Designer original para importar los archivos de formulario.

  • Caso de uso 2: Migrar elementos del espacio de trabajo y los archivos de formulario de Designer original de una base de datos de ClearQuest anterior a la versión 7.1.1 a otra utilizando un cliente de la versión 7.1.1 para exportar los archivos, y un cliente anterior a la versión 7.1.1 y el Designer original para importar los archivos.

    Solución:

    Debe asegurarse de que la base de datos desde la que está exportando y la base de datos a la que está importando tengan la misma página de códigos.

    1. Exporte los elementos del espacio de trabajo y los archivos de formulario utilizando un cliente de la versión 7.1.1.
    2. Utilice el mandato cpheader para eliminar la cabecera de página de códigos de los archivos exportados.
      Atención: Si no se realiza este paso es posible que los datos resulten dañados.
    3. Utilice un cliente anterior a la versión 7.1.1 o el mandato bkt_tool para importar los elementos del espacio de trabajo en la segunda base de datos. Utilice el Designer original para importar los archivos de formulario en la segunda base de datos.

Ejemplos

  • Añadir la cabecera para la página de códigos de datos del oeste de Europa 1252 al archivo c:/all_defects.qry:
    cqperl cpheader.pl -a c:/all_defects.qry 1252
  • Añadir la cabecera para la página de códigos de datos para el chino simplificado 936 a todos los archivos del directorio c:/queries y a los subdirectorios:
    cqperl cpheader.pl -a c:/queries 936
  • Añadir la cabecera para la página de códigos de datos para el chino simplificado 936 a todos los archivos del directorio c:/queries y a los subdirectorios que coincidan con la expresión .cfg$:
    cqperl cpheader.pl -a c:/queries .cfg$ 936
  • Eliminar la cabecera de la página de códigos desde el archivo c:/alldefect.qry:
    cqperl cpheader.pl -s c:/alldefect.qry
  • Eliminar la cabecera de la página de códigos desde todos los archivos del directorio c:/qrydir y de los subdirectorios:
    cqperl cpheader.pl -s c:/qrydir

Consulte también

bkt_tool


Comentarios