使用 API #1 載入變體規格
您可以使用現成提供的 API #1 載入變體規格。您可在 Java 程式碼中進行類似如下的呼叫，來呼叫 API：
List<VariantSpecLoadOutputBean> resultBeans = VariantSpecLoaderHelper.service.loadVariantSpecs(navCriteriabeansList, partConfigSpecBeanList, atoConfigSpecBeanList);
您必須為 API 提供下列資訊：
• VariantLoadNavCriteriaBean 物件清單 - 對於每個 bean，都會建立或更新變體規格。這個 bean 包含與 Navigation Criteria 工作表相同的資訊。這個 bean 可能包含下列資訊：
◦ variantSpecName - 要建立之變體規格的名稱。
◦ variantSpecNumber - 當您要重新配置現有變體規格時的有效變體規格碼。
◦ variantSpecDescription - 變體規格的描述。
◦ variantSpecFolder - 代表您要放置變體規格之資料夾的字串 (例如，"/Default")。
◦ variantSpecCreateVariants - 指定是否要根據變體規格建立模組變體的布林值。
◦ partNumber - 必須針對其建立變體的零件編號。它必須擁有指派給它的選項集。如果僅指定 partNumber，則會使用最新版本。
◦ partRevision - 零件的版本修訂。例如，如果要使用零件 A.1，可提供 "A" 作為版本修訂。
◦ partIteration - 零件的版序。例如，對於零件 A.1，可使用 "1" 作為版序。
◦ optionSetName - 要使用之選項集的名稱。請僅在未提供零件時，才提供此值。它可讓您根據選項集建立變體規格。
◦ optionSetRevision - 選項集的版本修訂。
◦ optionSetIteration - 選項集的版序。
◦ applyToTop - 布林值。將此屬性設定為 true 相當於在「配置」視窗的「組態規格」標籤中核取相同的核取方塊。當將此屬性設定為 true 時，系統會將組態規格套用至所提供零件結構最上方的零件。只有在已指定零件時，此情況才適用。
◦ ruleCheckingDisabled - 依預設，此屬性設為 false。將此屬性設定為 true 相當於在「配置」視窗中選取「禁用規則檢查」。
◦ filterMode - 整數值：設定為 1 表示「標準」篩選模式，設定為 2 表示「替代」篩選模式。
◦ optionsMap—Map<String, List<String>. 這是「選項名稱的對應」及其對應的「選擇名稱清單」。這相當於您在「編輯篩選器」標籤中選取的選項。在篩選選項期間，選擇規則會套用至這些選擇。如需有關如何建立此「對應」的範例，請參閱範例程式碼。
◦ partConfigSpecs - List<String> 如果您要將特定零件組態規格套用至零件，請提供此資訊。請確定您新增的任何內容在 API 方法引數 partconfigSpecBeans 中都具有對應項目。如果其為空值，則會套用「最新」零件組態規格。只有在已指定零件時，此情況才適用。
◦ atoRuleConfigSpecs - List<String> 如果您要使用特定「選項篩選器」組態規格，請提供此資訊。請確定您新增的任何內容在 API 方法引數 atoConfigSpecBeans 中都具有對應項目。如果其為空值，則會套用「最新」組態規格。
• VariantLoadPartConfigSpecBean 物件清單 - 對於每個 bean，都會建立零件組態規格。這個 bean 包含與 Part Config Specs 工作表相同的資訊。如果您要僅使用「最新」組態規格，可將此參數設定為空值。如果您要像在「配置」使用者介面中一樣使用更詳細的組態規格，可將此 bean 設定為包含下列屬性，或在 bean 中使用建構函式：
◦ configSpecName - (必要) 組態規格必須擁有唯一性的名稱。
◦ viewName - 有效檢視的名稱 (例如，「設計」)。此值可以是空值。
◦ lifeCycleState - 生命週期狀態的名稱 (例如，「已發行」)。此值可以是空值。
◦ baselineName - 現有基準線的名稱。
◦ effectivityDate - 組態規格的生失效日期。此值可以是空值。
• VariantLoadATORuleConfigSpecBean 物件清單 - 對於每個 bean，都會建立「選項篩選器」的組態規格。這個 bean 包含與 Option Filter Config Specs 工作表相同的資訊。如果您要僅使用「最新」組態規格，可將此參數設定為空值。如果您要像在「配置」使用者介面中一樣使用更詳細的組態規格，可將此 bean 設定為包含下列屬性，或從 bean 中使用建構函式：
◦ configSpecName - (必要) 組態規格必須擁有唯一性的名稱。
◦ lifeCycleState - 生命週期狀態的名稱 (例如，「已發行」)。此值可以是空值。
◦ effectivityDate - 組態規格的生失效日期。此值可以是空值。