企业管理 > 文件存储和复制 > 文件存储 > 理解文件存储 > 诊断和修复工具 > 检测和解析多个主要内容文件
  
检测和解析多个主要内容文件
WMultiPrimaryDetect 命令行实用程序用于检测和更正数据问题,其中有多个主要内容文件已与一个 FormatContentHolder 对象关联。使用命令 windchill wt.fv.tools.WMultiPrimaryDetect,从 Windchill shell 中运行 WMultiPrimaryDetect,可根据需要传递合适的参数。如果未提供任何参数,该工具将在诊断模式下运行。
在默认模式下运行此工具将输出 XML 文件 multiPrimaryDiagnosis_<YYYYMMDD_HHMM>.xml,列出所有不正确的 FormatContentHolders 及其多个主要内容项。该工具要求 Windchill 方法服务器实例已启动并正在运行。
以下是可用的自变量及其说明:
自变量
说明
-user=<adminid>
管理员用户的用户 ID。
-password=<adminpassword>
管理员用户的密码。
-fix
在修复模式下运行。如果使用该自变量,必须同时指定 -inputFile 参数。如果删除了任何内容文件,则会在 <WT_HOME>/logs/ContentItems 目录中创建该内容文件的副本。
* 
将不会删除电子仓库中的内容文件;只是删除它们在数据库中的条目。
-inputFile=<input full path and filename>
使用指定的 XML 文件删除主要内容项。用作输入的 XML 文件是在诊断模式 (默认模式) 下运行该工具时所生成的 XML 文件。对于要删除数据库条目的内容项,必须更新诊断文件,以将 deleteThisItem 字段的值更改为 Y
* 
将不会删除电子仓库中的内容文件,只是删除它们在数据库中的条目。
-outputPath=<output pathname>
使用在 outputPath 参数中指定的目录路径保存 XML 输出文件。
* 
默认情况下,将在 <WT_HOME>/logs 目录中创建一个文件,其名称为日志的时间戳,同时 XML 文件会保存在此处。如果已指定此自变量且提供了路径,则使用该指定路径。
-confirmBeforeDelete=<Y/N>
删除每个文件之前要求用户进行确认。默认值为 Y
-usage
打印有效自变量的列表,然后退出。
要在修复模式下运行,该实用程序需要一个输入文件,用来指定要删除的文件。用作输入的 XML 文件是在诊断模式 (默认模式) 下运行该工具时所生成的 XML 文件,但您已将其更新为针对要删除的内容项而将 deleteThisItem 字段更改为 Y
* 
以任何其他方式修改 XML 文件都可能导致产生不一致的结果。
另外,请注意,每个 ContentHolder 必须至少存在一个主要内容项。如果已在 XML 文件中将 ContentHolder 的所有内容项均标记为删除,则该工具将针对该 ContentHolder 的所有内容项打印一条错误消息 (在 XML 文件的 errorMessage 字段中),不删除任何一个内容项,并将继续处理其余的 XML 文件。errorMessage 字段是可选字段,对于已成功删除的对象,不会显示该字段。
在修复模式下运行该工具时,会生成结果 XML 文件,它与输入文件存储在同一目录中。文件名称使用以下格式:multiPrimaryResults_<YYYYMMDD_HHMM>.xml。此 XML 文件的格式与 multiPrimaryDiagnosis 报告非常相似,只是用 itemDeleted 字段替换了 deleteThisItem 字段。该字段包含一个针对已删除的内容项的值 Y
已删除内容文件的副本另存为原始文件名。如果多个文件具有相同的名称,则添加编号形式的后缀,如 _1、_2 等等。保存的名称也将存储在 multiPrimaryResults XML 文件中。
* 
在 WMultiPrimaryDetect 工具中,记录功能由 wt.properties.中的 wt.fv.verbose 设置控制。如果将该属性设置为“真”,则工具将提供详细输出。