层次导出

层次导出输出层次中的节点和属性。这些信息可以输出到文件或数据库表。此导出类型可用于创建层次节点的父子格式或基本列表。

要创建层次导出：

在主页上，选择导出。
单击。
选择层次作为导出类型。
可选：要创建导出的替代参数：
1. 单击。
2. 单击添加并添加键-值对。
  
  注：
  
  键-值对不能按顺序使用 "<%" 或 "%>"，也不能使用等于号。
3. 单击确定。
在源选项卡上，选择一个版本或版本变量。

可以选择标准、基线或截止版本。“版本”列表的默认设置为标准版本。要选择基线或截止版本，请单击“版本”列表下的标准。
从层次选择中，选择一个选项：
- 顶级节点 - 单击添加，选择一个层次，再选择一个节点，然后单击确定。重复此步骤，直至添加完所有节点。
  
  注：
  
  使用箭头重新确定节点的位置，这将确定层次节点的导出顺序。
- 层次组 - 选择一个层次组属性和一个层次组。
  
  注：
  
  您可以将替代变量用于此层次组属性和层次组。
  - 层次组属性 - 选择一个层次组属性或选择 [从参数中获取值]，然后选择要用于此属性的参数。
  - 层次组 - 选择一个层次组或选择 [从参数中获取值]，然后选择要用于此组的参数。
