在利用原始 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 } ] ]
cpheader 指令位於 Rational ClearQuest 安裝目錄中。
說明
從 7.1.1.0 版開始,IBM® Rational ClearQuest 會在利用原始 ClearQuest Designer 所建立的匯出工作區項目和表單檔中新增標頭資訊。該標頭包含從中匯出檔案之 ClearQuest 資料庫的資料字碼頁相關資訊。該標頭可確保匯出的檔案能正確匯入其他使用不同字碼頁的 ClearQuest 資料庫中。
在 ClearQuest 7.1.1.0 版之前,匯出的工作區項目和表單檔並沒有字碼頁標頭。
如果您是使用混合 7.1.1.0 版之前與之後的 ClearQuest 用戶端,且您要使用不同 7.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 資料字碼頁。
使用案例
- 使用案例 1:將工作區項目及原始 Designer 表單檔,從 ClearQuest 7.1.1 版前的資料庫中移轉至 ClearQuest 7.1.1 UTF-8 (65001) 資料庫。
偏好的解決方案:
使用 ClearQuest 7.1.1 用戶端,從 ClearQuest 7.1.1 版前的資料庫中匯出工作區項目及原始 Designer 表單檔,然後將工作區項目及表單檔匯入 UTF-8 資料庫。利用此解決方案,ClearQuest 會自動處理資料字碼頁標頭資訊,將不同字碼頁的檔案轉換為 UTF-8 格式。
替代解決方案:
- 決定 ClearQuest 資料庫的資料字碼頁,您想要從該資料庫匯出工作區項目及原始 Designer 表單檔。
- 使用 ClearQuest 7.1.1 版前的用戶端或指令 bkt_tool,從 ClearQuest 7.1.1 版前的資料庫中匯出工作區項目。
- 使用 7.1.1 版前的原始 Designer,從 ClearQuest 7.1.1 版前的資料庫中匯出表單檔。
- 使用 ClearQuest 7.1.1 中開始採用的指令 cpheader,將 UTF-8 (65001) 字碼頁標頭新增到您剛才在步驟 2 及 3 中匯出的檔案。
- 使用 ClearQuest 7.1.1 用戶端,將工作區項目及表單檔匯入 UTF-8 資料庫。
範例:
您在某部電腦上有字碼頁為 932 的 ClearQuest 7.0 資料庫。在第二部電腦上,您安裝 ClearQuest 7.1.1,並建立資料字碼頁為 65001 (UTF-8) 的 ClearQuest 資料庫。您的目標是在未事先升級 ClearQuest 7.0 資料庫的情況下,將工作區項目及表單檔從 ClearQuest 7.0 資料庫移至 ClearQuest 7.1.1 UTF-8 資料庫。
範例解決方案:
- 如果您只要匯出一些工作區項目,請使用 ClearQuest 7.0 用戶端。若要匯出所有工作區項目,請使用 bkt_tool 指令。若要匯出原始 Designer 表單檔,請使用原始 Designer。
- 使用 cpheader 指令,將 932 字碼頁標頭新增到已匯出的所有檔案。
- 將具有 932 字碼頁標頭的已匯出檔案,複製到正在執行 ClearQuest 7.1.1 的電腦。
- 使用 ClearQuest 7.1.1 用戶端或 bkt_tool 指令,將工作區項目匯入至 ClearQuest 7.1.1 UTF-8 資料庫。請使用原始 Designer 來匯入表單檔。
- 使用案例 2:使用 7.1.1 版用戶端來匯出檔案,並使用 7.1.1 版前的用戶端及原始 Designer 來匯入檔案,將工作區項目及原始 Designer 表單檔從某個 ClearQuest 7.1.1 版前的資料庫移轉至另一個資料庫。
解決方案:
您必須確保正在匯出資料的資料庫,與正在匯入資料的資料庫具有相同的字碼頁。
- 使用 7.1.1 版用戶端,匯出工作區項目及表單檔。
- 使用 cpheader 指令,從已匯出檔案移除字碼頁標頭。
- 使用 7.1.1 版前的用戶端或 bkt_tool 指令,將工作區項目匯入第二個資料庫。使用原始 Designer,將表單檔匯入第二個資料庫。
範例
- 將西歐資料字碼頁 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