從試算表載入變體規格
您可以使用 Windchill 指令行公用程式從試算表載入多個變體規格。此公用程式依賴於用來以程式方式載入變體規格的 API。
|
|
欲使用此功能：
• 必須安裝 Platform Structures 模組。
• 您必須是網站管理員，同時也是 Platform Structures 群組的成員。
|
欲從試算表載入變體規格：
1. 使用 WT_HOME\loadFiles\ato\testdata\variantSpecLoader 中提供的範本 VariantSpecLoader1.xlsx 建立試算表。
2. 執行下列 Windchill 指令行公用程式：
Windchill com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_Spreadsheet_Path>\<My_Spreadsheet>.xlsx -u <my_user> -p <my_password>
3. 審核輸出檔案，以解決任何錯誤。輸出檔案位於 WT_HOME\logs 下。
試算表中包含 3 個工作表，可供您輸入與變體規格及零件結構組態相關的資訊：
• 「零件組態規格」工作表 (Part Config Specs) - 此工作表的資訊與您在配置零件時於「配置」視窗的「組態規格」標籤中指定的資訊類似。此工作表有 5 個欄位：Configuration Specification Name、View、Life Cycle State、Baseline 以及 Effectivity Date。Name 為必填。View 的值必須是與「配置」視窗中的「檢視」欄位對應之有效項目。系統會驗證您輸入的值。
• Option Filter Configuration Specification 工作表 (
Option Filter Config Specs) - 此工作表定義「選項篩選器」的組態規格。此工作表有 3 個欄位：
「組態規格名稱」、
「生命週期狀態」及
「生失效日期」。您輸入的資訊與您在
「針對選項篩選器設定組態規格」視窗中指定的內容類似，此視窗可透過按一下
圖示來從
「選項篩選器」視窗中存取。系統會驗證您輸入的值。
• 「導覽條件」工作表 (Navigation Criteria) - 提供用來在「選項篩選器」中捕捉選取項之選擇規則與所選選擇的相關資訊。此工作表包含以下欄位：
◦ 「變體規格」部份：
▪ Name - 輸入要指派給變體規格的名稱。
▪ Number - 只有在您要重新配置現有變體規格時，才需使用此欄。如果提供有效的編號，且存在具有此編號的變體規格，將會使用持續名稱。
▪ Description - 提供變體規格的描述 (最多 2000 個字元)。
▪ Location - 指定用來儲存變體規格的位置。如果此欄位為空，公用程式將會使用預設位置。如果在建立變體規格時此欄位為空，公用程式會發出錯誤。
▪ Create Variants - 這是布林值。當設定為 true 時，系統會為變體規格建立模組變體。由於建立模組變體是非同步的，因此公用程式只會註記每個變體的佇列項目建立成功/失敗與否，而不會註記實際變體。當將此欄位設定為 false 時，公用程式只會建立變體規格。
◦ 「零件」部份 - 此部份提供要使用變體規格配置之零件的詳細資訊。公用程式會預期零件擁有指派的選項集。如果沒有指派的選項集，不會處理此列。
▪ Number - 零件的編號 (例如 Bicycle1)。
▪ Revision - 零件的版本修訂 (例如 A)。
▪ Iteration - 零件的版序 (例如 1)。在此範例中，零件為 Bicycle1 A.1。
| 如果您提供零件的資訊，則有關選項集的資訊為多餘。您必須為 Part 或 Option Set 欄位其中之一提供資訊，而不必同時為兩者提供。 |
◦ 「選項集」部份 - 會使用選項集建立變體規格。如果未針對該列指定零件，會使用公用程式建立此類變體規格。
▪ Name - 選項集的名稱。
▪ Revision - 零件的版本修訂 (例如 A)。
▪ Iteration - 零件的版序 (例如 1)。
◦ 「導覽條件」部份 - 此部份會捕捉在使用者介面的Configuration Specification) 標籤和「選項篩選器」標籤中指定的資訊：
▪ Apply to Top - 將此屬性設定為 true 相當於在「配置」視窗的「組態規格」標籤中核取相同的核取方塊。當將 Apply to Top 設定為 true 時，系統會將組態規格套用至所提供零件結構最上方的零件。
| 對於僅使用選項集建立的變體規格而言，不需要此資訊。如果提供此資訊，驗證器會報告錯誤。 |
▪ Part Configuration Specification - 提供已使用工作表 1 載入之零件組態規格的清單。提供多個組態規格時，您可以使用逗號 (,) 分隔。如果已在欄 F-H 中指定零件，且此欄保留空白，公用程式會載入「最新」零件組態規格，並使用它來建立變體規格。
▪ 「選項篩選器」組態規格 - 提供一份清單，列出已使用工作表 2 載入的選項篩選器組態規格。提供多個組態規格時，您可以使用逗號 (,) 分隔。當將此資訊保留空白時，公用程式會載入最新選項篩選器組態規格，並使用它來建立變體規格。
▪ Disable Rule Checking - 依預設，此選項設為 false。將其設定為 true 就相當於在「配置」視窗中核取方塊。
▪ 「篩選器模式」- 這與「選項篩選器」標籤中的下拉清單類似 (您可從中選取「標準」或「替代」)。
◦ 開始選項欄 - 空白欄代表開始定義要為選項篩選器選取的選擇。
◦ 其他欄 - 為您要針對選項篩選器選取其選擇的每個選項提供一欄。
例如：如果您要從 OptionA 中選取 ChoiceA、ChoiceB 與 ChoiceC，並從 Option B 中選取 ChoiceD，您需要在「開始選項」欄之後建立兩欄 - OptionA 與 OptionB。在您建立變體規格資訊的列，輸入 OptionA 下之 ChoiceA、ChoiceB 與 ChoiceC 及 OptionB 下之 ChoiceD 的逗號分隔清單。如果下一列 (也就是下一個變體規格) 包含從其他選項選取的選擇，請使用選項名稱建立新的一欄，並針對您要填入的列在欄下的儲存格中建立各選擇。您可以針對此列將 OptionA 與 OptionB 下的儲存格保留空白。
| 如果系統中存在相同變體規格的版本，您需要按變體規格編號進行參考。 |
◦ 結束選項 - 這是工作表的最後一欄。它會針對選項篩選器標記所有選項與選擇選取項的結束。
輸出檔案
當您執行公用程式來匯入試算表時，系統會建立輸出檔案。輸出檔案位於記錄檔資料夾 WT_HOME\logs 中，名為 VariantSpecLoaderReport_<random_generated_number>*。
輸出檔案包含下列資訊：
• 正在處理導覽條件工作表中的列號。
• 操作狀況：「成功」或「失敗」。
• 變體規格編號 (若已成功建立變體規格)。
• 「已建立」- 如果已建立新變體規格，「已建立」設定為 true。否則，「已建立」設定為 false。
• 「已更新」 - 如果變體規格是現有變體規格，則「已更新」設定為 true。這表示已根據試算表中提供的變體規格碼重新配置變體規格。
• 「錯誤」- 報告在處理試算表的同時進行驗證期間的錯誤，或建立物件時遇到的錯誤。如果遇到錯誤，公用程式將不會處理該列，而是會將錯誤記錄在報告中，並移至下一列。
• 「警告」 - 如果在處理列時發出警告或做出假設，會將它們作為警告記錄在報告中。
使用試算表載入變體規格的指導原則
請考慮下列資訊：
• 請僅使用 .xlsx (預設 Microsoft office Excel 2007) 試算表格式來載入變體規格。
• 請注意，在 UNIX 中，用來載入變體規格的 windchill 指令區分大小寫。請使用下列語法：
windchill com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_spreadsheetpath>
• 當您使用試算表重新配置變體規格時，輸入 Create Variants = True 會產生新變體 (透過取代現有變體)，即使變體規格的結構與選擇選取項沒有變更亦是如此。
• 您無法重新配置使用選項集建立的變體規格。
• 不支援使用現成 API 或試算表來利用使用者定義變體規格碼建立變體規格。
• 欲為試算表中的變體規格提供資料夾位置，您可使用在該產品之 /Default 檔案櫃中建立的所有資料夾，例如 /Default/ABC。
• 欲重新配置現有變體規格，您必須指定與變體規格相關聯的零件。在此類情況下，請勿指定選項集。
• 不支援根據變體規格的版本重新配置變體規格。始終會重新配置最新版本。
• 請遵循以下有關特殊字元的指導原則：
◦ 對於名稱中包含雙引號的選擇，必須在前面加上反斜線 "\"，例如 "\a"1\"。
◦ 名稱中包含特殊字元的選擇必須用雙引號括起來，例如 "a_1"。
試算表驗證
在處理試算表時，會執行下列驗證：
• 您可以指定零件或選項集，而不必二者都指定。
• 零件必須具有指派的選項集。
• 零件必須存在。
• 選項集必須存在。
• 資料夾必須存在，而且必須在建立新變體規格時指定。
• 指定的零件組態規格必須存在。
• 指定的選項篩選器組態規格必須存在。
• 您可以指定變體規格名稱或編號，而不必二者都指定。
• 包含指定編號的變體規格必須存在。
• 欲重新配置現有變體規格，您必須指定與變體規格相關聯的零件。在此類情況下，請勿指定選項集。
• 您必須提供零件或選項集。
在偵錯模式下執行公用程式
您可在偵錯模式下執行公用程式來在 wt_home\logs 資料夾中建立可用來偵錯的 log4j 檔案。記錄檔會記錄所處理試算表每一列的錯誤。
欲在偵錯模式下使用公用程式，請使用下列語法：
Windchill --jap=wt.properties?com.ptc.windchill.option.variantload.java.args com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_Spreadsheet_Path>\<My_Spreadsheet>.xlsx -u <my_user> -p <my_password>