在样式选项卡中，从以下选项中选择：
- 节点选择 - 确定导出中包含哪些节点（全部节点、仅限枝节点、仅限叶节点）
- 从顶级节点递归 - 如果选择该选项，将包含顶级节点下的所有节点的输出。如果清除该选项，则仅包含顶级节点。导出每个选定层次的单个记录时，此选项很有用。
- 包含停用节点 - 如果选择该选项，将在导出中包含停用的节点。
- 包含隐式共享的节点 - 如果选择该选项，将包含显式共享的共享枝节点下的后代节点。只有在未使用其他选项进行筛选的情况下，才导出隐式共享的节点。
  - 如果在导出中使用查询筛选器，则管理员必须显式包含共享节点。例如，必须将筛选器 (#Children=0) 更改为 ((#Children=0 OR (Shared Node Flag = True))。
  - 对于隐式共享节点，父代属性反映实际节点（主节点）的值。例如，如果导出包含隐式共享节点的“父节点”属性，则会将父代显示为主节点。
- 基于键删除重复项 - 如果选择该选项，将使用主键（在“列选项”选项卡中定义）禁止导出重复的记录。
- 制表符缩进式输出 - 如果选择该选项，将使用制表符来缩进层次每个级别的节点以产生结构化输出格式。
在批量验证部分，选择要运行的验证类型。
注：

批量验证仅针对导出中包含的层次和节点执行。验证在导出前运行。如果发生错误，则导出停止。
- 无 - 不运行验证。
- 已分配 - 运行分配给导出的版本、层次和节点的所有验证。
- 选定 - 单击选择要运行的验证。
在重复参数部分，从以下选项中选择：
- 重复数字属性 - 指的是在导出结构中重复某个节点的本地节点级别整数属性。例如，给定一个 A-B-C 父子层次，如果节点 B 的“重复数字属性”值为 2，节点 A 和 C 的值为 1，则导出结构为 A,B,B,C（节点 B 重复两次）。
  
  注：
  
  使用“重复数字属性”时，对于要包含在导出结果中的节点，必须至少将值设置为 1。建议将“重复数字属性”默认值设置为 1。
- 最低级别属性和最低级别值 - 确定导出结构的最大深度。该值可以定义为层次级别的整数属性（“最低级别属性”）或绝对值（“最低级别值”）。
  
  如果定义了最低级别，则会启用重复选项，以自动在导出结构中向下重复节点，直到达到定义的级别。例如，对于父子层次中的节点 A-B-C，如果“最低级别值”定义为 6，节点 B 的“重复数字属性”值为 2，并且选择了“重复底层叶节点”选项，则导出结构为 A,B,B,C,C,C（导出结构的深度为 6 级，重复叶节点 C 直到达到 6 级，并且节点 B 重复两次）。
在筛选器选项卡中，从以下选项中选择：
- 从验证中，选择要用于筛选导出的验证。
- 从查询中，选择要应用于导出的查询，或者单击定义查询。
- 使用文本文件来包含/排除后代节点 - 如果使用要在导出中包含或排除的节点创建了文本文件，请选择此选项。文件格式是每行一个节点名称的节点名称列表。选择连接，输入文件名，并选择要在导出中包含还是排除这些节点。
在列选项卡中，选择要在导出结果中显示为列的属性，并将它们从可用移至已选中。

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

提示：

使用“类别”列表选择属性类别可简化导航。使用向上箭头和向下箭头可在“已选中”列表中定位列。列表中的第一项是第一列，列表中的第二项是第二列，依次类推。
在列选项选项卡中，从以下选项中选择：
- 透视 - 如果属性包含以逗号分隔的值列表，则针对每个值导出一条单独的记录，其他所有导出列都设置为相同的值。仅能在一列上选择“透视”选项。
- 跳过默认值 - 当字段值等于属性的默认值时，将空白（空字符串）或 NULL（在到数据库表的输出中）放在导出中
- 主键 - 将一个字段（或多个字段）定义为确定是否存在重复项时使用的主键。（这由“样式”选项卡上的“删除重复项”选项使用）。
- 动态值 - 如果添加了“动态列”，请在此处定义该列的值。该值可以是 Null，也可以是常量值和替代变量的组合。
在目标选项卡中，选择结果的输出类型：
- 客户端文件 – 通过浏览器下载结果。
- 服务器文件 – 使用外部连接并将结果保存到网络文件系统或 FTP 目录。
- 数据库表 – 将结果保存到数据库表。
执行一项操作：
- 如果选择导出到客户端文件，请选择选项：
  - 列标题 - 根据选定属性的标签在导出中包含列标题。
  - 带引号的字符串 - 使用引号将每个列值括起来。列值中的任何现有引号将变为双重引号。
    
    例如，
```
=IF("ABC","XYZ",)
```
    将更改为
```
"=IF(""ABC"",""XYZ"",)"
```
  - 固定宽度 - 允许您指定字段宽度、列的对齐方式（左对齐或右对齐）以及填充字符的数量。可以在“固定宽度选项”部分输入列信息。
  - 字符编码 - 选择一个编码选项。编码适用于输出文件和节点包括/排除文件（如果已指定）。
  - 替换选项 - 从列表中最多选择三个要替换的字符。将按指定的方式替换导出中的所有实例。例如，可以将所有逗号都替换为制表符。
  - 页眉/页脚 - 在页眉/页脚和正文之间添加一条线，或者输入要在导出结果的页眉和页脚中打印的文本。将文本行输入文本框中，或单击以打开文本编辑器。
    
    注：
    
    可以插入自定义标签以进一步增强导出结果的可读性。有关详细信息，请参阅“自定义标记”。
  - 分隔符选项 - 选择字段分隔符和记录分隔符。
- 如果选择导出到数据库表，则必须设置连接并选择数据库表。必须已为数据库创建了有效的外部连接，以便其显示在下拉列表中。还可以从以下选项选择：
  - “清除表”选项
    - 请不要清除表 - 附加到指定表中的现有数据。
    - 根据版本 ID 清除 - 删除指定键字段等于导出数据当前版本 ID 的表中的数据。如果选择此选项，则必须在“数据库列选项”部分指定键字段。运行导出时，将首先删除键字段等于导出数据当前版本 ID 的表中的所有数据。对于其他的“清除表”选项，将忽略键字段。
    - 清除所有行 - 在写入导出输出之前先删除表中的数据。
  - 使用事务 - 导出在数据库事务中执行，如果发生导出错误，允许回滚整个操作。
  - 使用快速附加 - 在目标数据库表中执行批量插入操作，以提高导出性能。仅适用于特定于数据库的连接。
  - 使用快速删除 –– 对目标数据库表执行批量删除操作，以提高性能。仅适用于特定于数据库的连接。
  - 数据库列选项 - 要导出的每一列都必须映射到外部数据库表中的一个字段。在“字段名称”下，选择某个字段的名称。如果选择了“根据版本 ID 清除”，请指定一个键字段。
    
    提示：
    
    “长度”选项可以保留为空，以便将各个字符串长度乃至数据库列声明发送到数据库。
    
    注：
    
    列必须与其映射到的数据库字段具有相同的数据类型。例如，如果将字符串属性映射到数字数据库字段，则会发生错误。
- 如果选择导出到服务器文件，必须设置连接并输入文件名。必须已为 UNC 或 FTP 文件设置有效的外部连接。还可以从以下选项选择：
  - 列标题 - 包含列标题
  - 带引号的字符串 - 使用引号将每个列值括起来。列值中的任何现有引号将变为双重引号。
    
    例如，
```
=IF("ABC","XYZ",)
```
    将更改为
```
"=IF(""ABC"",""XYZ"",)"
```
  - 固定宽度 - 允许您指定字段宽度、列的对齐方式（左对齐或右对齐）以及填充字符的数量。可以在“固定宽度选项”部分输入列信息。
  - 字符编码 - 选择一个编码选项。
  - 替换选项 - 从列表中最多选择三个要替换的字符。例如，可以将逗号替换为制表符
  - 页眉/页脚 - 在页眉/页脚和正文之间添加一条线，或者输入要在导出结果的页眉和页脚中打印的文本。将文本行输入文本框中，或单击以打开文本编辑器。
    
    注：
    
    可以插入自定义标签以进一步增强导出结果的可读性。有关详细信息，请参阅“自定义标记”。
  - 分隔符选项 - 选择字段分隔符和记录分隔符
执行以下任意操作：
- 要保存导出，请单击。
  
  将提示您定义导出的名称、说明和对象访问组。选择一个自定义组或以下项之一：
  - 用户 - 仅供单个用户查看和运行的个人对象。
  - 标准 - 公共对象，适用于所有用户进行查看和运行。只有数据管理员用户才能创建和修改标准导出。
  - 系统 - 仅供应用程序管理员角色的用户查看和运行的受限对象。
- 要验证导出，请单击。
- 要运行导出，请单击。
  
  如果在样式选项卡上选择了运行验证，单击将执行验证。然后，如果没有发生错误，将运行导出。如果发生验证错误，导出将停止并且将显示错误。单击可获得验证错误列表。