資料管理能力 > 管理零件結構 > Windchill 選項及變體功能 > 建立及管理變體 > 變體規格資訊頁 > 載入變體規格 > 使用 API 載入變體規格 > 使用 API #1 載入變體規格
  
使用 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 表示「替代」篩選模式。
optionsMapMap<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 - 組態規格的生失效日期。此值可以是空值。