创建导入

导入向导用于定义导入的参数和条件。向导内容按“源”、“样式”、“筛选器”、“列”和“目标”选项卡组织,用于指导输入。尽管为了按一定顺序收集输入内容而对向导选项卡进行了排序,但是您可在任何选项卡之间导航。

要创建导入:

  1. 在主页上,选择导入
  2. 单击 “新建比较”工具栏按钮
  3. 可选:创建导入的替代参数,以便在运行时将用户定义的值传递到查询筛选器中。
    1. 单击 “添加参数”按钮
    2. 单击添加并添加键-值对。

      注:

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

    3. 单击确定
  4. 选项卡中,从设备列表中选择导入源。
    • 如果选择了客户端文件,请单击浏览,然后导航到并选择导入文件。

      注:

      客户端文件不随导入保存,需要在后续运行中重新选择。

    • 如果选择了服务器文件,请选择连接和文件名。

      注:

      服务器文件可以来自网络文件系统或 FTP 目录。

    • 如果选择了数据库,请执行以下操作:

      1. 连接中,选择数据库的外部连接。

      2. 单击 “测试连接”按钮 测试连接。

      3. 对于每个导入节,选择从其导入数据的数据库表或视图。

      4. 可选:选择处理后清除导入的记录在导入成功完成后清除从源连接加载的数据库记录。

        注:

        “处理后清除导入的记录”选项仅适用于源表,它不适用于控制用于筛选目的的表。

      5. 转至步骤 6。

  5. 从下列导入节选项中选择:
    • 前缀分隔符 - 显示在节标题开头的字符。

    • 后缀分隔符 - 显示在节标题末尾的字符。分隔符后缀是可选的。

    • 选择位于导入源中的节标题,并为节标题输入文本。

      注:

      默认情况下,将选择所有导入节。取消选择不在导入源中的节。

  6. 选择文件格式选项:
    • 字符编码 - 选择一个编码选项。

    • 去掉引号 - 如果选择此选项,将处理导入文件中带引号的字符串并在数据导入期间删除引号。

      注:

      单引号 (') 和双引号 (") 都会被删除。如果同时使用了两种类型的引号,则仅去掉外层的引号。

    • 固定宽度分隔符 - 对于“分隔符”,请输入分隔符。对于“固定宽度”,请在选项卡的“列选项”中输入固定宽度列值。

    • 对于客户端或服务器文件:跳过文件中的前几行 - 输入要从文件开头跳过的行数。

    • 对于客户端或服务器文件:文件中没有节标题 - 选择此项将只导入一个节。仅在选择了导入节时可用。在源文件不含节标题时选择。

  7. 选择样式选项卡,从这些部分中选择选项:
    • 节点选项

      • 在导入进程结束时确定叶节点 - 选择此选项将指定,在导入进程结束时,导入自动将没有子代的所有节点的叶属性设置为 True。

        注:

        此选项需要再次传递导入的数据,并且可能需要更多的时间进行处理。如果未选择此选项,所有节点都将导入为枝节点,除非已在导入数据的“节点”或“关系”节中将叶属性指定为列。

      • 验证节点名称是否包含无效字符 - 如果选择此选项,将根据 InvName 系统首选项验证节点名称。

    • 关系排序 - 将关系排序 - 选择此选项将允许导入根据节点在源文件的关系节或数据库表中的显示顺序来对节点进行排序,然后完成以下两个操作:

      • 要填充的排序属性 - 选择要在其中存储排序顺序的节点属性。

      • 要排序的层次 - 输入要应用排序的层次。使用逗号分隔层次或在单独的行中输入它们。

        注:

        除非在此处指定,否则默认情况下将对所有层次进行排序。

    • 层次选项 - 为所有在导入时创建的层次指定以下信息:

      • 要分配的节点类型属性 - 选择一个节点类型属性,此属性将分配给基于导入创建的每个层次的层次节点类型属性。

      • 要分配的验证 - 选择要分配给基于导入创建的层次的验证。

      • 重复分隔符 - 输入当在导入期间遇到重复项时,用于分隔基本层次名称和其唯一限定符名称的字符。

    • 域选项 - 通过选择一个选项指定如何在导入中限定域名:

      • - 不使用域名

      • 选择一个域 - 限定域中的所有节点

        注:

        如果选择此选项,请从下拉列表中选择一个域名。

      • 选择导入列 - 根据选择的列限定节点。请参阅步骤 9-11。

      注:

      限定节点名将附加指定域的限定符文本;并不将节点分配给域。

    • 重复处理

      • 将唯一的文本附加到节点名称的末尾 - 如果选择此选项,则将名称的唯一部分附加到原始节点名的末尾。

        注:

        如果选择此选项,请使用“唯一的字符串”、“分隔符”、“唯一的 ID 种子”和“零填充长度”参数创建重复节点的命名约定。名称的唯一部分将添加到原始节点名的末尾。如果未选择此选项,则会将名称的唯一部分放在开头作为前缀。例如 001NodeA、002NodeA。

      • 唯一的字符串 - 输入增加一部分以形成新唯一节点名称时要使用的字符串。

      • 分隔符 - 输入分隔原始节点名与名称的唯一部分时要使用的分隔符。

      • 唯一的 ID 种子 - 选择此 ID 的起点。

        例如,如果 NodeA 在层次中出现了三次,唯一的 ID 种子为 1,则原始节点不更改,其他节点名称将替换为 NodeA1 和 NodeA2。此示例忽略了其他重复设置,以便阐明唯一的 ID 种子的用法。

      • 零填充长度 - 输入重复名称的唯一 ID 部分中所需的最小位数。

        例如,零填充长度的值为 3 将创建名为 NodeA001、NodeA002 等重复节点。值为 2 将创建名为 NodeA01、NodeA02 等的重复节点。

      • 关联的属性 - 选择属性以允许将重复节点组合在一起,以便在导入完成后可以轻松地查询它们。

        如果设置了关联的属性,将使用所有重复节点中原始节点的节点名称填充该属性。此选项必须引用一个全局关联组 (AscGroup) 属性。

      • 重复错误模式 - 选择模式以确定导入处理器以哪种严重程度对待重复项:

        • 生成警告 - 针对每个重复项在日志中添加一条警告消息。

        • 生成错误 - 针对每个重复项在日志中添加一条错误消息。

          注:

          如果错误数超过“最大错误数”值(在“目标”选项卡上),处理将停止。

    • 孤立项选项 - 选择如何处理导入生成的孤立项。

      注:

      从孤立节点创建层次时,将使用两种类型的孤立项:

      不是任何其他孤立节点的子代并且没有子代的孤立项(残留孤立项)

      不是任何其他孤立节点的子代但具有子代的孤立项(顶级节点孤立项)

      • 创建基本孤立层次 - 选择此选项将创建一个孤立层次,并为该层次输入以下参数:

        • 名称 - 为孤立层次输入名称。

        • 说明 - 可选:输入孤立层次的说明

        • 顶级节点名称 - 为孤立层次的顶级节点输入名称。

        • 顶级节点说明 - 可选:为孤立层次的顶级节点输入说明。

      • 创建孤立分支层次 - 选择此选项将创建顶层节点孤立层次的孤立分支层次,并输入以下设置:

        • 要创建的最大数 - 输入要创建的最大孤立层次数。

        • 唯一名称前缀 - 可选:输入将附加到层次名称的前缀。

        • 父代的层次属性 - 输入一个有效的层次属性。选择一个层次级别属性;该属性将被“关系”导入节中“父代”字段的值(如果已定义)填充。此选项与“导入期间跳过节点”参数一起使用,从一个较大的层次创建多个层次。然后,导出可使用此属性输出这些层次的顶级节点的“父代”值。

  8. 选项卡的列表中,选择导入节。
  9. 选择列选项卡中,为导入选择要通过导入填充的属性,并将其从可用移至已选中

    注:

    使用“类别”列表选择属性类别可简化导航。

    系统提供了名为 [忽略列] 的特殊列,可用作输入源中导入期间不应处理的任何列的占位符。

    提示:

    对于客户端和服务器文件导入,可使用“已选中”列表右侧的箭头根据列在源文件中的顺序来放置列。列表中的第一项是第一列,列表中的第二项是第二列,依次类推。

  10. 列选项选项卡中,可以将列映射到层次。双击某个列名称行并从以下选项中选择:
    • 如果应该将列中的值应用于所有层次,请选择将值应用于所有层次。默认情况下已选中此选项。

    • 层次列表字段中,输入列将应用于的每个层次的名称。将仅在列表指定的层次中设置属性值。

      注:

      列出的层次必须与导入源中指定的层次名称匹配。

    • 如果在选项卡中选择了固定宽度,请在固定宽度列中输入值。

  11. 如果在第 7 步中选择了选择导入列域名限定方法,将显示域选项选项卡。可以配置以下部分:
    • 层次 - 顶级节点列

    • 节点 - 节点列

    • 关系 - 子代和父代列

    • 层次节点 - 节点列

  12. 如果是从数据库表导入,则会显示数据库选项选项卡。对于每个导入节,将显示以下列:
    • - 显示将填充的 Oracle Data Relationship Management 属性的名称。

    • 源字段 - 单击操作列中的 “编辑”按钮 可从源数据库表中为节选择一个字段。单击 “更新”按钮 保存更改。

      注:

      源字段可以映射到多个 Data Relationship Management 属性。

    • 字段类型 - 显示源数据库表中的字段的数据类型。

    • 长度 - 显示源数据库表中的字段的长度(如果适用)。

    • 排序 - 单击操作列中的 “编辑”按钮 并从源数据库表中选择用于在导入前对数据进行排序的字段。单击 “更新”按钮 保存更改。

  13. 筛选器选项卡上,执行以下任一项:
    • 跳过某些属性类型的空值

    • 跳过某些属性类型的默认值

    • 导入期间跳过节点 - 在导入过程中忽略这些节点。

    注:

    建议跳过空白字段并使用默认值以最大程度地减小导入版本的大小。

  14. 如果是从数据库表导入数据,则有以下数据库筛选器可用:
    • - 导入期间不筛选数据库记录。

    • 控制表 – 指定使用源数据库表控制筛选器。控制表中的记录将决定将从导入节表中导入哪些记录。

      1. 筛选表中,选择用于筛选的源数据库表。

      2. 筛选器键字段中,选择指定的筛选表中用于从导入表中筛选数据的字段。

      3. 筛选联接字段部分中,单击 “编辑”按钮 并为每个导入节表选择要用于筛选的字段。单击 “更新”按钮 保存更改。

    • 包含列表 - 指定用于从导入节表中筛选记录的文字值。

      1. 包含列表部分中,单击添加并为指定了“筛选联接字段”的所有导入节输入要用作表筛选器的文字值。

      2. 筛选联接字段部分中,单击 “编辑”按钮 并为每个导入节表选择要用于筛选的字段。单击 “更新”按钮 保存更改。

  15. 目标选项卡中,输入将由导入创建的新版本的名称。
  16. 从以下选项中选择:
    • 最大错误数 - 为处理期间可以发生的最大错误数选择一个值,超出此值后导入将停止。

    • 分配到变量 - 选择要向其分配导入的版本的版本变量。

    • 将版本保存到存储库 - 选择此选项会将新版本保存到存储库。

  17. 单击 “保存”按钮 保存导入。

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

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

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

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