从电子表格加载变型规范
可配置模块的独立变型规范、选项集的独立变型规范和受控选项筛选器都可以使用 Windchill 命令行实用程序从格式化电子表格进行加载。此实用程序可加载一个或多个变型规范，以支持创建或更新独立变型规范和受控选项筛选器。此实用程序所依赖的 API 用于以编程方式加载变型规范，并且规则处理也会应用其中。选择按其定义的顺序进行选定，并且除非由规则驱动，否则会被视为用户选定的选择。
 |
从电子表格加载变型规范是一项受单独许可证授权约束的高级功能。
|
要从电子表格加载变型规范，需执行以下步骤：
1. 创建电子表格加载程序文件
2. 执行加载程序实用程序
3. 审阅生成的日志文件
在创建要加载的电子表格时，将位于 WT_HOME\loadFiles\ato\testdata\variantSpecLoader 目录下的 VariantSpecLoader1.xlsx 文件作为模板。
此电子表格包含 3 个工作表，用于输入与变型规范、部件配置规范和选项筛选器配置规范相关的信息：
• 变型规范工作表用于指定变型规范的基本信息，且其中包含选定的选择信息。
• 部件配置规范工作表用于指定由一个或多个变型规范使用的一个或多个部件配置规范。
• 选项筛选器配置规范工作表用于指定由一个或多个变型规范使用的一个或多个选项筛选器配置。
变型规范工作表
变型规范 (Variant Specification) 工作表提供了有关创建或更新变型规范所需的信息，并参考了有关其他工作表的部件配置规范和选项筛选器配置规范信息。此工作表具有以下字段：
变型规范部分
|
字段
|
说明
|
|---|---|
|
Name
|
变型规范的名称。创建新变型规范时需要提供名称。
|
|
Number
|
变型规范的编号。更新变型规范时需要提供编号。
如果同时提供了名称和编号，并且存在与此信息匹配的变型规范，则会更新变型规范。如果找不到与所提供的名称和编号匹配的变型规范，则会创建变型规范。
如果仅提供了编号，则会更新与此编号匹配的变型规范。
|
|
Type
|
要创建的变型规范可变类型。此字段为选填字段。
|
|
Description
|
提供变型规范的说明 (最多 2000 个字符)。
|
|
Location
|
创建变型规范的位置。此字段为必填字段。更新现有变型规范时未应用位置。
|
|
Create Variants
|
对于与可配置模块关联的独立变型规范，仅当此字段设置为 true 时，才会为此变型规范创建模块变型。如果将此字段设置为 false 或将其留空，则不会生成模块变型。
对于与选项集或受控选项筛选器关联的独立变型规范，由于不支持生成变型，因此，必须将此字段的值设置为 false 或将其留空。
|
部件部分
只有在创建与可配置模块关联的独立变型规范时，才必须提供本部分中的信息。
|
字段
|
说明
|
|---|---|
|
Number
|
与可配置模块关联之独立变型规范的可配置模块的部件编号。例如，对于标识为 BICYCLE1, Bicycle1, Demo Organization, A.1(Design) 的部件，其部件编号为 BICYCLE1。
|
|
Owning Organization
|
与可配置模块关联之独立变型规范的可配置模块的拥有组织。例如，对于标识为 BICYCLE1, Bicycle1, Demo Organization, A.1(Design) 的部件，其拥有组织为 Demo Organization。
仅当使用相同的部件编号标识不同组织所拥有的不同部件时，才需要此字段。
|
|
Revision
|
与可配置模块关联之独立变型规范的可配置模块的修订版本。例如，对于标识为 BICYCLE1, Bicycle1, Demo Organization, A.1(Design) 的部件，其修订版本为 A。
|
|
Iteration
|
与可配置模块关联之独立变型规范的可配置模块的小版本。例如，对于标识为 BICYCLE1, Bicycle1, Demo Organization, A.1(Design) 的部件，其小版本为 1。
|
|
View
|
与可配置模块关联之独立变型规范的可配置模块的视图。例如，对于标识为 BICYCLE1, Bicycle1, Demo Organization, A.1(Design) 的部件，其视图为 Design。
只有在多个视图中存在相同版本的部件时，才需要此字段。
|
选项集部分
只有在创建与选项集或受控选项筛选器关联的独立变型规范时，才必须提供本部分中的信息。
|
字段
|
说明
|
|---|---|
|
Name
|
与选项集或受控选项筛选器关联之独立变型规范的选项集的名称。
|
|
Revision
|
选项集的修订版本。将使用修订版本的最新小版本。
|
浏览条件部分
|
字段
|
说明
|
|---|---|
|
Apply to top level object
|
对于与可配置模块关联的独立变型规范，此必需属性可确定是否将配置规范应用于可配置模块。
对于独立变型规范，此必需属性可确定是否将配置规范应用于顶层对象。
此字段不适用于受控选项筛选器，且必须留空。
|
|
Part Configuration Specification
|
对于任何独立变型规范，它会标识要包括在变型规范中的部件配置规范：
• 必须使用“部件配置规范”选项卡中的一个或多个配置规范名称来标识变型规范的部件配置规范。
• 对于与可配置模块关联的独立变型规范，针对为可配置模块指定的视图，空白部件配置规范会默认为最新配置规范，但不设置生命周期状态。
• 对于与选项集关联的独立变型规范，针对 Design 视图，空白部件配置规范会默认为最新配置规范，但不设置生命周期状态。
对于受控选项筛选器，“部件配置规范”必须留空。
|
|
Option Filter Configuration Specifications
|
标识要包括在变型规范中的选项筛选器配置规范：
• 必须使用“选项筛选器配置规范”选项卡中的一个或多个配置规范名称来标识变型规范的选项筛选器配置规范。
• 空白选项筛选器配置规范默认为最新配置规范，但不设置生命周期状态。
|
|
Disable Rule Checking
|
确定是否必须对变型规范禁用规则检查。如果未指定任何值，则默认使用 False。
|
|
Filter Mode
|
确定变型规范的筛选模式。如果未指定任何值，则系统会使用第一种筛选模式，即常用的标准模式。有关详细信息，请参阅配置标准和备用行为。
|
|
“开始选项”列
|
对于要加载的每个变型规范，空列表示其选定选择所对应的选项列定义的开头。
|
|
附加列
|
针对每个想要为“选项筛选器”选取选择的选项提供相应的列。可提供 Name 或 Number 来标识选项或选择。
例如，如果要从 OptionA 中选取 ChoiceA1、ChoiceA3 和 ChoiceA5，以及从 OptionB 中选取 ChoiceB4，则需要用到“开始选项”列后面的两列，即 OptionA 和 OptionB。针对变型规范信息行，在 OptionA 下以逗号分隔列表形式输入 ChoiceA1、ChoiceA3 和 ChoiceA5，在 OptionB 下输入 ChoiceB4。如果下一行 (即下一个变型规范) 具有选自不同选项的选择，则以该选项的名称创建一个新列，且相应的选择会填入此新列下所要填写行的单元格中。此行中 OptionA 和 OptionB 下的单元格可留空。
要输入布尔型选择名称，可以使用内部选择名称 OptionName_TRUE 或 OptionName_FALSE，也可以指定 true 或 false 值。
|
|
结束选项
|
此列为工作表中的最后一列。它用来标示选项筛选器所有选项和选定选择的末尾。
|
部件配置规范工作表
部件配置规范 (Part Config Specs) 工作表会提供有关指定要使用变型规范加载的一个或多个部件配置规范的信息。部件配置规范类似于“配置”窗口中的“配置规范”选项卡的作用，可用于加载交互式系统中可能存在的定义子集。此工作表可用于加载最新配置规范、基线配置规范和日期有效性配置规范。
|
字段
|
说明
|
|---|---|
|
Configuration Specification Name
|
即用于标识电子表格内部件配置规范的名称。在“变型规范”选项卡的“部件配置规范”列中所指定的任何名称都必须与“部件配置规范”选项卡上的定义名称相匹配。如果在其余列中定义名称时未指定任何值，则系统会使用最新部件配置规范，而不设置生命周期状态或视图。在定义名称并指定值时，将定义下列部件配置规范：
• 最新：生命周期状态和视图
• 基线：基线
• 日期有效性：有效日期
|
|
View
|
用于最新部件配置规范的视图。
|
|
Lifecycle State
|
用于最新部件配置规范的生命周期状态。
|
|
Baseline
|
基线部件配置规范的现有基线的编号。
|
|
Effectivity Date
|
日期有效性部件配置规范的有效日期。
|
选项筛选器配置规范工作表
选项筛选器配置规范 (Option Filter Config Specs) 工作表会提供有关定义一个或多个选项筛选器配置规范的信息。选项筛选器配置规范类似于“配置”窗口“选项筛选器”选项卡中“设置配置规范”操作的作用，可用于加载交互式系统中可能存在的定义子集。此工作表可用于加载最新配置规范和日期有效性配置规范。
|
字段
|
说明
|
|---|---|
|
Configuration Specification Name
|
用于标识电子表格内选项筛选器配置规范的名称。在“变型规范”选项卡的“选项筛选器配置规范”列中所指定的任何名称都必须与“选项筛选器配置规范”选项卡上的定义名称相匹配。如果在其余列中定义名称时未指定任何值，则系统会使用最新选项筛选器配置规范，而不设置生命周期状态。在定义名称并指定值时，将定义下列部件配置规范：
• 最新：生命周期状态
• 日期有效性：有效日期
|
|
Lifecycle State
|
用于最新选项筛选器配置规范的生命周期状态。
|
|
Effectivity Date
|
日期有效性选项筛选器配置规范的有效日期。
|
加载变型规范
要从电子表格加载变型规范：
1. 使用 WT_HOME\loadFiles\ato\testdata\variantSpecLoader 中提供的模板 VariantSpecLoader1.xlsx 创建电子表格。
2. 从 Windchill 命令行实用程序运行以下命令：
Windchill com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_Spreadsheet_Path>\<My_Spreadsheet>.xlsx -u <my_user> -p <my_password>
3. 审阅 WT_HOME\logs 中的输出文件以解决任何错误。
输出文件
运行实用程序来导入电子表格时，系统会创建一个输出文件。输出文件位于日志文件夹 WT_HOME\logs 中，名为 VariantSpecLoaderReport_<random_generated_number>*。
输出文件包含以下信息：
• 正在处理的浏览条件工作表上的行号。
• 操作状况：SUCCESS 或 FAILED。
• 变型规范编号 (如果已成功创建变型规范)。
• CREATED - 如果创建了一个新的变型规范，则 CREATED 将设置为 true。否则，CREATED 将设置为 false。
• UPDATED - 如果变型规范为现有规范，则 UPDATED 将设置为 true。这意味着变型规范已基于电子表格中提供的变型规范编号进行了重新配置。
• ERROR - 用于报告在处理电子表格并进行验证期间或创建对象时所遇到的错误。如果遇到错误，则该实用程序不会处理该行，并在报告中记录该错误后继续处理下一行。
• WARNING - 如果处理行时出现警告或假设，则会在报告中将其记为警告。
使用电子表格加载变型规范的指导原则
请考虑以下信息：
• 仅使用 .xlsx (默认 Microsoft Office Excel 2007) 电子表格格式加载变型规范。
• 请注意，在 UNIX 中，用于加载变型规范的 Windchill 命令区分大小写。请使用以下语法：
windchill com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_spreadsheetpath>
• 当使用电子表格修改变型规范时，即使变型规范的结构和选定选择没有更改，输入 Create Variants = True 也会生成新的变型 (覆盖现有变型)。
• 使用出厂 API 或电子表格时，不支持使用用户定义的变型规范编号来创建变型规范。
• 要在电子表格中提供变型规范的文件夹位置，可以使用在该产品 /Default 文件柜中创建的所有文件夹，例如 /Default/ABC。
• 要修改现有变型规范，必须指定与变型规范相关联的部件。此类情况下，请勿指定选项集。
• 不支持基于版本修改变型规范。将始终重新配置最新版本。
• 请遵循以下特殊字符指导原则：
◦ 名称中带有双引号的选择前面必须带有反斜杠 "\"，例如 "\a"1\"。
◦ 名称中带有特殊字符的选择必须括在双引号中，例如 "a_1"。
在调试模式下运行实用程序
可以在调试模式下运行该实用程序，这会在 wt_home\logs 文件夹中创建一个可用于调试错误的 log4j 文件。日志文件会记录正在处理的电子表格中每一行内的错误。
要在调试模式下使用该实用程序，请使用以下语法：
Windchill --jap=wt.properties?com.ptc.windchill.option.variantload.java.args com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_Spreadsheet_Path>\<My_Spreadsheet>.xlsx -u <my_user> -p <my_password>