使用 LoadFromFile 加载产品系列对象

数据管理功能 > 管理产品系列 > 产品系列管理 > 产品系列管理 > 使用 LoadFromFile 加载产品系列对象

LoadFromFile 为用于向 Windchill 数据库加载单个自定义数据文件的命令行实用程序，凭借该程序可轻松创建或将大量旧数据迁移至新的 Windchill 以供使用。有关此实用程序的详细信息，请参阅使用 LoadFromFile 实用程序和加载实用程序概览。

以下命令可用于通过 LoadFromFile 实用程序加载单个加载文件：

windchill wt.load.LoadFromFile -d <ExampleLoadfile.xml>

，此命令中的 <ExampleLoadFile.xml> 为您想要加载的加载文件的名称。

加载实用程序仅处理 XML 文件。CSV2XML 实用程序用于将 CSV 文件转换为 XML 格式文件。如果数据是 CSV 格式的，则可在将数据加载到数据库之前使用 CSV2XML 实用程序将其重新格式化为 XML 文件。有关详细信息，请参阅将 CSV 文件转换为 XML 格式文件。

此实用程序可用于执行以下产品系列操作：

• 创建产品系列、产品型号组、产品型号或受管理的变型规范

• 创建产品系列成员对象之间的使用关系链接

• 将可配置模块对象分配给产品系列或产品模型

• 将独立变型规范转换为组织变型规范

• 更改变型规范的 LifeCycleTemplate 或 LifeCycleState 值

• 创建手动选择规则

产品系列成员是指以下对象：

• 产品系列

• 产品型号组

• 产品型号

• 变型规范

拥有上述对象类型读写权限的用户可运行此实用程序。

创建产品系列对象

使用 createProductFamilyMember 组件创建以下类型的对象：

• 产品系列

• 产品型号组

• 产品型号

• 受管理的变型规范

您可以使用单个加载文件中的不同组件。可支持任何组合。

• 下表中的编号和版本值可以为字母数字。

• 除布尔值以外的所有值均区分大小写。

元素	数据类型	说明
csvpfmName	字符串	可选。指定产品系列成员对象的名称。
csvpfmNumber	字符串	可选。指定产品系列成员对象的标识号。
csvpfmType	字符串	以 <WCTYPE\|objectName> 格式指定产品系列成员对象的对象类型。例如，WCTYPE\|wt.productfamily.ProductFamily、WCTYPE\|wt.productfamily.ProductModelGroup、WCTYPE\|wt.productfamily.ProductModel、WCTYPE\|com.ptc.wpcfg.doc.VariantSpec。
csvtopPFNumber	字符串	指定包含此产品系列成员对象的产品系列的标识号值。如果创建产品系列，则此值必须为其自己的编号值。
csvversion	字符串	可选。目前仅预先存在的变型规范支持此元素。指定要为预先存在的变型规范创建的新版本，而非创建新对象。
csvcontainerPath	字符串	可选。指定产品系列成员对象的容器。
csvnavcriteria	字符串	可选。指定针对新变型规范设置的导航条件的名称。

创建产品系列成员对象之间的使用关系链接

使用 createUsageLink 可将产品系列、产品型号组、产品型号和变型规范对象链接在一起，以形成一个产品系列结构。

元素	数据类型	说明
csvpfmParentNumber	字符串	指定作为链接父项角色的对象的编号值。
csvpfmChildNumber	字符串	指定作为链接子项角色的对象的编号值。

将可配置模块对象分配给产品系列或产品模型

使用 setConfigurableModule 可为产品系列或产品型号对象分配可配置模块 (WTPart) 对象。

元素	数据类型	说明
csvpfmNumber	字符串	指定设置可配置模块参考时所基于的产品系列或产品型号的编号值。
csvcsNumber	字符串	指定作为给定产品系列或产品型号可配置模块的 WTPart 的编号值。

将独立变型规范转换为组织变型规范

使用 createOrganizedVariantSpec 可将独立变型规范转换为组织变型规范。

元素	数据类型	说明
csvtopPFNumber	字符串	指定将包含此变型规范对象的产品系列的编号。
csvpfmParentNumber	字符串	指定将作为此变型规范父项对象的产品型号的编号值。
csvvsNumber	字符串	指定要通过将其与指定产品系列和产品型号相关联以转换为组织变型规范的独立变型规范的编号值。

