解析数据

您正在查看最新版本(V2.2.0)的文档。如果您想查阅其他版本的文档,可以点击页面右上角“切换版本”按钮进行切换。

■ 如果您不确定当前使用的产品是哪个版本,请随时联系梅卡曼德技术支持

功能描述

该步骤可解析输入的数据。

使用场景

该步骤主要用于对接收到的原始数据进行结构化解析,适用于定制通信系统、数据格式转换或协议解析。该步骤通常连接于“接收数据”步骤之后,也可与数据处理或结果显示步骤配合使用。

基本概念

  • 数据解析方式

    本步骤支持两种数据解析方式:

    • 文本解析:将输入的字符串按指定分隔符拆分为多个字段。适用于协议数据为可打印的字符串格式场景。例如外部设备发送的报文为 SN,001,98.5\n,可按逗号分隔符拆分为SN、001、98.5三个字段。

    • 字节解析:将输入的字节流按指定的起始位置和长度拆分为多个字段,按指定数据类型解析。适用于协议数据为二进制格式场景。例如收到字节流 0x12 0x34 0x56 0x78,可按大端顺序结合数据类型(如Int32)解析为十进制数值。

  • 端口与字段映射

    自定义输出端口可与数据字段进行一一映射,高效地进行结构化输出配置。

  • 字节顺序

    字节流解析时的顺序(大端、小端等)将影响数值与字段的实际含义和读取结果。

使用流程

该步骤的使用流程如下:

  1. 连接待解析数据输入端口,选择所需的输入数据。

  2. 设置解析方式,选择适用的解析方式(文本解析或字节解析)。

    • 若选择文本解析:设置分隔符,并配置自定义输出端口(端口名称数据类型)。

    • 若选择字节解析:设置字节顺序,并配置自定义输出端口(起始位置字节长度端口名称数据类型)。

  3. 根据实际需求调整各项参数,确保字段划分不重叠且类型设置正确。

  4. 执行运行步骤,查看解析结果输出于各指定端口。

输入说明

输入项 说明

待解析数据

输入该端口的数据将被解析为结构化字段。

参数说明

参数 解释

解析方式

该参数用于指定数据的解析方式。

值列表:

  • 文本解析:通过分隔符将输入的字符串数据拆分为多个字段,并按规则解析。当输入为字符串时适用。

  • 字节解析:将输入的字节流按字节顺序分段解析。当输入为字节流时适用。

请根据输入数据类型(字符串或字节流)选择合适的解析方式,以保证正确解析。

文本解析

参数 解释

分隔符

该参数用于指定用于切割字符串的分隔字符,数据将按此分隔符拆分为多个字段。 值列表:

  • ,:以逗号分隔各字段。

  • ;:以分号分隔各字段。

  • _:以下划线分隔各字段。

  • 空格:以空格分隔各字段。

默认值为逗号(,)。

根据实际数据内容选择与其匹配的分隔符,以确保字段正确解析。

自定义输出

该参数允许配置数据字段的解析规则,并为每个字段指定对应的输出端口名称。请按拆分后的字段顺序(字段1、字段2……)依次设置。

建议每个字段都设置明确的端口与数据类型,保证解析结构的一致性。

端口名称

为自定义输出端口指定名称,该名称将用作输出字段端口标识。

建议端口名称与字段内容意义相关,提高输出可读性。

数据类型

该参数指定当前字段的解析类型。

值列表:

  • 字符串:将字段解析为文本字符串。

  • 数值:将字段解析为数字类型。

默认值为字符串。

请根据解析字段内容合理选择类型,防止类型错误导致数据处理异常。

字节解析

参数 解释

字节顺序

该参数用于指定多字节数据在字节流中的排列方式。不同字节顺序会影响最终读出的数值。

值列表:

  • ABCD(大端):数据按从高字节到低字节排列。

  • DCBA(小端):数据按从低字节到高字节排列。

  • CDAB:按CDAB顺序排列字节。

  • BADC:按BADC顺序排列字节。

默认值为ABCD(大端)。

需按通信协议或数据源要求设置字节顺序,保证数据释义正确。

自定义输出

配置数据字段的解析规则,并为每个字段指定对应的输出端口名称。系统将根据起始位置字节长度确定读取范围,按指定类型解析后输出。字段的字节范围不得重叠。

建议严格按照字节流结构配置字段,避免重叠,确保解析正确。

端口名称

为自定义输出端口指定名称,该名称将用作输出字段端口标识。

建议端口名称与字节数据内容意义相关,提高输出可读性。

数据类型

指定当前字段的数据解析类型,适用于多种数值与字符解析。

值列表:

  • Float32:每4字节解析为一个32位浮点数。

  • Int16:每2字节解析为一个16位有符号整数。

  • Int32:每4字节解析为一个32位有符号整数。

  • Char8:每1字节解析为一个字符(ASCII)。

默认值为Char8。

根据实际需求、数据结构选择合适类型,防止溢出或数据错配。

起始位置

指定当前数据字段在字节流中的起始字节索引(从0开始)。

建议合理设置起始位置,按字节顺序逐字段配置,确保无重叠。

字节长度

指定当前数据字段所占用的字节数。起始位置字节长度共同确定读取范围。

建议协同起始位置与所需数据类型大小进行配置,避免溢出或字段解析不全。

输出说明

本步骤的输出内容需根据自定义端口和字段配置生成,具体输出结构化字段数据于各指定输出端口。

错误排查

  • 各步骤通用的错误码,详见错误码列表

  • 若错误码与错误信息不对应,请联系技术支持获取帮助。

该页面是否有帮助?

可以通过以下方式反馈意见:

我们重视您的隐私

我们使用 cookie 为您在我们的网站上提供最佳体验。继续使用该网站即表示您同意使用 cookie。如果您拒绝,将使用一个单独的 cookie 来确保您在访问本网站时不会被跟踪或记住。