使用 JSON 函数

FileMaker Pro 提供若干个文本函数，您的解决方案可通过这些函数从其他源解析和修改 JSON 数据，如通过 REST API 传输 JSON 格式数据的 Web 服务。

使用从 URL 插入脚本步骤访问 Web 服务，指定要检索的信息的参数，发送和接收 HTTP 标头，并在变量或字段中存储结果。

例如，一家面包店通过 REST API 采用 JSON 格式使其产品列表可用于客户。以下脚本将当日特价列表作为 $$JSON 变量中的 JSON 数据返回：

设置变量 [ $url ; "https://<面包店域名>/rest/api/products" ]

从 URL 插入 [ 验证 SSL 证书 ; 包括对话框: 关闭; $$JSON ;
$url ; "--data list=特价" ]

JSON 数据不需要元素之间有空格或行结束符。但是，为了使数据在您调试问题时更易读，请使用 JSONFormatElements 函数，该函数会添加制表符和行结束符，如JSON 数据示例中所示。

键或索引或路径参数	含义
"."	（可选）如果是第一个字符，则为根级别
".[n]"	根级别数组的索引 n 处的元素
".name"	位于根级别的名为 name 的对象的关键字
".nameA.nameB.nameC"	名为 nameC 的对象，其为 nameB 和 nameA 的后代
".[3][2][1]nameA[0]"	nameA 对象中数组的第一个元素，其在一组嵌套数组中位于第三个级别

以下示例脚本使用 JSONListKey 确定JSON 数据示例中的产品数（存储在 $$JSON 变量中），为每个产品创建一条记录，然后将每个记录中的字段设置为使用 JSONGetElement 为每个产品获取的值。

设置变量 [ $产品数量 ; 值:
   ValueCount (
      JSONListKeys ( $$JSON ; "面包店.产品" )
   ) ]
设置变量 [ $i; 值: 0 ]
If [ $产品数量 > 0 ]
   Loop
      新建记录/请求
      设置字段 [ 产品::ID ;
         JSONGetElement ( $$JSON ; "面包店.产品[" & $i & "]id" ) ]
      设置字段 [ 产品::价格 ;
         JSONGetElement ( $$JSON ; "面包店.产品[" & $i & "]价格" ) ]
      设置字段 [ 产品::现货 ;
         JSONGetElement ( $$JSON ; "面包店.产品[" & $i & "]现货" ) ]
      提交记录/请求 [ 包括对话框: 关闭 ]
      设置变量 [ $i ; 值: $i + 1 ]
      Exit Loop If [ $i ≥ $产品数量 ]
   End Loop
End If

要在 JSON 数据中更改值并添加元素，请使用 JSONSetElement 函数。json 和键或索引或路径参数在此函数中像解析 JSON 数据所描述的那样运行。如果键或索引或路径指定现有元素，则该元素的值将被更改；如果元素不存在，会添加一个新元素。

JSONSetElement 将指定的元素设置为值参数。您可以指定从简单字符串或数字到复杂对象或数组的任何有效的 JSON 值。

类型参数指定值中的数据类型，以使 JSON 分析器在处理每种数据类型时都将遵循限制规则。有关支持的数据类型，请参阅 JSONSetElement 函数。要将 JSON 数据插入到 json 中，您可以将类型设置为 JSONRaw，以使 JSON 分析器确定值的数据类型。

下面的示例将新产品的键值对添加到空的 JSON 对象中。然后，新对象添加到 $$JSON 变量中产品数组的末尾（请参阅 JSON 数据示例）。

设置变量 [ $新产品 ; 值:
   JSONSetElement ( "{}" ;
      [ "id" ; "FB4" ; JSONString ] ;
      [ "名称" ; "香草蛋糕" ; JSONString ] ;
      [ "价格" ; 17.5 ; JSONNumber ] ;
      [ "现货" ; 12 ; JSONNumber ] ;
      [ "类别" ; "蛋糕" ; JSONString ] ;
      [ "特价" ; true ; JSONBoolean ]
   ) ]
设置变量 [ $NextIndex ; 值:
   ValueCount (
      JSONListKeys ( $$JSON ; "面包店.产品" )
   ) ]
设置变量 [ $$JSON ; 值:
   JSONSetElement (
      $$JSON ; "面包店.产品[" & $NextIndex & "]" ; $新产品 ;
      JSONObject
   ) ]

要删除元素，请使用 JSONDeleteElement 函数。json 和键或索引或路径参数在此函数中像解析 JSON 数据所描述的那样运行。键或索引或路径参数必须指定 json 中的现有元素。

设置变量 [ $产品数量 ; 值:
   ValueCount (
      JSONListKeys ( $$JSON ; "面包店.产品" )
   ) ]
设置变量 [ $i ; 值: 0 ]
If [ $产品数量 > 0 ]
   Loop
      设置变量 [ $ID ; 值:
         JSONGetElement ( $$JSON ; "面包店.产品[" & $i & "]id" ) ]
      If [ $ID = "FB3" ]
         设置变量 [ $$JSON ; 值:
            JSONDeleteElement ( $$JSON ; "面包店.产品[" & $i & "]" ) ]
         退出脚本 [ 文本结果: 0 ]
      End If
      设置变量 [ $i ; 值: $i + 1 ]
      Exit Loop If [ $i ≥ $产品数量 ]
   End Loop
End If

如果在解析 json 参数时出错，JSON 函数会返回“?”，后面跟着一条来自 JSON 分析器的错误消息。例如，如果 JSON 数据示例中“面包店”键后面缺少“:”，则计算

JSONGetElement ( $$JSON ; "面包店.产品[0]id" )

? * Line 3, Column 2
Missing ':' after object member name
* Line 13, Column 5
Extra non-whitespace after JSON value.

要在使用 JSON 数据之前确定其是否有效，请使用 JSONFormatElements 函数并测试第一个字符是否为“?”。例如：

设置变量 [ $结果 ; 值: JSONFormatElement ( $$JSON ) ]
If [ Left ( $结果 ; 1 ) = "?"]
# $$JSON 包含无效 JSON 数据。
End If

以下 JSON 数据示例包含一个“面包店”对象，其包含由三个“产品”对象组成的数组，每个对象都有几个键值对。

{
"面包店" :
{
"产品" :
[
{
"id" : "FB1",
"名称" : "面包圈",
"价格": 1.99,
"现货" : 43,
"类别" : "面包",
"特价" : true
},
{
"id" : "FB2",
"价格": 22.5,
"名称" : "巧克力蛋糕",
"现货" : 23,
"类别" : "蛋糕",
"特价" : true
},
{
"id" : "FB3",
"价格": 3.95,
"名称" : "法棍面包",
"现货" : 34,
"类别" : "面包",
"特价" : true
}
]
}
}

•JSON 分析器保留数组中元素的顺序，但不保留对象中元素的顺序。因此，JSON 函数返回对象中的元素的顺序可能与指定的顺序不同。