针对变型规范更改生命周期模板和生命周期状态值

使用 setProductFamilyVariantLifeCycle 可针对现有变型规范对象设置 LifeCycleTemplate 或 LifeCycleState 值。

元素	数据类型	说明
csvvsNumber	字符串	指定必须更改 LifeCycleTemplate 或 LifeCycleState 值的现有变型规范的编号值。
csvversion	字符串	指定必须更改 LifeCycleTemplate 或 LifeCycleState 值的现有变型规范的修订版本。
csviteration	字符串	指定必须更改 LifeCycleTemplate 或 LifeCycleState 值的现有变型规范的小版本。
csvlifecycle	字符串	指定新的 LifeCycleTemplate 值。该值可以为空，以保留当前值。
csvlifecyclestate	字符串	指定新的 LifeCycleState 值。该值可以为空，以保留当前值。

为变型规范创建手动规范规则

使用 beginCreateManualSelectionRules、createManualSelectionRules 和 endCreateManualSelectionRules 的组合可快速轻松地为现有变型规范对象创建一组手动选择规则。此加载手动选择规则的方法假设您想要使用最新版本的变型规范、父项部件和子项部件。在创建新规则之前，此方法将删除指定父项部件所有预先存在的规则 (位于指定变型规范的上下文中)。这是一种加载手动选择规则的方法。另一种方法是以受控方式创建规则，这种方法将会在后续章节详细介绍。

方法	元素	数据类型	说明
beginCreateManualSelectionRules	csvmanualSelectionRuleVariantSpecNumber	字符串	指定作为新手动选择规则上下文的现有变型规范的编号值。
beginCreateManualSelectionRules	csvmanualSelectionRuleParentPartNumber	字符串	指定部件的编号值，该部件将作为您要为其创建手动选择规则的链接的父项角色。
createManualSelectionRules	csvmanualSelectionRuleChildPartNumber	字符串	指定部件的编号值，该部件将作为您要为其创建手动选择规则的链接的子项角色。
endCreateManualSelectionRules	无。

以受控方式创建手动规范规则

将 createModuleVariantSelectRule 与 com.ptc.wpcfg.load.LoadHelper 处理程序配合使用可以更为可控的方式创建手动选择规则。此加载手动选择规则的方法允许您就如何创建规则指定更为精确的细节。使用以下任何一个元素为正确的父项-子项链接创建规则：

• csvchildToSelectNumber

• csvlinkComponentId

• csvlinkLineNumber

此方法创建的新规则将覆盖使用相同变型规范 - 父项部件 - 子项部件组合的现有规则。

元素	数据类型	说明
csvvariantSpecNumber	字符串	指定作为新手动选择规则上下文的现有变型规范的编号值。
csvvariantSpecRevision	字符串	指定作为新手动选择规则上下文的现有变型规范的修订版本。
csvparentNumber	字符串	指定部件的编号值，该部件将作为您要为其创建手动选择规则的链接的父项角色。
csvparentView	字符串	可选。为父项部件指定视图。除非父项部件不具有 View 值，否则必须始终指定该视图。
csvparentViewVariation1	字符串	可选。指定父项部件的 BOM 类型视图变体。示例值为成本核算、生产、测试。
csvparentViewVariation2	字符串	可选。指定父项部件的备用编号视图变体。示例值为 001、002、003、004、005。
csvorganizationName	字符串	可选。指定父项和子项部件所在组织的名称。
csvchildToSelectNumber	字符串	可选。指定部件的编号值，该部件将作为您要为其创建手动选择规则的链接的子项角色。若您想要指定 csvlinkComponentId 或 csvlinkLineNumber 值，请将此项留空。
csvlinkComponentId	字符串	可选。指定您想要为其创建手动选择规则的链接的组件 ID。若您想要指定 csvchildToSelectNumber 或 csvlinkLineNumber 值，请将此项留空。
csvlinkLineNumber	字符串	可选。指定您想要为其创建手动选择规则的链接的行号。若您想要指定 csvchildToSelectNumber 或 csvlinkComponentId 值，请将此项留空。
csvactive	布尔型	为用于筛选的新手动选择规则指定 true。为要在激活后用于筛选的新手动选择规则指定 false。