bfimport 參照

bfimport 公用程式可用來將專案和其他物件的定義,匯入至先前曾匯出至 XML 檔的使用者介面中。您也可以使用「匯入」公用程式,從 XML 檔匯入選取的檔案。

這個主題說明 bfimport 指令的語法,並提供用法詳細資料。

語法

bfimport

bfimport [-L] <file_name>
bfimport [-p -I -s -S -e -c -C -u -T -f -d -r ] <file_name.xml>
bfimport [-L | [-p -I -s -S -e -c -C -u -T -f -d -r ]] <file_name.xml>

限制與考量

匯出檔中不會包含伺服器的授權密碼;您必須手動輸入伺服器授權密碼。

依預設,在匯入時,如果有物件的名稱與所匯入的物件相同則會重新命名要匯入的物件,以防資料庫物件遭到改寫。或者,如果存在同名的物件,您可以選擇使用 -r 選項來取代物件。就 Snapshot 物件而言,將會依 UUID 來比較物件,而不是依名稱。

依預設,bfimport 會重新命名物件,並採用下列的命名慣例:

<object_name>_IMPORT_<number>

為了重新命名,Snapshot 物件會失去其 Snapshot 名稱,並匯入成新的基礎或母項層次的 Snapshot,即使該 Snapshot 物件是某個母項 Snapshot 的子項。

如需重新命名的詳細資料,請參閱匯入時重新命名與取代物件

如果要取代物件,您必須指定 -r 選項。取代選項會改寫現有的物件。若為 7.0.2 及更早版本的匯出檔,則不會取代 Snapshot 物件,而會使用 <object_name>>_IMPORT_<number> 慣例將它們重新命名。若為 7.1 匯出檔,則會在 UUID 相符時取代 Snapshot 物件。

必備條件

以 bfexport 指令或 .export 點指令建立的匯出 XML 檔。

請在 Build Forge 安裝目錄中尋找 bfimport 公用程式。

bfimport 指令必須能夠找到 buildforge.conf 檔,以及存取 Build Forge 資料庫。請從 buildforge.conf 所在的目錄執行 bfimport,此目錄在 Windows 上是 <bfinstall>,而在 UNIX 及 Linux 上則是 <bfinstall>/Platform。

用法

如果要完成一般的匯入作業,請使用下列的指令選項:
  • 如果要顯示指令語法,請直接使用 bfimport(不含任何選項)。
  • 若要顯示 XML 檔中的 Build Forge 物件的摘要清單與其名稱,請使用 bfimport -L <file_name.xml>
  • 在 zLinux 平台上,您必須將指令執行成 bfexport.pl。若為其他所有平台,指令不需要副檔名。
  • 如果您沒有指定選項,則不會匯入任何物件。必須指定選項,以匯入個別的物件。
  • 如果您針對不存在的物件指定選項,則匯入公用程式會跳過不存在於 XML 檔中的物件,並匯入位於檔案中的物件。

範例

如果要列出 XML 檔中的 Build Forge 物件,請只指定 -L 選項和 XML 檔名稱。下列範例顯示局部的指令輸出。

C:\Program Files\IBM\Build Forge>bfimport -L samples\projects\basic.xml
10/07/2008 5:31:55 PM: Import: 7624: CRRBF20081I: Importing export
file from a 7.0.10025 version console.
Project : [Basic Sample]
		Tag Variable : [MAJ]
		Tag Variable : [MIN]
		Step : [Checkout Source]
		Step : [Update Applet Version]
		Step : [Create Baseline]
Environment : [Basic Environment]
Class : [Production]
Filter : []
Selector : [Web Server]
Selector : [Local Server]

如果要匯入 XML 檔中的所有物件,請按照以下範例所示,針對要匯入的物件指定選項。物件會在匯入時重新命名。成功陳述式顯示匯入是否成功。

C:\Program Files\IBM\Build Forge>bfimport -p -I -s -S -e -c -C -u -T -d -f 
"samples\projects\basic.xml"

選項說明

選項 說明
<file_name.xml> 內含所要匯入之 Build Forge 物件的匯出 XML 檔名稱。XML 檔必須是以 bfexport 指令或 .export 點指令建立的。如果 XML 檔不在現行目錄(即發出 bfexport 指令的目錄),則需要 XML 檔名,且必須提供路徑名稱。

如果檔名包含空格,必須用引號括住名稱。

-L

列出匯出 XML 檔中的物件和其物件名稱。請單獨使用這個選項;指定時請勿搭配其他任何的 bfimport 選項。 -L 選項的輸出可傳送至標準輸出,或重新導向至 XML 或文字檔。

-p 從 XML 檔匯入專案配置資料。專案配置資料內含步驟與專案定義資料,包含標籤變數在內。

在重新命名時,會將專案名稱匯入至使用者介面成為 <project_name>_IMPORT_<number>。

-I 匯入專案或步驟層次所參照的鏈結專案或程式庫。

在重新命名時,會在使用者介面中,將鏈結專案或程式庫匯入至使用者介面成為 <project_or_library_name>_IMPORT_<number>。

-S 匯入定義在使用者介面中的選取元物件。

在重新命名時,會將選取元匯入至使用者介面成為 <selector_name>_IMPORT_<number>。

-s 如果在 bfexport 中指定了 -s 選項,則會匯入定義在「管理主控台」中的伺服器物件。

在重新命名時,會將伺服器匯入至使用者介面成為 <server_name>_IMPORT_<number>。

匯出 XML 檔中不會包含伺服器的授權密碼;您必須手動輸入伺服器授權密碼。

-e 匯入專案或步驟層次所參照的環境和其變數。

在重新命名時,會將環境匯入為 <environment_name>_IMPORT_<number>。

-c 匯入專案所參照的類別。

在重新命名時,會將類別匯入為 <class_name>_IMPORT_<number>。

-C 如果在 bfexport 中指定了 -C 選項,則會匯入針對專案而指派給伺服器的收集器。

在重新命名時,會將收集器匯入為 <collector_name>>_IMPORT_<number>。

-u 如果在 bfexport 中指定了 -g 選項,則會匯入屬於指定來接收電子郵件通知之存取群組成員的使用者。

在重新命名時,會將使用者的資訊匯入為 <users>_IMPORT_<number>

-T 如果在 bfexport 中指定了 -n 選項,則會匯入使用者所建立指派給專案和步驟的通知範本。

在重新命名時,會將通知範本匯入為 <template_name>_IMPORT_<number>。

-f 如果在 bfexport 中指定了 -n 選項,則會匯入指派給專案步驟的日誌過濾器。

在重新命名時,會將日誌過濾器匯入為 <filter_name>_IMPORT_<number>。

-d 若有在 bfexport 中指定 -L 選項,則會匯入定義在使用者介面中的 LDAP 網域控制器。

在重新命名時,會將日誌過濾器匯入為 <LDAP_domain_controller>_IMPORT_<number>。

-r 取代所匯入的物件,而不是將它們重新命名。依預設,匯入的物件會重新命名,並採用下列的命名慣例:
<object_name>_IMPORT_<number>

若為 7.1 物件,如果您指定取代選項,bfimport 指令會針對 7.1 物件,改寫使用者介面中的物件。

若為 7.0.2 和更早的物件,則不會取代 Snapshot 物件。系統會採用下列的命名慣例來將它們重新命名:
<object_name>_IMPORT_<number>
重要: 在評估是否要取代 Snapshot 物件時會以 UUID 為依據,而不是名稱。

如需詳細資料,請參閱匯入時重新命名與取代物件


意見