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