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