导出项目树
您可以全部或部分导出 项目树。导出的文件包括组件 ID 及其状态等关键详细信息。
除了选择导出格式外,您还可以配置其他导出设置,包括:
- 是导出整个 项目树、其特定部分,还是导出单个组件。
- 是否包含版本信息,如果包含,是只导出最新版本还是导出所有版本。
- 是否包含组件的主数据。
- 是否将项目目录结构表示为 XML 节点。
如果导出完整的 项目树,包含所有版本信息 (WithVersions=Y),或选择 JSON 作为导出格式,导出的数据量可能会非常大。如果是这种情况,建议只导出 项目树 的特定路径而不导出版本信息,或者选择导出为 XML 文件。
ExportModule 的设置
除了 参数文件 页面所述的键值外,参数文件还可以包含以下专门用于此导出的键值。
Common 节
在 [Common] 节,可以配置以下键值:
键 | 描述 | 值 |
---|---|---|
Dir | 要导出的 项目树 部分的相对路径。如果为 ComponentID 指定了值,则此键将被忽略。 | 如果该键为空(默认值),整个 项目树 将被导出(执行用户无法访问的目录和组件除外。) |
- 如果键不为空,则条目前必须有一个反斜杠 ("\")。 | ||
- 也可以输入一个组件的路径(带名称)。 | ||
WithVersions | 决定是否输出版本信息。 | - Y:信息已输出。 - N:不输出信息(默认值)。 |
OnlyLatestVersion | 决定是只输出最新版本的信息,还是输出所有版本的信息。前提条件是 WithVersions 参数的值为 Y。 | - Y:只输出最后一个版本的信息。 - N:输出所有信息(默认值) |
WithMasterData | 确定是否要输出主数据信息。 | - Y:输出信息(默认值)。 - N:不输出信息。 |
EnableNodeTree | 决定是否将项目目录层次结构创建为 XML 节点。 | - Y:XML 节点已创建。 - N:未创建 XML 节点(默认值) |
调用示例
参数文件 exportComponentTree.ini
[Common]
ReportType=ComponentTree
ExportFile=D:\Test\myComponentTree.xml
WithVersions=N
WithMasterData=Y
EnableNodeTree=N
[User]
Account={User}
Password={Password}
输出文件
根据所选的输出选项,导出结果可以 XML 或 JSON 格式生成。
XML 输出文件包含以下元素:
根:
<root>
元素是 项目树 的起点。
节点:
<note>
元素表示 项目树 中的一个目录。只有在项目目录层次结构作为 XML 节点创建时,才会输出该元素。
属性 | 描述 |
---|---|
Name="..." | 目录名称 |
组件:
<组件>
元素包含有关组件的信息。
属性 | 描述 |
---|---|
Name="..." | 组件的名称 |
Path="..." | 组件工作目录的相对路径 |
Id="..." | 唯一组件 ID(GUID 格式) |
TypeId="..." | 组件的组件类型 ID(GUID 格式) |
State="n" | 组件的状态信息。 如果将数值视为 32 位二进制数,则可读出以下信息: 0x00000010:对其他用户锁定 0x00000020:标记为 进行中 |
MultiEdit="..." | 指定组件是否具有 多用户编辑 属性。可能的值为 Y 和 N。 |
数据:
<data>
元素包含组件主数据的列表。
只有导出主数据时才会输出该元素。
属性 | 描述 |
---|---|
D1="..." D2="..." ... D10="..." | 组件主数据 |
版本:
<Versions>
元素包含组件的版本信息。
只有在版本信息已被导出的情况下,才会输出该元素。
版本:
<Versions>
元素包含以下属性:
属性 | 描述 |
---|---|
Id="..." | 数据记录的版本 ID |
Number="n" | 数据记录的版本号 |
TimeStampUTC="..." | 版本控制时间(UTC) |
TimeStampLocal="..." | 版本控制时间(本地时间) |
UserDefined="..." | 用户定义的版本标识符 |
UserId="..." | 创建版本控制的用户的唯一 ID(GUID 格式) |
UserName="..." | 创建版本的用户 |
ComputerName="..." | 创建版本的计算机 |
Comments="..." | 评论 |
ChangeReason="..." | 变更原因 |
SubDirArchive="..." | 服务器存档中存储相应版本组件(如 Archive.zip 文件)的文件夹名称 |
StateArchive="n" | 关于该版本的额外信息。 如果该值被视为 32 位二进制数,可以读取以下信息: 0x00000002:存档已签出。 0x00000020:存档已签入。 0x00000040:存档已(由指定用户)删除。 |
SizeUncompressed | 组件的大小 |
SizeCompressed | 组件的压缩尺寸 |
标签:
<Tag>
元素包含分配给每个版本的标签信息。
该元素只有在至少分配了一个标签时才会输出。
标签:
<Tag>
元素包含标签内容的信息。
属性 | 描述 |
---|---|
Name="..." | 标签名称 |
LockState:
<LockState>
元素包含组件的锁定状态信息。
只有当至少有一个组件处于锁定状态时,输出中才会包含该元素。
属性 | 描述 |
---|---|
State="n" | 指定组件的锁定状态。 可能的值如下:1:锁定,2:进行中 |
UserId="..." | 分配锁定状态的用户 ID(GUID 格式) |
UserName="..." | 被分配了块状态的用户 |
EmailAddress="..." | 分配锁定状态用户的电子邮件地址。 如果未指定电子邮件地址,则添加空字符串。 |
TimeStampLocal="..." | 分配锁定状态的时间(本地时间) |
TimeStampUTC="..." | 分配锁定状态的时间(UTC) |
Days="n" | 指定组件被阻止的时间(天数)。 |
ComputerName="..." | 分配锁定状态的计算机 |
Comments="..." | 锁定时输入的评论 |
相关主题