数据管理功能 > 管理部件结构 > Windchill 选项与变型功能 > 创建和管理变型 > 变型规范信息页面 > 加载变型规范 > 使用 API 加载变型规范 > 使用 API #1 加载变型规范
  
使用 API #1 加载变型规范
可以使用出厂时提供的 API #1 加载变型规范。要调用 API,请在您的 Java 代码中做出与之类似的调用:
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 - 配置规范的有效日期。此值可以为空。