使用 VariantLoadNavCriteriaBean API 加载变型规范
用户可以使用出厂时提供的 Java API 加载变型规范。要调用 API,请在您的 Java 代码中做出与之类似的调用:
List<VariantSpecLoadOutputBean> resultBeans = VariantSpecLoaderHelper.service.loadVariantSpecs(navCriteriabeansList, partConfigSpecBeanList, atoConfigSpecBeanList);
必须提供 API 的下列信息:
• VariantLoadNavCriteriaBean 对象列表 - 为每个 bean 创建或更新变型规范。此 bean 所包含的信息与 Variant Specification 工作表中的相同。此 bean 可包含以下信息:
◦ variantSpecName - 要创建的变型规范名称。
◦ variantSpecNumber - 有效的变型规范编号 (针对重新配置现有变型规范的情况)。
◦ variantSpecDescription - 变型规范的描述。
◦ variantSpecFolder - 一个字符串,表示您想要放置变型规范的文件夹 (例如,"/Default")。
◦ variantSpecCreateVariants - 一个布尔值,指定是否基于此变型规范创建模块变型。
◦ partNumber - 必须创建变型的部件编号。它必须具有为其分配的选项集。如果仅指定 partNumber,则使用最新版本。
◦ organization - 部件所属的拥有组织 (例如,演示组织)。
◦ partRevision - 部件的修订版本。例如,要使用部件 A.1,请提供 "A" 作为修订版本。
◦ partIteration - 部件的小版本。例如,对于部件 A.1,使用 "1" 代表小版本。
◦ partView - 部件版本的视图 (例如,设计)。
◦ 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 中均有对应条目。如果此处为空,则会应用最新配置规范。
◦ variantSpecLifeCycleTemplate - 要分配给变型规范的生命周期模板的名称。
◦ variantSpecLifeCycleState - 用于标识要分配给变型规范的生命周期状态的枚举值。例如,指定 "INWORK" 以将“正在工作”作为生命周期状态。
◦ variantSpecIBAs – Map<String, Object>。可变属性的内部名称与要分配给变型规范的相应值的映射。支持的属性类型有:“字符串”、“布尔型”、“整数”、“实数”、“带单位的实数”、“日期和时间”以及 URL。
• 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 - 配置规范的有效日期。此值可以为空。