匯入變更指令
將匯出的 ZIP 檔案複製到目標系統之後，您可以在目標系統執行 import 指令。
|
選項
|
是否必要？
|
描述 (Description)
|
||
|---|---|---|---|---|
|
-f
--filepath
|
是
|
要匯入之封裝 ZIP 檔案的位置或絕對路徑。
|
||
|
-o
--outputDirectory
|
否
|
儲存匯入記錄檔的位置。如果未指定此選項，檔案會儲存到目前目錄中。
匯入記錄檔的預設位置是 <WT_HOME>/${wt.temp}/bac/reports。您可以配置 wt.properties 中的內容 com.ptc.windchill.bac.import.report.location 以修改匯入記錄檔的預設位置。
|
||
|
-d
--defaultResolutions
|
否
|
|||
|
-s
--saveResolutions
|
否
|
|||
|
-c
--conflictResolutionFile
|
否
|
指定將在匯入期間使用之衝突解決方案 XML 檔案的路徑。衝突解決方案 XML 檔案指定不同的衝突類型及其對應的解決方案。如果您選取此選項與 --defaultResolutions、--saveResolutions、--reuseResolutions 或全部，會先實行 XML 載入檔案中提供的解決方案。如果 XML 檔案中的解決方案無法使用，會套用之前儲存的解決方案。
|
||
|
-b
--useBundledConflictResolutionFile
|
否
|
使用封裝 ZIP 檔案中可用的配套衝突解決方案檔案來解決匯入期間的衝突。如果您選取此選項與 --defaultResolutions、--saveResolutions、--reuseResolutions 或全部，會先實行配套衝突解決方案檔案中提供的解決方案。如果檔案中的解決方案無法使用，會套用之前儲存的解決方案。
|
||
|
-n
--useBundledMapFile
|
否
|
使用封裝 ZIP 檔案中可用的對應檔案，在匯入期間將來源屬性對應至目標屬性。
|
||
|
-i
--ignoreTargetCheckforGUID
|
否
|
指定將針對其略過對目標系統的檢查之來源系統的 GUID。
在匯入流程期間，來源系統的 GUID 可用來檢查其是否已向目標系統註冊。如果您設定此選項，會略過此檢查，且您可以從未註冊的來源系統匯入管理變更。
您也可以配置目標系統的 wt.properties 中的 com.ptc.windchill.bac.ignoreGUIDList 內容以指定來源系統的 GUID。這將會在匯入流程期間略過針對來源系統 ID 之指定清單進行的檢查。如果您為 --ignoreTargetCheckforGUID 和 com.ptc.windchill.bac.ignoreGUIDList 指定不同的 GUID 值，為 --ignoreTargetCheckforGUID 指定的 GUID 將優先。
|
||
|
-v
--ValidateTarget
|
否
|
用來驗證目標系統 GUID 的指令。這僅對開發模式有效。依預設，不會針對目標系統執行 GUID 驗證。
|
||
|
-r
--reuseResolutions
|
否
|
如果您指定此選項搭配 --defaultResolutions 選項，將會套用任何儲存的解決方案。如果沒有儲存的解決方案適用於衝突，將會套用預設解決方案。
|
||
|
-m
--mapFile
|
否
|
儲存包含對應資訊之 XSL 檔案的位置。例如，當兩個參與者擁有不同的辨別名稱時，對應檔可以指定應該如何將來源系統的參與者對應到目標系統的相同參與者。
如需詳細資訊，請參閱對應企業管理變更屬性。
|
||
|
-u
--user
|
否
|
執行指令之 Windchill 使用者的使用者名稱。執行指令的使用者必須是具有存取全部所需物件之組織管理員權限的有效 Windchill 使用者，此外，該使用者也應是一名網站管理員。
|
||
|
-p
--password
|
否
|
執行指令之 Windchill 使用者的密碼。
|
||
|
-h
--help
|
否
|
使用此選項可顯示公用程式的說明文字。說明文字會列出每個選項的完整描述以及執行公用程式的語法。
|
欲在 Windchill shell 中執行公用程式，請針對您要採取的動作，搭配列於表格中的適當選項指定下列指令：windchill wt.scm.client.SCMCMD import
例如，欲在將衝突與解決方案寫入記錄檔的情況下，使用預設衝突解決方案匯入一組管理變更，會使用下列指令：windchill wt.scm.client.SCMCMD import -u "<使用者名稱>" -p "<密碼>" -f "<ZIP 檔案的檔案路徑>" -d -o "<輸出目錄的檔案路徑>"
企業管理變更匯入記錄檔
無論匯入是否成功，執行匯入指令時都會產生匯入記錄檔。匯入記錄檔中包含的資訊更詳細地說明了整個匯入交易。
匯入記錄檔會顯示下列資訊：
• 記錄檔標題：BAC 已接收遞送 ID、封裝名稱、封裝版本和來源存放庫
• 摘要
• 物件類型
• 識別
• 匯入狀況
• 搜尋機制
• 衝突
如果匯入失敗，匯入記錄檔將顯示標題資訊及匯入失敗的原因。
以下是匯入記錄檔報告的範例：
