UpdateSecurityLabels 命令行实用程序输出文件
在您运行 UpdateSecurityLabels 命令行实用程序后，系统会创建一个输出文件。该输出文件将显示实用程序所处理对象的对象状态信息。使用输出文件可解决运行实用程序时所发生的任何问题。在解决任何问题后，您可返回实用程序以确保所有对象都已应用适当的安全标签。
运行工具后，windchill shell 中的摘要行中会提供输出文件的位置。输出文件将使用 TSV 文件格式，但您可将其转换为 XLS 或 XLSX 以易于查看。在某些情况下，例如在处理大量数据时，可能会创建多个输出文件。在同一目录中，可以找到具有“_x”前缀的附加输出文件，其中“_x”为文件编号。
 |
任何附加输出文件都不具有指示列分配的标题行。您可从第一个输出文件中复制标题行。
|
输出文件中有针对对象标识符、显示标识、对象状态、描述状态的消息，以及安全标签的旧值和新值的列。此外，还会列出输入文件位置和具有成功、失败等项目的总数的摘要行。
下表显示了可能的对象状态值。输出文件中的可用详细信息数量可根据配置的 log4j.logger.UpdateSecurityLabelsReport 属性设置而有所不同。错误或失败将始终显示。
状况 | 说明 | 修复 |
|---|---|---|
已忽略: 对象无法应用安全标签。 | 在“对象标识符”列中的指定对象无法应用安全标签时出现。 只有某些对象类型可应用安全标签。有关详细信息，请参阅用于显示安全标签的对象类型。 | 无法应用安全标签更改。将对象从输入文件中移除。 |
失败: 指定的对象标识符无效。 | 在输入文件中的“对象标识符”列包含无效值时出现。 | |
失败: 缺失对象标识符信息 | 在输入文件中的“对象标识符”列为空时出现。 | 1. 输入适当的对象标识信息。 2. 将行从输入文件中移除。 |
失败: 对象不存在。 | 在无法在 Windchill 中找到对象时出现。 | 1. 检查输入文件中是否存在印刷错误。 2. 将对象从输入文件中移除。 |
失败: 无法设置对象的一个安全标签值，因为其位于个人文件夹或工作区中，并且该值将限制所有者的访问权限: <安全标签>=<值> | 在用户将指定对象检出并且安全标签值更改将阻止其检入对象时出现。 | 1. 检入对象。 2. 将输入文件中的目标安全标签值更新为不限制用户的访问权限的值。 |
失败: 无法设置此版本对象的一个安全标签值，因为有一个或多个对象版本位于个人文件夹或工作区中，并且该值将限制所有者的访问权限: <安全标签>=<值> | 在符合以下条件时出现： • 运行实用程序时指定了 -allVersions 参数。 • 用户将对象的某个版本检出并且安全标签值更改将阻止其检入对象。 | 1. 检入对象。 2. 将输入文件中的目标安全标签值更新为不限制用户的访问权限的值。 3. 在不使用 -allVersions 参数的情况下运行实用程序。 |
失败: 发生意外错误。请联系您的管理员。 | 在运行实用程序时出现错误的情况下出现。 | 联系您的管理员，告知其以下信息： • 实用程序的名称。 • 您遇到错误的时间。 |
失败: 遇到意外错误后 UpdateSecurityLabels 命令失败。 | 在运行实用程序时出现错误的情况下出现。 | 联系您的管理员，告知其以下信息： • 实用程序的名称。 • 您遇到错误的时间。 |
失败: 无法将对象的安全标签设置为目标值，因为标签或标签值已禁用: <安全标签>=<值> | 在输入文件中指定的安全标签或安全标签值已禁用时出现。 | 将输入文件中的安全标签值设置为有效选项。 • 如果安全标签已禁用，则可将安全标签值设置为相同值或不受限制的 (空) 值。 • 如果安全标签值已禁用，则可将安全标签值设置为相同的安全标签值、已启用的安全标签值或不受限制的 (空) 值。 • 检查安全标签配置文件，找到相应的 SecurityLabelValue 部分，并将各自启用的属性值更新为 true。 |
失败: 目标安全标签值无效: <安全标签>=<值> | 在输入文件中指定的安全标签值不是已配置的安全标签值时出现。 | 将输入文件中的安全标签值设置为有效的值。 |
失败：<Security Label> 不支持多个安全标签值 | 如果标准安全标签未配置为具有多个安全标签值，则当用户尝试为其设置多个值时显示该消息。 | 检查安全标签配置文件，找到相应的 SecurityLabel 元素，添加 MultiValueLogicalOperator 标记以及所需的条件。有关详细信息，请参阅SecurityLabel 元素。 |
无更改 | 在指定对象的安全标签值设置尚未发生更改时出现。 | |
成功 | 在指定对象的安全标签值设置已成功更新时出现。 |
| | 如果您在电子表格处理程序 (如 Microsoft Excel) 中打开输出文件，则可按对象状态对输出数据进行排序。 |