エクスポートされたワークスペース アイテム (クエリー、グラフ、レポート、レポート書式)、
およびオリジナルの 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 }
] ]
説明
バージョン 7.1.1.0 より、IBM Rational ClearQuest は、エクスポートされたワークスペース アイテム、
およびオリジナルの ClearQuest Designer で作成されたフォーム ファイルに、ヘッダー情報を追加します。
ヘッダーには、ファイル エクスポート元の ClearQuest データベースのデータ コード ページに関する情報が含まれています。
このヘッダーにより、エクスポートされたファイルが、異なるコード ページを使用している可能性がある他の
ClearQuest データベースに正しくインポートされるようになります。
バージョン 7.1.1.0 より前の ClearQuest では、
エクスポートされたワークスペース アイテムおよびフォーム ファイルに、コード ページ ヘッダーはありません。
バージョン 7.1.1.0 の前後の ClearQuest クライアントを混在させて使用していて、
バージョン 7.1.1.0 の前後の異なる ClearQuest クライアントを使用してワークスペース アイテムおよびフォーム ファイルをエクスポートまたはインポートする場合、
cpheader コマンドを使用して、コード ページ ヘッダーを追加および削除し、バージョンをまたがるクライアント互換性を有効にします。
これにより、エクスポートされたファイルが、
それをエクスポートしたクライアントとは異なるバージョンの ClearQuest クライアントでインポートするための正しい形式に変換可能になります。
cpheader コマンドを使用して、
ワークスペース アイテム、およびオリジナルの ClearQuest Designer で作成されたフォーム ファイルを、UTF-8
(8 ビット Unicode Transformation Format) コード ページの 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 に一致した名前のファイルのみに対して、
コード ページ ヘッダーが追加または削除されます。
regular expression を指定しないと、ディレクトリおよびそのサブディレクトリ内のすべてのファイルに対して、
コード ページ ヘッダーが追加または削除されます。
- code-page
- Rational ClearQuest データ コード ページ。
例
- ファイル c:/all_defects.qry に西ヨーロッパのデータ コード ページ 1252 のヘッダーを追加します。
cqperl cpheader.pl -a c:/all_defects.qry 1252
- ディレクトリ c:/queries およびそのサブディレクトリ内のすべてのファイルに、
中国語 (簡体字) のデータ コード ページ 936 のヘッダーを追加します。
cqperl cpheader.pl -a c:/queries 936
- ディレクトリ c:/queries およびそのサブディレクトリの中で、
.cfg$ という式に一致するすべてのファイルに、中国語 (簡体字) のデータ コード ページ 936 のヘッダーを追加します。
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