导出变更命令
在源系统上做出变更后，可以预览和导出变更。可以使用 export 命令配合各种选项以预览对管理对象所做的变更，然后将这些变更导出到 ZIP 文件中。导出的 ZIP 文件使用以下命名约定进行命名：<包名称>_<目标名称>_<导出ID>.zip
|
选项
|
必需?
|
说明
|
|---|---|---|
|
-v
--previewOnly
|
预览：是
导出：否
|
提供 CSV 文件，其中列有准备从系统导出的对象的标识信息。使用该选项来验证预期的管理变更是否包含在导出数据中。
|
|
-t
--target
|
预览：否
导出：否
|
导出的 ZIP 文件将发送到的目标系统的名称。目标系统名称与 manageRepository 命令中指定的名称相同。
不强制在导出期间注册目标系统。
|
|
-n
--name
|
预览：是
导出：是
|
要针对同一目标系统执行多次导出时的推荐选项。
为保存 ZIP 文件输出而创建的包的名称。如果同一数据还需执行其他导出操作，则建议使用能够记住的名称来创建包。例如，将来可以对包使用 --refresh 选项，向同一目标系统创建增量导出。也可以将同一包发送到不同的目标系统。
|
|
-d
--description
|
预览：否
导出：否
|
该选项可以为针对保存 ZIP 文件输出而创建的包创建说明。包的说明会包含与导出到目标系统的数据类型相关的信息。
|
|
-s
--objectType
|
预览：是
导出：是
|
要导出的对象类型。以下对象类型可供导出：
• All：导出对所有支持的对象类型执行的添加和变更。
• PolicyAccessControlRule：导出新建、已更新和已删除的策略访问控制规则。导出到同步系统时，其中还将包含与已删除的策略访问控制规则相关的信息。
• Profile：导出新建、已更新和已删除的配置文件。导出到同步系统时，其中还将包含与已删除的配置文件相关的信息。
• OIR：导出新建、已更新和已删除的对象初始化规则。
• Preference：导出新建、已更新和已删除的首选项。
• LifeCycleTemplate：导出新建、已更新或迭代以及已删除的生命周期模板。
• WorkflowProcessTemplate：导出新建、已更新或迭代以及已删除的工作流进程模板。
• TypeDefinition：导出新建、已更新和已删除的属性模板。
• MeasurementSystem：导出新建、已更新和已删除的测量系统。
• QOM：导出新建、已更新和已删除的测量数量。
• GlobalEnumeration：导出新建、已更新和已删除的全局枚举、模型化枚举和自定义 UI 文本。
• ReusableAttribute：导出新建、已更新或迭代以及已删除的可重用属性。
• DocumentTemplate：导出新建、已更新和已删除的文档模板。
• ReportTemplate：导出新建、已更新或迭代以及已删除的报告模板。
• Report：导出新建、已更新和已删除的报告。
• RuleSets：导出新建和已删除的规则集对象 (规则、规则集和规则集链接)。
• TableView：导出新建、已更新和已删除的报告共享表格视图及系统表格视图。
• specfile.xml：上传 XML 文件，该文件用于指定要收集以进行导出的对象。仅当将 wt.properties 中的 com.ptc.windchill.bac.features.enabled 属性设置为 2666518 时，此选项才可用。如果未进行此配置，则在尝试上传规范文件时将被拒绝，并会显示一条错误消息。此选项可用于选择性模式、同步模式和开发模式。
在同步模式下使用此选项时，只能导出对象类型的某一特定列表。同步模式系统的 XML 规范文件中不支持容器、域或属性。有关规范文件的详细信息，请参阅创建规范 XML 文件。
有关支持的对象类型的详细信息，请参阅Business Administrative Change 升级所支持的对象。
|
|
-o
--outputdir
|
预览：否
导出：否
|
生成及保存预览文件或导出的 ZIP 文件所在位置的文件路径。如果未指定此选项，则文件将被保存到执行命令的目录中。
|
|
-b
--modificationBeginTime
|
预览：否
导出：否
|
导出到选择性系统时的必需选项。还可以为 --previewOnly 选项指定此选项，以显示某个时间段内的变更。
导出变更的起始时间 (应在该时间之后执行导出)。起始时间应该指定为以下 24 小时日期/时间格式：MM/dd/yyyy HH:mm:ss
|
|
-e
--modificationEndTime
|
预览：否
导出：否
|
导出到选择性系统时的必需选项。还可以为 --previewOnly 选项指定此选项，以显示某个时间段内的变更。
导出变更的结束时间 (应在该时间之前执行导出)。结束时间应该指定为以下 24 小时日期/时间格式：MM/dd/yyyy HH:mm:ss
|
|
-r
--refresh
|
预览：否
导出：否
|
如果采用 -name 参数指定现有包，则使用该选项。
刷新 ZIP 文件内容以包含自上次导出同一信息以来的增量更新。
如果提供了 -r 或 --refresh，则 -s 或 --objectType 将被忽略。在命令中指定 -s 或 -r 选项。
|
|
-x
--excludeBaseline
|
预览：否
导出：否
|
将信息发送到目标系统时，此选项将排除基线。这仅对开发模式有效。默认情况下，系统将为开发模式建立基线。
|
|
-u
--user
|
预览：否
导出：否
|
运行命令的 Windchill 用户的用户名。运行命令的用户必须是一个具有组织管理员权限 (能访问所有的所需对象) 的有效 Windchill 用户，也可以是站点管理员。
|
|
-p
--password
|
预览：否
导出：否
|
运行命令的 Windchill 用户的密码。
|
|
-h
--help
|
否
|
使用此选项来为实用程序显示帮助文本。该帮助文本将列出每个选项和实用程序运行语法的完整说明。
|
要在 Windchill shell 中运行实用程序，请通过要执行的操作的表中列出的相应选项指定以下命令：windchill wt.scm.client.SCMCMD export
预览变更
要预览对诸如配置文件等管理对象的变更，请使用以下命令：windchill wt.scm.client.SCMCMD export -v -o "<文件路径>" -n "<包名称>" -s "Profile" -u “<用户名>” -p “<密码>” -t “<目标名称>”
所得预览文件包含以下信息：
• 报告页眉：包名称、包说明、上下文以及包的创建时间
• 对象类型
• 对象标识
• 对象说明
• 操作类型：创建、修改、删除
以下是导出预览报告示例：
导出变更
要将配置文件的所有新建、已更新和已删除记录导出到选择性系统，请使用以下命令：windchill wt.scm.client.SCMCMD export -u "<用户名>" -p "<密码>" -t "<目标名称>" -s "Profile" -b "<开始时间>" -e "<结束时间>" -n "<包名称>" -d "<说明>" -o "<文件路径>"
ZIP 文件包含带有对象信息的文件夹和列出了以下信息的 report.html 文件：
• 包标识 - 编号、名称、说明以及创建日期和时间
• 导出的对象信息 - 对象类型、对象标识、说明和操作类型