组装数据

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

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

功能描述

该步骤可将输入的数据组装为字符串或字节流。该步骤适用于自定义通信场景。

使用场景

该步骤适用于需要将多个数据源按照特定规则进行拼接或打包,尤其在自定义通信协议、数据传递或打包上传下游流程时使用。该步骤常用于数据采集、处理和通信接口之间,作为中间组装处理环节,可以与解析数据发送数据等步骤连接使用。

基本概念

  • 字符串组装

    将多个文本或数据端口内容通过特定分隔符拼接为一个字符串,常用于文本协议或消息体组装。

  • 字节流组装

    将输入数据按指定字节顺序打包为连续的二进制流,广泛应用于通信和低层数据交互场景。

  • 自定义输入端口

    指待组装步骤的数据输入接口,每个端口可配置名称、数据类型及位置等属性,用于灵活控制数据组装顺序和形式。

使用流程

该步骤的使用流程如下:

  1. 根据组装需求选择“组装方式”,即文本组装或字节组装。

  2. 配置输入端口:通过“自定义输入”相关参数添加需要组装的数据端口,并为每个端口指定端口名称数据类型

    • 若选择文本组装,进一步设置分隔符等文本规则。

    • 若选择字节组装,设置字节顺序起始位置字节长度等数据流组装规则。

  3. 确认配置后,运行步骤,输出组装后的数据。

输入说明

无固定输入项。该步骤通过“自定义输入”参数动态添加输入端口,用户可根据实际需求配置多个输入数据。

参数说明

参数 解释

组装方式

该参数用于指定数据的组装方式。

值列表:

  • 文本组装:将多个输入端口数据组装为字符串,数据间用分隔符分割,适用于文本协议。

  • 字节组装:将多个输入端口数据组装为字节流,适用于二进制通信协议。

默认值为文本组装。

推荐根据所需数据输出类型选择对应组装方式。例如通信协议需二进制打包时应选字节组装,文本拼接场景选择文本组装。

文本组装

参数 解释

分隔符

该参数用于在组装数据中分割多个输入端口数据。

值列表:

  • ,:用逗号分隔文本数据。

  • ;:用分号分隔文本数据。

  • _:用下划线分隔文本数据。

  • 空格:用空格分隔文本数据。

默认值为逗号(,)。

推荐根据实际应用场景选择分隔符。

自定义输入

该参数可以添加新的输入端口,用于配置数据组装规则。

建议根据组装对象的数量与类型添加端口,并合理命名以便后续处理和识别。

端口名称

该参数用于指定自定义输入端口名称。

建议根据业务实际情况,将端口名称设为可读性强、与数据含义相关的名称。

数据类型

该参数用于指定输入端口的数据类型。

值列表:

  • 字符串:输入端口为字符串类型。

  • 数值:输入端口为数字类型。

默认值为字符串。

建议根据实际输入数据类型选择,文本拼接场景优先选字符串类型。

字节组装

参数 解释

字节顺序

该参数用于指定多字节数据在字节流中的排列方式。

值列表:

  • ABCD(大端):数据高位在前,适用于大端字节序通信协议。

  • DCBA(小端):数据低位在前,适用于小端字节序通信协议。

  • CDAB:自定义顺序,适用于特殊通信场景。

  • BADC:自定义顺序,适用于特殊通信场景。

默认值为ABCD(大端)。

需根据下游通信设备或软件要求选择字节顺序,若不清楚可参考协议说明或咨询工程师。

自定义输入

该参数可以添加新的输入端口,用于配置数据组装规则。每个输入端口的数据将按照规则进行组装。

建议根据字节组装对象数量与内容进行添加,并仔细配置端口属性确保字节结构一致。

端口名称

该参数用于指定自定义输入端口名称。

建议根据数据含义设定端口名,便于识别和后续解析处理。

数据类型

该参数用于指定输入端口的数据类型。

值列表:

  • Float32:4字节浮点数。

  • Int16:2字节整数。

  • Int32:4字节整数。

  • Char8:1字节字符。

默认值为Char8。

根据实际需求选择数据类型,谨慎配置否则组装结果和解包解析可能出现偏差。

起始位置

该参数用于指定当前输入端口数据在字节流中的起始字节位置。起始位置字节长度共同确定数据在组装时占用的字节范围。

需确保起始位置和字节长度不重叠,且能覆盖整个字节流数据,建议提前规划字节结构。

字节长度

该参数用于指定当前数据字段在字节流中所占用的字节数。

建议根据数据类型自动匹配长度,手动修改时需确保数据不会越界或丢失。

输出说明

输出项 说明

组装的数据

将各输入端口数据按指定方式组装后形成的输出数据。

错误排查

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

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

该页面是否有帮助?

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

我们重视您的隐私

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