排除 xconfmanager 问题

以下各节介绍了可能出现的与 Windchill Configuration Assistant 和 xconfmanager 实用程序相关的常见问题。

如果已将 windchillconfigurator.xconf 文件从 <Windchill>/utilities/wca/conf 目录中删除，但没有将 ConfigurationRef 元素从 site.xconf 文件中移除，则通过从命令行运行 xconfmanager 实用程序来传播更改将会导致错误。ConfigurationRef 元素会指定一个不存在的 windchillconfigurator.xconf 文件。这种情况下，xconfmanager 实用程序失败，并显示一个类似于以下内容的错误：

ERROR: Unexpected error (stack trace below):
com.ptc.windchill.structconf.StructConfManagerException: Error scanning xconf files to determine property-to-xconf dependencies caused by: Error parsing file:<Windchill>/Windchill/site.xconf, line 357 (starting at root doc file: <Windchill>/Windchill/site.xconf) caused by: Unable to generate URL for href=<Windchill>/utilities/wca/conf/windchill/windchillconfigurator.xconf'.

要从该错误恢复，可以从 site.xconf 中移除 ConfigurationRef，也可以重新创建 windchillconfigurator.xconf 文件：

• 要移除 ConfigurationRef 元素，可使用文本编辑器编辑 site.xconf 文件或运行 uninstallConfigRef 目标。

• 要重新创建 windhcillconfigurator.xconf 文件，可使用 installConfigRef 目标创建一个空的 windchillconfigurator.xconf 文件，或者在包含了 -Dpropagate=true 自变量的情况下运行 configureWindchill 目标。

用于运行 Assistant 的 Ant 命令语法中的“用于 site.xconf ConfigurationRef 元素的目标”一节介绍了 UninstallConfigRef 和 installConfigRef 目标。

如果尝试传播 Windchill Configuration Assistant 所建议的更改，但尚未向 site.xconf 文件添加 ConfigurationRef 元素，则在 ant 脚本尝试查找该元素时构建会失败。

通过传播尝试之前完成的所有内部目标的成功运行来更新的任何中间特性文件都会得到保留。例如，假定在运行 configureWindchill 目标时尝试传播。则不会删除构建失败之前生成的那些中间特性文件。

类似于如下内容的错误用于指示失败：

ERROR: site.xconf has no ConfigurationRef to
<Windchilll>/utilities/wca/conf/windchill/windchillconfigurator.xconf

要从该失败中恢复，可以按用于运行 Assistant 的 Ant 命令语法中的“用于 site.xconf ConfigurationRef 元素的目标”一节所述将 ConfigurationRef 元素添加到 site.xconf，然后按用于运行 Assistant 的 Ant 命令语法中的“用于从中间文件传播值的目标”一节所述运行可传播值的目标。

Windchill Configuration Assistant 特性值将存储在一个单独的 XCONF 文件中，而此文件位于 <Windchill>/utilities/wca/conf/windchill/windchillconfigurator.xconf，其中 <Windchill> 是 Windchill 安装目录。要查看 Windchill Configuration Assistant 设置的特性，可以在文本编辑器中打开 XCONF 文件。

Windchill Configuration Assistant 安装期间将向 site.xconf 文件添加 ConfigurationRef 元素，以在站点管理特性值和那些因运行 Windchill Configuration Assistant 而设置的值之间建立链接。从 site.xconf 文件传播值时，xconfmanager 实用程序将按照 site.xconf 文件中的顺序设置各值。谈到 Windchill Configuration Assistant ConfigurationRef 元素时，将设置 windchillconfigurator.xconf 文件中标识的值，然后转至 site.xconf 文件中的下一个元素。

如果通过 site.xconf 文件手动设置的特性与 Windchill Configuration Assistant 设置的特性相同，则 site.xconf 文件中手动设置的位置将决定 site.xconf 文件传播完成时所设置的值：

• 如果手动特性设置出现在 windchillconfigurator.xconf 文件的 ConfigurationRef 元素之后，则手动设置将覆盖通过 Windchill Configuration Assistant 设置的值。

• 如果手动特性设置出现在 windchillconfigurator.xconf 文件的 ConfigurationRef 元素之前，则通过 Windchill Configuration Assistant 设置的值将覆盖手动设置。

如果手动设置的特性值也是通过 Windchill Configuration Assistant 设置的，并且该值未进行传播，则检查 site.xconf 文件来确定其与 windchillconfigurator.xconf 文件的 windchillconfigurator.xconf 元素的相对位置。