反馈已提交

网络繁忙

XML解析算子

  • 文档创建者:Roxy
  • 历史版本:20
  • 最近更新:Wendy123456 于 2023-06-07
  • 1. 概述

    1.1 版本

    FineDataLink 版本功能变动
    4.0.9

    新增「XML解析」算子,可以将输入的 XML 数据解析为行列形式的数据

    1.2 应用场景

    对于 API、WebService、OData 接口中响应数据返回的 XML 格式数据、来自 XML 文件的数据,用户想要将其解析为行列格式数据,以供后续加工存储。

    1.3 功能简介

    FineDataLink 支持在「数据转换」中使用「XML解析」算子将 XML 格式数据解析为行列格式数据,以供后续加工存储。

    11.png

    2. 功能说明

    「XML解析」算子配置界面如下图所示:

    3.png

    2.1 选择源字段

    下拉列表内容为所有前置字段名。

    上游节点为 API 输入且数据未展开为二维表时,源字段默认为 default。

    解析后保留所有上游输出字段:勾选后,将所有上游输出字段与解析产生的新字段合并输出。

    2.2 命名空间

    若 XML 中带有命名空间,需要指定命名空间才能正确读取到节点。

    勾选「指定命名空间」后,展示命名空间列表;允许新增和删除命名空间。

    字段名
    说明
    命名空间前缀可编辑;不允许重名;对于实际 XML 中命名前缀相同的情况,请正确填写 URI ,并将前缀命名成不同的两个值,这样程序可正常解析
    命名空间URL可编辑;允许重复

    当 XML 中存在默认命名空间时,需要手动写一个自定义的命名空间前缀,填入「命名空间URL」后,才能正常解析。

    示例:xlms:"http://111111",没有「命名空间前缀」,需要自定义一个「命名空间前缀」,「命名空间URL」填写http://111111,才能正常解析。

    2.3 解析 XML 数据

    2.3.1 选择 XML 节点

    点击「选择XML节点」按钮后,弹出XML节点选择框。

    1685417946392779.png


    XML 示例
    多选树内容
    6.png

    末端节点定义:没有子节点

    所以黄色字段为末端节点,剩下的字段为非末端节点

    1685418094200362.png

    非末端节点不允许被选中

    勾选多个同名不同父的节点时,选择生成的输出字段名称后补1

    比如选择上例中/bookstore/store/title/bookstore/book/title,此时选择后输出字段的「解析后字段名称」为 title 和 title1,XPath 路径为各自有效路径

    2.3.2 输出字段

    列表项允许新增,允许删除。

    经过 XML 解析产生的字段类型统一为字符串(从上游带来的字段类型不变)。

    字段名
    说明
    解析后字段名称可编辑;配置解析后的字段名称

    注1:字段名称不允许重名

    注2:不允许引用参数

    XPath 路径可编辑;展示&配置解析后字段的 XPath 路径表达式

    不允许引用参数

    允许手写 XPath 路径

    手写 XPath 支持的类型:「选取节点」类和「谓语」类

    例如 XML 文档如下:

    <?xml version="1.0" encoding="ISO-8859-1"?>

    <bookstore>

    <book>
      <title lang="eng">Harry Potter</title>
      <price>29.99</price>
    </book>

    <book>
      <title lang="eng">Learning XML</title>
      <price>39.95</price>
    </book>

    </bookstore>

    选取节点

    XPath 使用路径表达式在 XML 文档中选取节点。节点是通过沿着路径或者 step 来选取的。

    在下面的表格中,我们已列出了一些路径表达式以及表达式的结果:

    路径表达式结果
    bookstore选取 bookstore 元素的所有子节点。
    /bookstore

    选取根元素 bookstore。

    注:假如路径起始于正斜杠( / ),则此路径始终代表到某元素的绝对路径。

    bookstore/book选取属于 bookstore 的子元素的所有 book 元素。
    //book选取所有 book 子元素,而不管它们在文档中的位置。
    bookstore//book选择属于 bookstore 元素的后代的所有 book 元素,而不管它们位于 bookstore 之下的什么位置。
    //@lang选取名为 lang 的所有属性。

    谓语

    谓语用来查找某个特定的节点或者包含某个指定的值的节点。

    谓语被嵌在方括号中。

    在下面的表格中,我们列出了带有谓语的一些路径表达式,以及表达式的结果:

    路径表达式结果
    /bookstore/book[1]选取属于 bookstore 子元素的第一个 book 元素
    /bookstore/book[last()]选取属于 bookstore 子元素的最后一个 book 元素
    /bookstore/book[last()-1]选取属于 bookstore 子元素的倒数第二个 book 元素
    /bookstore/book[position()<3]选取最前面的两个属于 bookstore 元素的子元素的 book 元素
    //title[@lang]选取所有拥有名为 lang 的属性的 title 元素
    //title[@lang='eng']选取所有 title 元素,且这些元素拥有值为 eng 的 lang 属性
    /bookstore/book[price>35.00]选取 bookstore 元素的所有 book 元素,且其中的 price 元素的值须大于 35.00
    /bookstore/book[price>35.00]/title选取 bookstore 元素中的 book 元素的所有 title 元素,且其中的 price 元素的值须大于 35.00

    3. 特殊场景处理策略

    场景
    处理策略

    源XML数据存在多个根元素,举例:

    1685427389170899.png

    点击「选择XML节点」时报错:XML数据根节点缺失

    自行写XPath,预览及运行时报错:XML数据根节点缺失

    配置的XPath不正确解析出的字段内容为空

    配置的XPath非法

    或者

    命名空间前缀中填写了非英文字母的字符

    抛出解析异常

    命名空间前缀重复

    9.png

    命名空间前缀不可重复

    此例中,将两个 s 中的一个重命名为其他名称,并正常填写对应 URI ,通过树选的形式可正常解析

    如果是手填路径,需要按照重命名后的命名空间前缀书写路径

    源XML数据不完整,举例:

    1685427733248711.png

    点击选择XML节点时报错:XML数据格式不完整

    自行写XPath,预览及运行时报错:XML数据格式不完整

    4. 示例

    「XML解析」算子使用示例请参见:XML解析示例



    附件列表


    主题: 数据开发
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持