导入更改命令

企业管理 > Business Administrative Change 升级 > 运行业务管理更改升级命令行实用程序 > 导入更改命令

导入更改命令

将导出的 ZIP 文件复制到目标系统后，可以在目标系统上运行 import 命令。

选项

必需？

说明

-f

--filepath

是

要导入的包 ZIP 文件的位置或绝对路径。

-o

--outputDirectory

否

保存导入日志文件的位置。如果未指定该选项，则文件将保存到当前目录。

导入日志的默认位置为 <WT_HOME>/${wt.temp}/bac/reports。您可以配置 wt.properties 中的 com.ptc.windchill.bac.import.report.location 属性，来修改导入日志文件的默认位置。

-d

--defaultResolutions

否

对于导入过程中发生的任何冲突，使用由 Windchill 提供的默认解决方案。所有具有适用默认解决方案的可覆盖冲突都将采用其默认解决方案加以解决，这些可覆盖冲突不会记录在“事件管理”实用程序中。

-s

--saveResolutions

否

通过此源系统保存您选择再次使用的任何解决方案。您可以选择在“事件管理”实用程序中报告的任何冲突的解决方案。

如果选择将该选项和 --reuseResolutions 选项一起使用，可先应用以前保存的任何解决方案。可以使用“事件管理”实用程序来选择所产生的任何问题的解决方案。如果同时选择这两个选项，则将导入时所选择的解决方案添加到先前保存的解决方案中。

-c

--conflictResolutionFile

否

指定将在导入过程中使用的冲突解决方案 XML 文件的路径。冲突解决方案 XML 文件指定了不同类型的冲突及其相应解决方案。如果选择将此选项与 --defaultResolutions、--saveResolutions 和 --reuseResolutions 三项之一或全部三项一起使用，则会先执行 XML 加载文件中提供的解决方案。如果 XML 文件中未提供解决方案，则会应用之前保存的解决方案。

-b

--useBundledConflictResolutionFile

否

使用包 ZIP 文件中提供的捆绑冲突解决方案文件来解决导入过程中出现的冲突。如果选择将此选项与 --defaultResolutions、--saveResolutions 和 --reuseResolutions 三项之一或全部三项一起使用，则会先执行捆绑的冲突解决方案文件中提供的解决方案。如果捆绑的冲突解决方案文件中未提供解决方案，则会应用之前保存的解决方案。

如果同时使用 -b、-c 和 -r 命令，则会以下列优先级顺序运行三者：首先运行 -b 命令，然后运行 -c 命令，最后运行 -r 命令。系统首先会在包 ZIP 文件中搜索文件。如果未找到任何文件，则系统会在包外搜索文件。如果包外没有任何文件，则系统会在数据库内进行搜索。

-n

--useBundledMapFile

否

使用包 ZIP 文件中提供的映射文件，以在导入过程中将源属性映射到目标属性。

如果同时使用 -n、-m 和 mapping values defined under Import mapping on UI 命令，则会以下列优先级顺序运行三者：首先运行 -n 命令，然后运行 -m 命令，最后运行 mapping values defined under Import mapping on UI 命令。系统首先会在包 ZIP 文件中搜索文件。如果未找到任何文件，则系统会在包外搜索文件。如果包外也没有任何文件，则系统会搜索 mapping values defined under Import mapping on UI。

-i

--ignoreTargetCheckforGUID

否

指定目标系统检查将略过的源系统的 GUID。

导入过程中，将使用源系统的 GUID 来检查其是否已注册到目标系统。如果设置了此选项，则系统会略过此检查，您可以从未注册的源系统中导入管理变更。

此选项仅在同步模式下可用。

您还可以在目标系统的 wt.properties 中配置 com.ptc.windchill.bac.ignoreGUIDList 属性，以指定源系统的 GUID。这样，导入过程中将不再检查是否存在源系统 ID 的指定列表。如果为 --ignoreTargetCheckforGUID 和 com.ptc.windchill.bac.ignoreGUIDList 指定不同的 GUID 值，则为 --ignoreTargetCheckforGUID 指定的 GUID 优先。

-v

--ValidateTarget

否

用于验证目标系统的 GUID 的命令。这仅对开发模式有效。默认情况下，系统不会针对目标系统执行 GUID 验证。

-r

--reuseResolutions

否

对于从此源系统中进行的先前导入，使用通过“事件管理”实用程序设置的任一可用解决方案。

如果指定将该选项和 --defaultResolutions 选项一起使用，则可应用任何保存的解决方案。如果冲突没有可用的保存解决方案，则将应用默认解决方案。

-m

--mapFile

否

存储包含映射信息的 XSL 文件的位置。例如，当两个参与者具有不同的可分辨名称时，映射文件可以指定源系统上的参与者应如何映射到目标系统上的同一参与者。

有关详细信息，请参阅映射业务管理更改属性。

-u

--user

否

运行命令的 Windchill 用户的用户名。运行命令的用户必须是一个具有组织管理员权限 (能访问所有的所需对象) 的有效 Windchill 用户，也可以是站点管理员。

-p

--password

否

运行命令的 Windchill 用户的密码。

-h

--help

否

使用此选项来为实用程序显示帮助文本。该帮助文本将列出每个选项和实用程序运行语法的完整说明。

要在 Windchill shell 中运行实用程序，请通过要执行的操作的表中列出的相应选项指定以下命令：windchill wt.scm.client.SCMCMD import

例如，要使用默认冲突解决方案导入一组管理变更并将冲突和解决方案写入日志文件，请使用以下命令：windchill wt.scm.client.SCMCMD import -u "<用户名>" -p "<密码>" -f "<ZIP 文件的文件路径>" -d -o "<输出目录的文件路径>"

Business Administrative Change 导入日志

无论导入操作是否成功，执行导入命令时均会生成导入日志文件。导入日志文件中包含的信息详细深入地介绍了整个导入事务处理。

导入日志中会显示下列信息：

• 日志文件标题：BAC 收到的交付 ID、包名称、包版本和源信息库

• 汇总

• 对象类型

• 标识

• 导入状况

• 搜索机制

• 冲突

如果导入失败，日志文件中将显示标题信息和导入失败的原因。

以下是导入日志报告的一个示例：