与可配置模块关联的独立变型规范
此变型规范用于管理应用于特定视图版本的完全定义筛选器，以定义或生成变型解决方案或配置上下文。可通过“配置”过程或以编程方式对其进行创建。可通过“重新配置”过程或以编程方式对其进行加载。不过，这仅限于 XML 加载，而不会应用规则处理，且选项筛选器中的任何选定选择都会被视为用户选定的选择。
• 在创建变型规范时需要“名称”和“位置”，而在更新变型规范时需要“编号”。
• 需要一个可配置模块部件版本，其可选功能为包括用以唯一标识部件并定义视图特定版本的组织。
• 不会直接与选项集关联，因为它与通过可配置模块分配的选项集间接相关。
• 需要部件配置规范，但会提供下列默认值：
◦ 如果未指定任何部件配置规范，则系统会针对为可配置模块指定的视图使用最新配置规范，而不设置生命周期状态。
◦ 如果指定的部件配置规范不具有定义，则系统会针对为可配置模块指定的视图使用最新配置规范，而不设置生命周期状态。
• 需要一个值，用于将配置规范应用到顶层，但如果未指定值，则系统会提供 false 值。
• 可根据需要为变型生成提供支持。如果未指定任何值，则系统会使用 false 值。
• 能够根据“编号”或“名称”参考选项和选择。
• 需要选项筛选器的配置规范。如果未指定任何值，则系统会使用最新配置规范，而不设置生命周期状态。
XML 格式
<csvVariantSpec csvbatchInputFilePath="com.ptc.wpcfg.load.LoadHelper.createVariantSpec"> <csvbatchInputFilePath><PATH_FOR_VSDETAIL FILE></csvbatchInputFilePath>
<csvdescription>TEST DESCRIPTION</csvdescription>
<csvfolder>/Default</csvfolder>
<csvlifecycle/>
<csvlifecyclestate/>
<csvparentContainerPath></csvparentContainerPath>
<csvnavcriteria>NAV_CRITERIA_1</csvnavcriteria>
<csvcreatevariants>true</csvcreatevariants-->
<csvtypedef>com.ptc.wpcfg.CustomVariantSpec</csvtypedef>
</csvVariantSpec>
<csvdescription>TEST DESCRIPTION</csvdescription>
<csvfolder>/Default</csvfolder>
<csvlifecycle/>
<csvlifecyclestate/>
<csvparentContainerPath></csvparentContainerPath>
<csvnavcriteria>NAV_CRITERIA_1</csvnavcriteria>
<csvcreatevariants>true</csvcreatevariants-->
<csvtypedef>com.ptc.wpcfg.CustomVariantSpec</csvtypedef>
</csvVariantSpec>
PATH_FOR_VSDETAIL FILE 是另一个 .xml 文件的绝对路径，其中包含变型规范、可配置模块和参数的相关信息。
|
属性
|
说明
|
是必需还是可选？
|
|---|---|---|
|
csvbatchInputFilePath
|
包含变型规范详细信息的输入文件的路径。下面所述的详细信息。
|
必需
|
|
Csvdescription
|
变型规范的说明。
|
可选
|
|
Csvfolder
|
变型规范的文件夹位置。
|
可选
|
|
Csvlifecycle
|
变型规范的生命周期模板。
|
必需
|
|
Csvlifecyclestate
|
变型规范的生命周期状态。
|
必需
|
|
csvparentContainerPath
|
变型规范必须驻留在的容器路径。
|
必需
|
|
Csvnavcriteria
|
在浏览条件的单独部分中提到的浏览条件名称。
|
可选
|
|
Csvcreatevariants
|
用于标识是否必须为此变型规范生成变型的指示符。
|
可选
|
|
Csvtypedef
|
用于加载变型规范的类型定义。
|
可选
|
变型规范详细信息文件的格式为：
<specinput>
<spec name="VariantSpecification1" />
<part number="Milkshake" version="A" iteration="1" view="Design" organization="Demo Organization"/>
</specinput>
<spec name="VariantSpecification1" />
<part number="Milkshake" version="A" iteration="1" view="Design" organization="Demo Organization"/>
</specinput>
独立变型规范的属性
|
属性
|
说明
|
是必需还是可选？
|
|---|---|---|
|
Spec
|
关于变型规范的详细信息。
|
必需
|
|
Name
|
变型规范的说明。
|
必需
|
|
Number
|
变型规范的文件夹位置。
|
可选
|
|
Part
|
关于可配置部件的详细信息。
|
必需
|
|
Number
|
可配置部件编号。
|
必需
|
|
Version
|
可配置部件版本。
|
可选
|
|
Iteration
|
可配置部件小版本。
|
可选
|
|
View
|
可配置部件视图。
|
可选
|
|
Organization
|
可配置部件组织。
|
可选
|
|
Parameter
|
关于参数的详细信息。
|
可选
|
|
Name
|
参数名称。
|
必需
|
|
Value
|
参数值。
|
必需
|
 |
如果要加载大量变型规范，则必须将其置于 csvBeginBulkVariantSpecification 与 csvEndBulkVariantSpecification 标记之间。但是，只有加载与同一部件和相同配置规范信息关联的变型规范时，才能使用这些标记，以避免内存消耗增加。
|
示例
<pcfg.load.LoadHelper.createVariantSpec">
<csvbatchInputFilePath>/vagrant/WindowsShareNew/EnhancedLoader/VSDetail.xml</csvbatchInputFilePath>
<csvdescription>MBT Bike Variant Specification</csvdescription>
<csvfolder>/Default</csvfolder>
<csvlifecycle/>
<csvlifecyclestate/>
<csvparentContainerPath></csvparentContainerPath>
<csvnavcriteria>NavCriteria_1</csvnavcriteria>
<csvcreatevariants>false</csvcreatevariants>
<csvtypedef>com.ptc.wpcfg.CustomVariantSpec</csvtypedef>
</csvVariantSpec>
<csvbatchInputFilePath>/vagrant/WindowsShareNew/EnhancedLoader/VSDetail.xml</csvbatchInputFilePath>
<csvdescription>MBT Bike Variant Specification</csvdescription>
<csvfolder>/Default</csvfolder>
<csvlifecycle/>
<csvlifecyclestate/>
<csvparentContainerPath></csvparentContainerPath>
<csvnavcriteria>NavCriteria_1</csvnavcriteria>
<csvcreatevariants>false</csvcreatevariants>
<csvtypedef>com.ptc.wpcfg.CustomVariantSpec</csvtypedef>
</csvVariantSpec>