匯入偏好設定
匯入公用程式可讓您匯入之前匯出的偏好設定資訊。您可以對其從匯出檔案所匯入的偏好設定實例進行限制;例如,您可以只匯入特定使用者或前後關聯的偏好設定實例。您也可以選擇將匯入的偏好設定實例套用至特定層級,例如特定組織或使用者。在此情況下,只會針對在 -applyTo 參數中指定的層級建立偏好設定實例。不會建立對應於所匯入偏好設定實例之原始層級的偏好設定實例。
匯入指令的語法如下:
windchill wt.preference.ImportPreferences -importfile="<檔案路徑>"
執行匯入公用程式時,會在執行工具的目錄中建立記錄檔,名為 PreferenceImport_<YYYYMMDD_HHmm>.txt,其中 <YYYYMMDD_HHmm> 是執行公用程式的日期與時間。在現有偏好設定資訊與匯入的偏好設定資訊之間,若有任何不符之處,都會標記為衝突並在 PreferenceImportConflicts_<YYYYMMDD_HHmm>.txt 記錄檔中記錄,此檔案也會建立在執行工具時所在的目錄中。
在指令中,有支援判定此類衝突會發生什麼結果的參數。也會記錄新偏好設定定義與實例。如果在匯入的偏好設定實例中並未指定對應的偏好設定定義、類別或用戶端,則會將其標記為錯誤並記錄下來。如果有偏好設定定義,但在較所匯入定義試圖套用之層級的更高層級上已有偏好設定定義,則會記錄錯誤。
如果遇到任何錯誤,則會處理整個匯入檔案、記錄所有錯誤,且公用程式會結束而不匯入任何偏好設定實例。
如果沒有遇到不符或錯誤的情況,則匯入會成功完成。
匯入指令支援下列參數:
參數
描述
-importfile="<檔案路徑>"
從中匯入偏好設定的 XML 檔案,包含完整檔案路徑。這通常是使用偏好設定匯出公用程式建立的檔案。如果提供了無效檔案或檔案路徑,則會顯示錯誤訊息。
必須使用這個參數。
-user="<adminID>"
網站管理員使用者的使用者 ID。此參數應與 -password 參數一起指定。若未指定這些參數,執行公用程式時,系統將會提示進行驗證。
-password="<adminpassword>"
網站管理員使用者的密碼。此參數應與 -user 參數一起指定。若未指定這些參數,執行公用程式時,系統將會提示進行驗證。
-usage
顯示指令的所有有效引數。
-debug="<debugLevel>"
控制資訊或偵錯訊息的層級。1 為最低,3 為最高。
-importSiteLevel
只從匯入檔案中匯入網站層級偏好設定實例。
一次只能指定以下其中一個參數:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果匯入檔案中不存在指定層級的偏好設定實例,則會將資訊訊息新增到記錄中,但不會將它視為錯誤。
-importOrgLevel="<FullPath>"
僅從匯入檔案匯入指定組織的偏好設定實例。一次只能指定一個組織。必須將組織的完全合格路徑指定為參數值。
例如,欲針對名為 Demo Organization 的組織匯入偏好設定實例,請以下列方式指定參數:
-importOrgLevel="/wt.inf.container.OrgContainer=Demo Organization"
一次只能指定以下其中一個參數:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果匯入檔案中不存在指定層級的偏好設定實例,則會將資訊訊息新增到記錄中,但不會將它視為錯誤。
-importContainerLevel="<FullPath>"
僅從匯入檔案中匯入指定前後關聯 (產品、物件庫、專案或方案) 的偏好設定實例。一次只能指定一個前後關聯。必須將前後關聯的完全合格路徑指定為參數值。
例如,欲針對 Demo Organization 中名為 Product1 的產品匯入所有偏好設定實例,請以下列方式指定參數:
-importContainerLevel="/wt.inf.container.OrgContainer=Demo Organization/wt.pdmlink.PDMLinkProduct=Product1"
一次只能指定以下其中一個參數:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果匯入檔案中不存在指定層級的偏好設定實例,則會將資訊訊息新增到記錄中,但不會將它視為錯誤。
-importUserLevel=<使用者 Id>
僅從匯入檔案匯入指定使用者的偏好設定實例。一次只能指定一個使用者。例如,欲針對 wcadmin 使用者匯入所有偏好設定實例,請以下列方式指定參數:
-userLevel=wcadmin
一次只能指定以下其中一個參數:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果匯入檔案中不存在指定層級的偏好設定實例,則會將資訊訊息新增到記錄中,但不會將它視為錯誤。
-overwriteValueConflicts
所有值不相符的衝突都透過以匯入的值覆寫現有值來解決。如果指定此參數,則會用匯入的偏好設定值取代資料庫中的任何多值偏好設定。
此偏好設定可與 -skipUnresolvedConflicts 偏好設定一起指定,在此情況下,匯入操作應在覆寫所有值衝突的情況下成功完成,並略過所有未解決的衝突,
-skipUnresolvedConflicts
會略過未解決的任何衝突。會匯入其餘檔案。
此偏好設定可與 -overwriteValueConflicts 偏好設定一起指定,在此情況下,匯入操作應在覆寫所有值衝突的情況下成功完成,並略過所有未解決的衝突,
-applyToSiteLevel
僅將匯入的偏好設定實例套用至網站層級。
-applyToOrgLevel="<FullPath>"
僅將匯入的偏好設定實例套用至指定的組織。參數值必須是組織的完全合格路徑。可以將多個組織指定為用逗號分隔的清單。
此參數只能搭配以下其中一個參數使用:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
若已指定多個組織,則會將匯入操作分別套用至每一個組織。如果某些指定的組織能夠成功完成匯入,但其他組織不能,則會顯示訊息詳細指出成功匯入的組織。匯入失敗之組織中的任何衝突都會記錄到記錄檔中。
-applyToContainerLevel="<FullPath>"
僅將匯入的偏好設定實例套用到指定的一或多個前後關聯 (產品、物件庫、專案或方案)。參數值必須是前後關聯的完全合格路徑。可以將多個前後關聯指定為用逗號分隔的清單。
此參數只能搭配以下其中一個參數使用:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
若已指定多個前後關聯,則會將匯入操作分別套用至每一個前後關聯。如果某些指定的前後關聯能夠成功完成匯入,但其他前後關聯不能,則會顯示訊息詳細指出成功匯入的前後關聯。不匯入失敗之前後關聯中的任何衝突都會記錄到記錄檔中。
-applyToUserLevel="<使用者 Id>"
僅將匯入的偏好設定實例套用至指定的一或多個使用者。可以將多個使用者指定為用逗號分隔的清單。
此參數只能搭配以下其中一個參數使用:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
若已指定多個使用者,則會將匯入操作分別套用至每一位使用者。如果某些指定的使用者能夠成功完成匯入,但其他使用者不能,則會顯示訊息詳細指出成功匯入的使用者。匯入失敗之使用者中的任何衝突都會記錄到記錄檔中。
這是否有幫助?