导入首选项
导入实用程序可用于导入先前导出的首选项信息。您可以对该实用程序从导出文件导入的首选项实例进行限制,例如,您可以仅导入特定用户或上下文的首选项实例。您还可以选择将导入的首选项实例应用于特定级别,如特定的组织或用户。在这种情况下,仅为在 -applyTo 参数中指定的级别创建首选项实例。不会创建与导入的首选项实例的原始级别相对应的首选项实例。
导入命令的语法如下:
windchill wt.preference.ImportPreferences -importfile="<filepath>"
运行导入实用程序时,会在运行工具的目录中创建一个名为 PreferenceImport_<YYYYMMDD_HHmm>.txt 的日志文件,其中 <YYYYMMDD_HHmm> 为运行实用程序的日期和时间。现有首选项信息与导入的首选项信息之间的任何不匹配都会被标记为冲突,记录在 PreferenceImportConflicts_<YYYYMMDD_HHmm>.txt 日志文件中,并创建在运行该工具的目录中。
用于确定此类冲突将引发哪些事件的命令支持参数。此外,还会记录新的首选项定义和实例。如果在当前导入的首选项实例中指定的首选项定义、类别或客户端的对应项不存在,则会将其标记为错误并进行记录。如果某个首选项定义存在,但已被定义在更高级别 (高于导入操作尝试应用导入的首选项实例的级别),则会记录一个错误。
如果出现任何错误,则会处理整个导入文件,记录所有错误,然后退出实用程序而不导入任何首选项实例。
如果未出现不匹配或错误,则会成功完成导入。
导入命令支持以下参数:
参数
说明
-importfile="<filepath>"
包括完整文件路径的 XML 文件,用于从中导入首选项。该文件通常使用首选项导出实用程序创建。如果提供的文件或文件路径无效,会显示一条错误消息。
此参数为必填参数。
-user="<adminID>"
站点管理员用户的用户 ID此参数应与 -password 参数一同指定。如果未指定这些参数,系统将在运行实用程序时提示您进行身份验证。
-password="<adminpassword>"
站点管理员用户的密码。此参数应与 -user 参数一同指定。如果未指定这些参数,系统将在运行实用程序时提示您进行身份验证。
-usage
显示命令的所有有效参数。
-debug="<debugLevel>"
控制信息消息或调试消息的级别。1 为最低级别,3 为最高级别。
-importSiteLevel
仅从导入文件中导入站点级别的首选项实例。
一次只能指定以下一个参数:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果导入文件中不存在指定级别的首选项实例,则会向日志添加一条信息消息,但不会将其视为一个错误。
-importOrgLevel="<FullPath>"
仅从导入文件中导入指定组织的首选项实例。一次只能指定一个组织。必须将组织的完全限定路径指定为参数值。
例如,要导入一个名为“演示组织”的组织的首选项实例,请按以下方式指定参数:
-importOrgLevel="/wt.inf.container.OrgContainer=Demo Organization"
一次只能指定以下一个参数:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果导入文件中不存在指定级别的首选项实例,则会向日志添加一条信息消息,但不会将其视为一个错误。
-importContainerLevel="<FullPath>"
仅从导入文件中导入指定上下文 (产品、存储库、项目或项目群) 的首选项实例。一次只能指定一个上下文。必须将上下文的完全限定路径指定为参数值。
例如,要导入“演示组织”中名为 Product1 的产品的所有首选项实例,请按以下方式指定参数:
-importContainerLevel="/wt.inf.container.OrgContainer=Demo Organization/wt.pdmlink.PDMLinkProduct=Product1"
一次只能指定以下一个参数:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果导入文件中不存在指定级别的首选项实例,则会向日志添加一条信息消息,但不会将其视为一个错误。
-importUserLevel=<userId>
仅从导入文件中导入指定用户的首选项实例。一次只能指定一个用户。例如,要导入 wcadmin 用户的所有首选项实例,请按以下方式指定参数:
-userLevel=wcadmin
一次只能指定以下一个参数:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果导入文件中不存在指定级别的首选项实例,则会向日志添加一条信息消息,但不会将其视为一个错误。
-overwriteValueConflicts
所有值不匹配冲突都将通过以导入值覆盖现有值的方式解决。如果指定此参数,则会将数据库中的所有多值首选项替换为导入的首选项值。
此首选项可以与 -skipUnresolvedConflicts 首选项一同指定,在这种情况下,导入操作应该会成功完成,而值冲突将被覆盖,并跳过所有未解决的冲突。
-skipUnresolvedConflicts
跳过所有未解决冲突。导入文档的剩余部分。
此首选项可以与 -overwriteValueConflicts 首选项一同指定,在这种情况下,导入操作应该会成功完成,而值冲突将被覆盖,并跳过所有未解决的冲突。
-applyToSiteLevel
只将导入的首选项实例应用到站点级别。
-applyToOrgLevel="<FullPath>"
只将导入的首选项实例应用到指定组织。参数值必须是组织的完全限定路径。可以将多个组织指定为逗号分隔的列表。
此参数只能与以下一个参数一同使用:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果已指定多个组织,则导入操作将分别应用于各个组织。如果能够对某些指定的组织成功完成导入操作,但无法对其他指定组织成功完成,则会显示一条消息,用于详细列出已成功完成导入操作的组织。来自未成功完成导入操作的组织的所有冲突都被记录在日志文件中。
-applyToContainerLevel="<FullPath>"
仅将导入的首选项实例应用于指定的一个或多个上下文 (产品、存储库、项目或项目群)。参数值必须是上下文的完全限定路径。可以将多个上下文指定为逗号分隔的列表。
此参数只能与以下一个参数一同使用:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果已指定多个上下文,则导入操作将分别应用于各个上下文。如果能够对某些指定的上下文成功完成导入操作,但无法对其他指定上下文成功完成,则会显示一条消息,用于详细列出已成功完成导入操作的上下文。来自未成功完成导入操作的上下文的任何冲突都被记录在日志文件中。
-applyToUserLevel="<userId>"
只将导入的首选项实例应用到指定的一个或多个用户。可以将多个用户指定为逗号分隔的列表。
此参数只能与以下一个参数一同使用:-importSiteLevel-importOrgLevel-importContainerLevel-importUserLevel
如果已指定多个用户,则导入操作将分别应用于各个用户。如果能够对某些指定的用户成功完成导入操作,但无法对其他指定用户成功完成,则会显示一条消息,用于详细列出已成功完成导入操作的用户。来自未成功完成导入操作的用户的任何冲突都被记录在日志文件中。
这对您有帮助吗?