加载实用程序概述

将旧数据迁移到新 Windchill 实施中是所有系统实施当中的一项基本需求，但很长时间以来都是一项繁重的手工作业。同样，将新采集的信息合并到 PDM 环境 (包括 Windchill) 中也是如此。

wt.load 程序包是一组用于加载演示程序或测试数据的框架实用程序。可对其进行扩展以加载新类。可以从命令行和其他类调用 LoadFromFile 实用程序。

Windchill LoadFromFile 框架执行从文件读入数据并将其转换为名称值对 (以散列表表示) 的工作，由对象加载程序处理名称值对。此外，加载框架还提供一些帮助程序方法，可供加载程序使用。对象加载程序执行创建对象、在其中设置属性并将其保持到数据库中的实际工时。

该框架使用导入/导出框架中的部分类。但是，大多数情况下，“工作器”类 (即，用于加载的对象加载程序和用于导入和导出的对象处理程序) 是独立的，并且期望数据采用不同的 XML 格式。换句话说，XML 模式不同。

LoadFromFile 是一个可用来将数据加载您自己的站点类的框架。wt.doc.LoadDoc.java 源文件作为使用加载程序包的方法示例包括在内。

main 或命令行调用或 doFileLoad 方法调用中的 LoadFromFile 使用下列参数将数据加载到系统：

• 数据文件 (必需) - 包含要加载的数据，位于方法服务器主机中。数据文件是一个必选参数。如果该字符串为空或者不在命令行中，则加载失败。建议包括该文件的完整路径名。如果不提供完整路径，该方法则会尝试读取从中启动加载的目录中的文件。

命令行没有使用 -u 用户选项，所以未预设任何用户。LoadFromFile 中的 main 调用 SessionHelper.manager.getPrincipal() 来提示输入用户并执行验证。doFileLoad 仍使用户传入，但它可为空。Demo 和 Developer 在调用 doFileLoad 前执行验证。建议您在调用 doFileLoad 之前先验证用户，因为它并不验证用户。当服务器端尝试使用从 doFileLoad 中传入的用户设置承担者时，该用户应最终被验证，但在调用 doFileLoad 之前在客户端对错误消息传送进行了最佳处理。

要从命令行运行 LoadFromFile，请确保服务器管理器和方法服务器正在运行，然后调用：

windchill wt.load.LoadFromFile -d c:\ptc\Windchill\loadfiles\ReqDocs.xml
-CONT_PATH \
"/wt.inf.container.OrgContainer=TST/wt.pdmlink.PDMLinkProduct=part 4\"

您可以使用此实用程序向 Windchill 数据库加载单个自定义数据文件，以便轻松创建数据或将大量旧数据迁移至新的 Windchill 实施。有关此实用程序的详细信息，请参阅使用 LoadFromFile 实用程序。

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

Windchill 加载程序可为任一已安装 Windchill 解决方案加载数据。该实用程序从 installed.properties 文件中获取已安装解决方案列表，每当安装一个解决方案就会更新此列表，并从 LoaderConfiguration.properties 文件中获取基础和演示数据的加载集。加载集是一些 XML 文件，其中列出必须加载以支持 Windchill 解决方案的数据文件。

每个解决方案有其自己的基础和演示数据集。还有一个应用于所有解决方案的基础数据集，其也称为 foundation。foundation 基础数据随解决方案特定基础数据自动安装。

除初始化数据库外，加载实用程序还会将用户和组添加到 LDAP 目录服务，如在 wt.properties 文件中设置的 wt.federation.ie.ldapServer 特性中所指定的那样。

有关 Windchill 加载程序的详细信息以及有关使用测试数据初始化和填充 Windchill 数据库的说明，请参阅《Windchill 安装和配置指南》。

除了 PTC 提供的演示数据外，可能还有一些旧数据要添加到 Windchill 数据库中。PTC 提供了两个实用程序来加载旧数据：

加载实用程序仅处理 XML 文件。您可以使用 CSV2XML 实用程序将 CSV 文件转换为 XML 格式文件。