匯入變更指令
將匯出的 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
對於匯入期間會發生任何衝突,請使用 Windchill 所提供的預設解決方案。所有可使用適用預設解決方案取代的衝突都可使用預設解決方案解決,而且不會在「事件管理」公用程式中報告。
-s
--saveResolutions
可儲存您選取要再次用於此來源系統的任何解決方案。您可選取用來解決事件管理公用程式中報告之任何衝突的解決方案。
如果您選取此選項搭配 --reuseResolutions 選項,將會先套用任何之前儲存的解決方案。所發生任何問題的解決方案都可使用「事件管理」公用程式選取。如果選取了這兩個選項,於此匯入期間選取的解決方案會新增至之前儲存的解決方案。
-c
--conflictResolutionFile
指定將在匯入期間使用之衝突解決方案 XML 檔案的路徑。衝突解決方案 XML 檔案指定不同的衝突類型及其對應的解決方案。如果您選取此選項與 --defaultResolutions--saveResolutions--reuseResolutions 或全部,會先實行 XML 載入檔案中提供的解決方案。如果 XML 檔案中的解決方案無法使用,會套用之前儲存的解決方案。
-b
--useBundledConflictResolutionFile
使用封裝 ZIP 檔案中可用的配套衝突解決方案檔案來解決匯入期間的衝突。如果您選取此選項與 --defaultResolutions--saveResolutions--reuseResolutions 或全部,會先實行配套衝突解決方案檔案中提供的解決方案。如果檔案中的解決方案無法使用,會套用之前儲存的解決方案。
* 
如果您同時使用 -b-c-r 指令,則 -c 為優先,-b 次之,最後是 -r 指令。系統會先在封裝 ZIP 檔案內搜尋檔案。如果找不到檔案,則系統會在封裝外部搜尋檔案。如果封裝外部也沒有檔案,則會在資料庫內搜尋。
-n
--useBundledMapFile
使用封裝 ZIP 檔案中可用的對應檔案,在匯入期間將來源屬性對應至目標屬性。
* 
如果您同時使用 -n-mmapping values defined under Import mapping on UI 指令,則 -n 為優先,-m 次之,最後是 mapping values defined under Import mapping on UI 指令。系統會先在封裝 ZIP 檔案內搜尋檔案。如果找不到檔案,則系統會在封裝外部搜尋檔案。如果封裝外部也沒有檔案,則會搜尋 mapping values defined under Import mapping on UI
-i
--ignoreTargetCheckforGUID
指定將針對其略過對目標系統的檢查之來源系統的 GUID。
在匯入流程期間,來源系統的 GUID 可用來檢查其是否已向目標系統註冊。如果您設定此選項,會略過此檢查,且您可以從未註冊的來源系統匯入管理變更。
* 
此選項僅適用於同步處理模式。
您也可以配置目標系統的 wt.properties 中的 com.ptc.windchill.bac.ignoreGUIDList 內容以指定來源系統的 GUID。這將會在匯入流程期間略過針對來源系統 ID 之指定清單進行的檢查。如果您為 --ignoreTargetCheckforGUIDcom.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、封裝名稱、封裝版本和來源存放庫
摘要
物件類型
識別
匯入狀況
搜尋機制
衝突
如果匯入失敗,匯入記錄檔將顯示標題資訊及匯入失敗的原因。
以下是匯入記錄檔報告的範例:
這是否有幫助?