匯出變更指令
在來源系統進行完變更之後，便可進行預覽及匯出。export 指令可以與各選項搭配使用，來預覽對管理物件執行的變更，然後再將這些變更匯出為 ZIP 檔案。匯出的 ZIP 檔案使用下列命名慣例命名：<packagename>_<targetname>_<exportID>.zip
|
選項
|
是否必要？
|
描述 (Description)
|
|---|---|---|
|
-v
--previewOnly
|
預覽：是
匯出：否
|
提供 CSV 檔案，其中會列出已準備好要從系統匯出之物件的識別資訊。使用此選項可核對預期的管理變更是否包含在匯出資料中。
|
|
-t
--target
|
預覽：否
匯出：否
|
要將匯出的 ZIP 檔案傳送至的目標系統名稱。目標系統名稱與在 manageRepository 指令中指定的名稱相同。
匯出期間，不會強制註冊目標系統。
|
|
-n
--name
|
預覽：是
匯出：是
|
當同一個目標系統預期有多個匯出時，建議使用此選項。
建立來保存 ZIP 檔案輸出之封裝的名稱。如果其他匯出操作預期會產生相同的資料，建議您使用能夠記住的名稱建立封裝。例如，您可以在未來對封裝使用 --refresh 選項，來建立到相同目標系統的增量匯出。您也可以將相同的封裝傳送到不同的目標系統。
|
|
-d
--description
|
預覽：否
匯出：否
|
此選項會為建立來保存 ZIP 檔案輸出的封裝建立描述。封裝的描述可以包含有關匯出到目標系統之資料類型的資訊。
|
|
-s
--objectType
|
預覽：是
匯出：是
|
要匯出的物件類型。下列物件類型可用於匯出：
• All：匯出對所有支援物件類型新增的項目以及所做的變更。
• PolicyAccessControlRule：匯出新的、已更新及已刪除的原則存取控制規則。當匯出至同步處理系統時，有關已刪除原則存取控制規則的資訊也包括在內。
• Profile：匯出新的、已更新及已刪除的設定檔。當匯出至同步處理系統時，有關已刪除設定檔的資訊也包括在內。
• OIR：匯出新的、已更新及已刪除的物件初始化規則。
• Preference：匯出新的、已更新及已刪除的偏好設定。
• LifeCycleTemplate︰匯出新的、已更新或已版序化，以及已刪除的生命週期範本。
• WorkflowProcessTemplate︰匯出新的、已更新或已版序化，以及已刪除的工作流程範本。
• TypeDefinition︰匯出新的、已更新及已刪除的屬性範本。
• MeasurementSystem：匯出新的、已更新及已刪除的量測系統。
• QOM：匯出新的、已更新及已刪除的量測數。
• GlobalEnumeration：匯出新的、已更新及已刪除的全域列舉、模型化列舉與自訂 UI 文字。
• ReusableAttribute︰匯出新的、已更新或已版序化，以及已刪除的可重新使用屬性。
• DocumentTemplate︰匯出新的、已更新及已刪除的文件範本。
• ReportTemplate︰匯出新的、已更新或已版序化，以及已刪除的報告範本。
• Report：匯出新的、已更新及已刪除的報告。
• RuleSets：匯出新的及已刪除的「規則集」物件 (規則、規則集與規則集連結)。
• TableView：匯出新的、已更新及已刪除的報告共用表格檢視與系統表格檢視。
• specfile.xml：上載指定需要收集以匯出之物件的 XML 檔案。只有在您將 wt.properties 中的 com.ptc.windchill.bac.features.enabled 內容設定為 2666518 時才能使用此選項。若沒有此組態，對上載規格檔案的任何嘗試都將遭到拒絕並顯示錯誤。此選項適用於可選、同步處理模式及開發模式。
當您在同步處理模式下使用此選項時，可以僅匯出物件類型的特定清單。在同步處理模式系統中，XML 規格檔案不支援容器、網域或屬性。如需有關規格檔案的詳細資訊，請參閱建立規格 XML 檔案。
如需有關所支援物件類型的詳細資訊，請參閱Business Administrative Change 推進所支援的物件。
|
|
-o
--outputdir
|
預覽：否
匯出：否
|
產生及儲存預覽檔案或所匯出 ZIP 檔案之位置的檔案路徑。若未指定此選項，會將檔案儲存到執行指令的目錄中。
|
|
-b
--modificationBeginTime
|
預覽：否
匯出：否
|
當匯出至可選系統時，此為必要選項。也可針對 --previewOnly 選項指定此選項，以顯示時間範圍之間的變更。
應該於其之後匯出變更的開始時間。開始時間應該以下列 24 小時制的日期/時間格式指定：MM/dd/yyyy HH:mm:ss
|
|
-e
--modificationEndTime
|
預覽：否
匯出：否
|
當匯出至可選系統時，此為必要選項。也可針對 --previewOnly 選項指定此選項，以顯示時間範圍之間的變更。
應該於其之前匯出變更的結束時間。結束時間應該以下列 24 小時制的日期/時間格式指定：MM/dd/yyyy HH:mm:ss
|
|
-r
--refresh
|
預覽：否
匯出：否
|
如果在 -name 參數中指定現有封裝，請使用此選項。
重新整理 ZIP 檔案的內容，使其包括自上次匯出相同資訊後所做的增量更新。
若提供 -r 或 --refresh，則會忽視 -s 或 --objectType。在指令中指定 -s 或 -r 選項。
|
|
-x
--excludeBaseline
|
預覽：否
匯出：否
|
在將資訊傳送至目標系統時，此選項會排除基準線。這僅對開發模式有效。依預設，基準線是針對開發模式所建立。
|
|
-u
--user
|
預覽：否
匯出：否
|
執行指令之 Windchill 使用者的使用者名稱。執行指令的使用者必須是具有存取全部所需物件之組織管理員權限的有效 Windchill 使用者，此外，該使用者也應是一名網站管理員。
|
|
-p
--password
|
預覽：否
匯出：否
|
執行指令之 Windchill 使用者的密碼。
|
|
-h
--help
|
否
|
使用此選項可顯示公用程式的說明文字。說明文字會列出每個選項的完整描述以及執行公用程式的語法。
|
欲在 Windchill shell 中執行公用程式，請針對您要採取的動作，搭配列於表格中的適當選項指定下列指令：windchill wt.scm.client.SCMCMD export
預覽變更
欲預覽對諸如設定檔等管理物件所做的變更，請使用下列指令：windchill wt.scm.client.SCMCMD export -v -o "<檔案路徑>" -n "<封裝名稱>" -s "Profile" -u “<使用者名稱>” -p “<密碼>” -t “<目標名稱>”
產生的預覽檔案包含下列資訊：
• 報告標題：封裝的名稱、封裝描述、前後關聯以及建立封裝時的時間戳記
• 物件類型
• 物件識別
• 物件描述
• 動作類型：建立、修改、刪除
以下是匯出預覽報告的範例︰
匯出變更
欲將所有新的、已更新及已刪除的設定檔記錄匯出至可選系統，請使用下列指令：windchill wt.scm.client.SCMCMD export -u "<使用者名稱>" -p "<密碼>" -t "<目標名稱>" -s "Profile" -b "<開始時間>" -e "<結束時間>" -n "<封裝名稱>" -d "<描述>" -o "<檔案路徑>"
ZIP 檔案中包含有資料夾，內含物件資訊以及列出下列資訊的 report.html 檔案：
• 封裝識別 - 編號、名稱、描述以及建立日期與時間
• 匯出物件的資訊 - 物件類型、物件識別、描述及動作類型