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。
如果要列出 XML 檔中的 Build Forge 物件,請只指定 -L 選項和 XML 檔名稱。下列範例顯示局部的指令輸出。
|
如果要匯入 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 | 取代所匯入的物件,而不是將它們重新命名。依預設,匯入的物件會重新命名,並採用下列的命名慣例:
若為 7.1 物件,如果您指定取代選項,bfimport 指令會針對 7.1 物件,改寫使用者介面中的物件。 若為 7.0.2 和更早的物件,則不會取代 Snapshot 物件。系統會採用下列的命名慣例來將它們重新命名:
重要: 在評估是否要取代 Snapshot 物件時會以 UUID 為依據,而不是名稱。
如需詳細資料,請參閱匯入時重新命名與取代物件。 |