版本导出

版本导出针对整个版本的每个节点及其属性输出一条记录。这些信息可以输出到文件或数据库表。

提示:

要在导出到数据库表时将导出顺序保留下来,可以在输出中添加记录 ID 列。此列提供自动生成的数字值,数字值从 1 开始,并且针对导出中的每一行按顺序递增。

注:

层次关系和本地属性不可用于此导出类型。

要创建版本导出:

  1. 在主页上,选择导出
  2. 单击 “新建比较”工具栏按钮
  3. 选择版本作为导出类型。
  4. 可选:要创建导出的替代参数:
    1. 单击 “添加参数”按钮
    2. 单击添加并添加键-值对。

      注:

      键-值对不能按顺序使用 "<%" 或 "%>",也不能使用等于号。

    3. 单击确定
  5. 选项卡上,选择一个版本或版本变量。

    可以选择标准、基线或截止版本。“版本”列表的默认设置为标准版本。要选择基线或截止版本,请单击“版本”列表下的标准

  6. 样式选项卡中,从以下选项中选择:
    • 节点选择 - 确定导出中包含哪些节点类型(全部节点、仅限枝节点、仅限叶节点)

    • 包含隐式共享的节点 - 如果选择该选项,将包含显式共享的共享枝节点下的后代节点。只有在未使用其他选项(如顶级节点选择或查询筛选器)进行筛选的情况下,才导出隐式共享的节点。共享父节点下的隐式共享节点结构反映在层次导出的祖先节中。

      • 如果在导出中使用查询筛选器,则管理员必须显式包含共享节点。例如,必须将筛选器 (#Children=0) 更改为 ((#Children=0 OR (Shared Node Flag = True))。

      • 对于隐式共享节点,父代属性反映实际节点(主节点)的值。例如,如果导出包含隐式共享节点的“父节点”属性,则会将父代显示为主节点。

  7. 批量验证部分,选择要运行的验证类型。

    注:

    针对导出中指定的整个版本执行批量验证。验证在导出前运行。如果发生错误,则导出停止。

    • - 不运行验证。

    • 已分配 - 运行已分配的所有验证。

    • 选定 - 单击 省略号图标 选择要运行的验证。

    注:

    验证针对整个版本执行。

  8. 筛选器选项卡中,选择选择:
    • 验证中,选择要应用到导出的验证。

    • 查询中,选择要应用于导出的查询,或者单击 “新建查询”按钮 定义查询。

      注:

      包含筛选器确定每个层次中将比较的节点集。

  9. 选项卡中,选择要在导出结果中显示为列的属性,并将它们从可用移至已选中

    有关详细信息,请参阅“特定于导出的列

    提示:

    使用“类别”列表选择属性类别可简化导航。使用向上箭头和向下箭头可在“已选中”列表中定位列。列表中的第一项是第一列,列表中的第二项是第二列,依次类推。

  10. 目标选项卡中,选择结果的输出类型:
    • 客户端文件 – 通过浏览器下载结果。

    • 服务器文件 – 使用外部连接并将结果保存到网络文件系统或 FTP 目录。

    • 数据库表 – 将结果保存到数据库表。

  11. 执行一项操作:
    • 如果选择导出到客户端文件,请选择选项:

      • 列标题 - 在导出中包含列标题

      • 带引号的字符串 - 使用引号将每个列值括起来。列值中的任何现有引号将变为双重引号。

        例如,

        =IF("ABC","XYZ",)

        将更改为

        "=IF(""ABC"",""XYZ"",)"
      • 固定宽度 - 允许您指定字段宽度、列的对齐方式(左对齐或右对齐)以及填充字符的数量。可以在“固定宽度选项”部分输入列信息。

      • 字符编码 - 选择一个编码选项。

      • 替换选项 - 从列表中最多选择三个要替换的字符。例如,可以将逗号替换为制表符

      • 页眉/页脚 - 在页眉/页脚和正文之间添加一条线,或者输入要在导出结果的页眉和页脚中打印的文本。将文本行输入文本框中,或单击 省略号按钮 以打开文本编辑器。

        注:

        可以插入自定义标签以进一步增强导出结果的可读性。有关详细信息,请参阅“自定义标记”。

      • 分隔符选项 - 选择字段分隔符和记录分隔符

    • 如果选择导出到数据库表,则必须设置连接并选择数据库表。必须已为数据库创建了有效的外部连接,以便其显示在下拉列表中。还可以从以下选项选择:

      • 清除表选项

        • 请不要清除表 - 附加到指定表中的现有数据。

        • 根据版本 ID 清除 - 删除指定键字段等于导出数据当前版本 ID 的表中的数据。如果选择此选项,则必须在“数据库列选项”部分指定键字段。运行导出时,将首先删除键字段等于导出数据当前版本 ID 的表中的所有数据。对于其他的“清除表”选项,将忽略键字段。

        • 清除所有行 - 在写入导出输出之前先删除表中的数据。

      • 使用事务 - 导出在数据库事务中执行,如果发生导出错误,允许回滚整个操作。

      • 使用快速附加 - 在目标数据库表中执行批量插入操作,以提高导出性能。仅适用于特定于数据库的连接。

      • 使用快速删除 –– 对目标数据库表执行批量删除操作,以提高性能。仅适用于特定于数据库的连接。

      • 数据库列选项 - 要导出的每一列都必须映射到外部数据库表中的一个字段。在“字段名称”下,选择某个字段的名称。如果选择了“根据版本 ID 清除”,请指定一个键字段。

        提示:

        “长度”选项可以保留为空,以便将各个字符串长度乃至数据库列声明发送到数据库。

        注:

        列必须与其映射到的数据库字段具有相同的数据类型。例如,如果将字符串属性映射到数字数据库字段,则会发生错误。

    • 如果选择导出到服务器文件,必须设置连接并输入文件名。必须已为 UNC 或 FTP 文件设置有效的外部连接。还可以从以下选项选择:

      • 列标题 - 包含列标题

      • 带引号的字符串 - 使用引号将每个列值括起来。列值中的任何现有引号将变为双重引号。

        例如,

        =IF("ABC","XYZ",)

        将更改为

        "=IF(""ABC"",""XYZ"",)"
      • 固定宽度 - 允许您指定字段宽度、列的对齐方式(左对齐或右对齐)以及填充字符的数量。可以在“固定宽度选项”部分输入列信息。

      • 字符编码 - 选择一个编码选项。

      • 替换选项 - 从列表中最多选择三个要替换的字符。例如,可以将逗号替换为制表符

      • 页眉/页脚 - 在页眉/页脚和正文之间添加一条线,或者输入要在导出结果的页眉和页脚中打印的文本。将文本行输入文本框中,或单击 省略号按钮 以打开文本编辑器。

        注:

        可以插入自定义标签以进一步增强导出结果的可读性。有关详细信息,请参阅“自定义标记”。

      • 分隔符选项 - 选择字段分隔符和记录分隔符

  12. 执行以下任意操作:
    • 要保存导出,请单击 “保存”按钮

      将提示您定义导出的名称、说明和对象访问组。选择一个自定义组或以下项之一:

      • 用户 - 个人对象,仅适用于单个用户进行查看和运行。

      • 标准 - 公共对象,适用于所有用户进行查看和运行。只有数据管理员用户才能创建和修改标准导出。

      • 系统 - 受限对象,仅适用于应用程序管理员角色的用户进行查看和运行。

    • 要验证导出,请单击 “验证”按钮

      可以将验证错误复制到剪贴板。

    • 要运行导出,请单击 “运行”按钮

      如果在样式选项卡上选择了运行验证,单击 “运行”按钮 将执行验证。如果没有发生错误,将运行导出。如果发生验证错误,导出将停止并且将显示错误。单击 “验证”按钮 可获得验证错误列表。