从电子表格加载变型规范
您可以使用 Windchill 命令行实用程序从电子表格加载多个变型规范。此实用程序依赖于通过编程方式加载变型规范的 API。
|
|
要使用此功能：
• 必须安装 Platform Structures 模块。
• 您必须是“站点管理员”，且为 Platform Structures 组的成员。
|
要从电子表格加载变型规范：
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 下。
电子表格包含 3 个工作表，您可在其中输入变型规范和部件结构配置的相关信息：
• “部件配置规范”工作表 (Part Config Specs) - 此工作表的信息与您在配置部件时于“配置”窗口的“配置规范”选项卡上指定的信息类似。此工作表有 5 个字段：Configuration Specification Name、View、Life Cycle State、Baseline 和 Effectivity Date。“名称”为必填字段。“视图”的值必须为有效条目且与“配置”窗口中的“视图”字段相对应。输入的值会经过系统验证。
• “选项筛选器配置规范”工作表 (
Option Filter Config Specs) - 此工作表定义了选项筛选器的配置规范。此工作表有 3 个字段：
“配置规范名称”、
“生命周期状态”和
“有效日期”。输入的信息与您在
“设置选项筛选器的配置规范”窗口 (单击
图标从
“选项筛选器”窗口即可访问) 中指定的信息相似。输入的值会经过系统验证。
• “浏览条件”工作表 (Navigation Criteria) - 提供选取项规则和所选选取项的信息以捕获“选项筛选器”中的选择。工作表具有以下字段：
◦ “变型规范”部分：
▪ Name - 输入要分配至变型规范的名称。
▪ Number - 仅当想要重新配置现有的变型规范时，才使用此列。如果提供了有效的编号并且存在具有此编号的变型规范，则会使用保留的名称。
▪ Description - 提供变型规范的说明 (不超过 2000 个字符)。
▪ Location - 指定变型规范的存储位置。如果此字段为空，该实用程序将使用默认位置。如果此字段对于创建的变型规范为空，则实用程序会发出错误消息。
▪ Create Variants - 此为布尔值。当设置为 true 时，系统会为变型规范创建模块变型。由于创建模块变型是异步的，实用程序仅会记录各个变型队列条目创建的成功/失败状况 (而非实际变型)。当此字段设置为 false 时，实用程序仅会创建变型规范。
◦ “部件”部分 - 此部分提供了要使用变型规范进行配置的部件的详细信息。该实用程序需要部件具有已分配的选项集。如果没有分配选项集，则不会处理行。
▪ Number - 部件编号 (例如 "Bicycle1")。
▪ Revision - 部件的修订版本 (例如 "A")。
▪ Iteration - 部件的小版本 (例如 "1")。在本示例中，部件为 "Bicycle1 A.1"。
| 如果提供了部件的信息，则有关选项集的信息是多余的。必须提供 Part 或 Option Set 字段二者之一的信息，无需全部提供。 |
◦ “选项集”部分 - 变型规范通过使用选项集进行创建。如果没有为该行指定部件，则会使用实用程序创建此类变型规范。
▪ Name - 选项集的名称。
▪ Revision - 部件的修订版本 (例如 "A")。
▪ Iteration - 部件的小版本 (例如 "1")。
◦ “浏览条件”部分 - 此部分捕获用户界面中“配置规范”选项卡和“选项筛选器”选项卡上指定的信息：
▪ Apply to Top - 将此属性设置为 true 等同于在“配置”窗口的“配置规范”选项卡上选中相同复选框。当 Apply to Top 设置为 true 时，系统会将配置规范应用至所提供部件结构中最顶层部件。
| 对于仅使用选项集创建的变型规范而言，此信息并非必需。如果提供了此信息，验证程序会报告一个错误。 |
▪ Part Configuration Specification - 提供已使用工作表 1 加载的部件配置规范列表。可以提供多个配置规范并用逗号 (,) 隔开加以区分。如果在 F - H 列中指定了部件且将该列留空，则实用程序会加载最新部件配置规范并用其创建变型规范。
▪ “选项筛选器”配置规范 - 提供已使用工作表 2 加载的“选项筛选器”配置规范列表。可以提供多个配置规范并用逗号 (,) 隔开加以区分。当此信息留空时，实用程序会下载最新“选项筛选器”配置规范并用其创建变型规范。
▪ Disable Rule Checking - 默认情况下已设置为 false。当设置为 true 时，相当于选中“配置”窗口中的复选框。
▪ “筛选器模式”- 类似于“选项筛选器”选项卡上的下拉列表 (可在其中选择“标准”或“备用”)。
◦ “开始选项”列 - 空列表示开始定义选取项以供“选项筛选器”选择。
◦ 附加列 - 针对每个想为“选项筛选器”选择选取项的选项提供一列。
例如：如果您想从 OptionA 中选择 ChoiceA、ChoiceB 和 ChoiceC，并从 OptionB 中选择 ChoiceD，则需要在“开始选项”列之后创建两列 - OptionA 和 OptionB。在创建变型规范信息的行中，于 OptionA 下列出 ChoiceA、ChoiceB 和 ChoiceC 并以逗号分隔；在 OptionB 下列出 ChoiceD。如果下一行 (即下一个变型规范) 具有选自不同选项的选取项，则以该选项的名称来创建一个新列，相应选取项填入新列下所要填写行的单元格中。您可以将此行中 OptionA 和 OptionB 下的单元格留空。
| 如果系统中存在同一变型规范的版本，您需要通过其编号参考变型规范。 |
◦ “结束选项”列 - 这是工作表中的最后一列。它标示“选项筛选器”所有选项和选取项的末尾。
输出文件
运行实用程序来导入电子表格时，系统会创建一个输出文件。输出文件位于日志文件夹 WT_HOME\logs 中，名为 VariantSpecLoaderReport_<random_generated_number>*。
输出文件包含以下信息：
• 正在处理的浏览条件工作表上的行号。
• 操作状况：“成功”或“失败”。
• 变型规范编号 (如果已成功创建变型规范)。
• 已创建 - 如果创建了一个新的变型规范，则“已创建”将设置为 true。否则，“已创建”将会设置为 false。
• “已更新”- 如果变型规范为现有规范，则“已更新”将会设置为 true。这意味着变型规范已基于电子表格中提供的变型规范编号进行了重新配置。
• “错误”- 报告在处理电子表格并进行验证期间或创建对象时遇到的错误。如果遇到错误，则该实用程序不会处理该行，并在报告中记录该错误后继续处理下一行。
• “警告”- 如果处理行时出现警告或假设，则会在报告中将其记为警告。
使用电子表格加载变型规范的指导原则
请考虑以下信息：
• 仅使用 .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>
