子类型化的命令行管理

从较早版本迁移到 X-20 时，可以使用命令行实用程序来更改现有 EPMDocument 的子类型。子类型的更改将应用到给定 EPMDocumentMaster 的所有小版本。只为各个修订版本的最新小版本进行约束验证，如果在这些小版本上违反约束，则子类型的更改将失败。

本部分将概述命令行实用程序的行为。应当在升级到 Windchill 10.0 之后且所有用户均可访问升级的系统之前执行该实用程序。客户应使用“类型和属性管理”实用程序来创建所需的子类型，然后使用该实用程序来更改现有 EPMDocument 的子类型。

该实用程序具有两种模式。

• 批处理模式：在此模式下处理 csv 文件。在此模式下使用该实用程序时，每次处理一组 EPMDocument。使用新的子类型来更新 EPMDocument 的条件将在 csv 文件中指定。在此模式下使用该实用程序的命令是：

• 单一文档模式：在此模式下处理单个 EPMDocument。在此模式下使用的命令为：

java wt.epm.util.SoftTypeChangeUtility <文档 CADName>
<新可变类型的逻辑 ID>[contextName]

在这两种操作模式下，指定的新子类型必须是“CAD 文档”子类型的承袭项。如果新子类型不是“CAD 文档”的承袭项，则操作会中止

要在批处理模式下进行操作，需创建一个以逗号分隔的 (.csv) 文件，在其中指定：

• 属性三重值的组合：authoringApplication、EPMDocumentType 和 EPMDocumentSubType

• 要在属于特定三重值的文档上设置的子类型的内部名称

可以为 EPMDocumentType 和 EPMDocumentSubType 指定星号 '*'。例如，如果为参数 EPMDocumentSubType 指定 '*'，则会选择与指定 authoringApplication 和 EPMDocumentType 匹配的任何 EPMDocumentSubType 的所有文档。不能为 authoringApplication 指定 ‘*’。

可以将 EPMDocumentSubType 留空以选择 EPMDocumentSubType 为 NULL 的 EPMDocument。

.csv 文件中的条目格式为：

以下是对每个条目字段的说明。

• EPMDocumentSubType - 特定 EPMDocumentSubType、'*' 或空字符串

• “新建子类型”- 要分配的新子类型的特定逻辑 ID。

如果未指定这些参数的预期值，则操作会停止。

WT_HOME\src\wt\epm 文件夹中的 EPMDocSubTypeRB.rbInfo 和 EPMDocumentTypeRB.rbInfo 可提供有关所有文档类型和子类型的完整信息。

对于 .csv 文件中的条目，每次仅处理一行。先处理最初生成的条目。如果任何后续条目选择相同的 EPMDocument，则重新使用正在处理的行中所指定的子类型来更改条目的子类型。

执行后，子类型的更改会应用到选定 EPMDocument 的所有小版本。只为选定 EPMDocument 的各个修订版本的最新小版本进行约束验证，如果在其中一个小版本上违反约束，则子类型的更改将失败。

在单一文档模式下，每次只更新一个 EPMdocument。每个 EPM 文档的命令行条目如下所示。

"contextName" 是可选项，且仅在必须更改项目上下文中的 EPMDocument 时才需要。如果未指定 contextName，则实用程序将假设指定的 EPMDocument 属于“产品”或“存储库”。

执行后，子类型的更改会应用到给定 EPMDocumentMaster 的所有小版本。只为各个修订版本的最新小版本进行约束验证，如果在这些小版本上违反约束，则子类型的更改将失败。