在导出的工作空间项(查询、图表、报告和报告格式)以及表单文件(使用原始 Rational ClearQuest Designer 创建)中添加和除去数据代码页头信息。
摘要
- cqperl cpheader.pl -a [ file-path |
[ directory-path { regular-expression }
] ] code-page
- cqperl cpheader.pl -s [ file-path |
[ directory-path { regular-expression }
] ]
描述
从 V7.1.1.0 开始,IBM Rational ClearQuest 会为已导出的工作空间项和表单文件(通过使用原始 ClearQuest Designer 创建)添加头信息。
头包含有关从中导出这些文件的 ClearQuest 数据库的数据代码页的信息。头确保导出的文件能正确导入另一个可能使用不同代码页的 ClearQuest 数据库。
在 ClearQuest V7.1.1.0 之前的版本中,导出的工作空间项和表单文件没有代码页头。
如果您混合使用 V7.1.1.0 之前和之后版本的 ClearQuest 客户机,并且希望通过使用这些客户机导出或导入工作空间项,那么需要使用 cpheader 命令来添加和除去代码页头,以启用跨版本的客户机兼容性。这样会允许将导出的文件转换为适当的格式,以便可由不同于导出文件的 ClearQuest 客户机版本的客户机将其导入。
通过使用 cpheader 命令,可以将工作空间项和表单文件(使用原始 ClearQuest Designer 创建)迁移到使用 UTF-8(8 位 Unicode 转换格式)代码页的 ClearQuest 数据库中。通过使用该命令,可以防止将工作空间项和表单文件导入到与所导出文件的代码页不匹配的 ClearQuest 数据库,从而防止发生数据损坏。UTF-8 支持来自所有代码页的字符,因此,您可将所有代码页导入到支持 UTF-8 代码页的数据库。
注意: ClearQuest Eclipse Designer 将表单导出为 XML 格式,这种格式包含代码页信息。请勿对从 ClearQuest Eclipse Designer 导出的表单使用 cpheader 命令。
选项和自变量
- -a
- 将数据代码页头添加到指定目录及其子目录中的一个或多个指定文件中。
- -s
- 从指定目录及其子目录中的一个或多个指定文件中除去数据代码页头。
- file-path
- 要添加或除去代码页头的文件的路径规范。
- directory-path { regular-expression }
- 目录的路径规范,该目录包含要添加或除去代码页头的文件。如果您指定 regular-expression,那么只会针对目录及其子目录中名称与 regular-expression 匹配的文件添加或除去代码页头。
如果不指定正则表达式,那么会针对目录及其子目录中的所有文件添加或除去代码页头。
- code-page
- Rational ClearQuest 数据代码页。
示例
- 将针对西欧数据代码页 1252 的头添加到文件 c:/all_defects.qry 中:
cqperl cpheader.pl -a c:/all_defects.qry 1252
- 将针对简体中文数据代码页 936 的头添加到目录 c:/queries 及其子目录中的所有文件:
cqperl cpheader.pl -a c:/queries 936
- 将针对简体中文数据代码页 936 的头添加到目录 c:/queries 及其子目录中与表达式 .cfg$ 匹配的所有文件。
cqperl cpheader.pl -a c:/queries .cfg$ 936
- 从文件 c:/alldefect.qry 中除去代码页头:
cqperl cpheader.pl -s c:/alldefect.qry
- 从目录 c:/qrydir 及其子目录的所有文件中除去代码页头:
cqperl cpheader.pl -s c:/qrydir