解码 JSON

Decode JSON(解码 JSON)动作将解析 JSON 字符串,并填充已标识的变量。

解码 JSON 动作是技术预览扩展的一部分

此动作是技术预览扩展(又称沙盒软件包)的一部分。有关获取和安装扩展的信息,请参见技术预览扩展

参数描述

参数 描述
JSON Template(JSON 模板) 要解码的变量的 JSON 描述。如示例所示,各变量指定方式如下:
  • Map variable name(映射变量名称)- 映射变量的名称,将在 Output(输出)选项卡上添加为一行。
  • Sample Value(示例值)- 此映射变量最有可能包含的值。将计算此值以确定变量的数据类型。此值可以包含值数组,通过将值括在 { } 字符内来表示。此值也可以是结构,通过将值括在 [ ] 字符内来表示。
    多行输入图标 可用于显示 JSON 变量描述的较大输入区域。
Maximum String Size(最大字符串大小) 在选择 Use Advanced Properties(使用高级属性)复选框时显示。
默认的最大字符串大小为 256,用于 Output(输出)选项卡上数据类型为字符串的所有变量。通过输入介于 10 和 1024 之间的值,可以修改最大字符串大小。
Structure Delimiter Character(结构分隔符字符) 在选择 Use Advanced Properties(使用高级属性)复选框时显示。
JSON 结构中的每个成员都必须在运行时表示为唯一变量。将创建唯一名称来标识结构中的每个成员。该名称由结构名称组成,后接分隔符,再后接成员名称。在结构名称和结构中的变量之间用于分隔的默认字符为 # 字符。此参数可用于将此值更改为另一个字符。

输入选项卡

参数 描述
JSON Input(JSON 输入) 执行触发器动作时,JSON 字符串的源。可以是变量,也可以是常量字符串。

输出选项卡

参数 描述
Output variables(输出变量) JSON Template(JSON 模板)识别出的每个输出变量将添加为一行,从而可将已解析的成员分配给变量。
resultStatus INT4 变量,其中将包含此动作的完成状况。值为零表示 JSON Input(JSON 输入)值已成功解析,并与 JSON Template(JSON 模板)参数中识别出的模板匹配。非零值表示动作未成功。
resultMessage 由 64 个字符组成的字符串变量,当 resultStatus 状态不为零时,将提供更多信息。

示例

以下为 JSON 模板示例。其中包含多种数据类型,并包括一个名为 INSTALLED_PART 的结构的数组。该数组包含两个元素,成员名为 partName、partSerialNumber、partStatus 和 timestamp。

以下为示例 JSON 模板对应的示例 Output(输出)选项卡。Maximum String Size(最大字符串大小)使用的默认值为 256。# 字符用于分隔结构名称和结构成员名称。