使用 JSON 函数

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

有关 JSON 数据格式的更多信息，请参阅 json.org 。

格式化 JSON 数据

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

解析 JSON 数据

JSONGetElement – 在 JSON 数据中查询元素（对象、数组或值）

JSONListKeys – 列出 JSON 数据中的对象名称（键）或数组索引

JSONListValues – 列出 JSON 数据中的值

这些函数的第一个参数 json 指定包含要操作的有效 JSON 数据的文本字段、变量或文本表达式。

第二个参数 键或索引或路径 指定要操作的 JSON 数据的部分：

键 – JSON 对象中键的名称

索引 – JSON 数组中元素的索引（第一个元素的索引为 0）

路径 – 键名称、数组索引或二者的层级字符串

支持以下两种用于 键或索引或路径 参数的语法： 点表示法 和 括号表示法 。

点和括号符号的区别在于此，括号表示法不是使用句点 ( . ) 来分离关键字名称，而是使用单引号 ( ' ) 和括号 ( [] ) 括住关键字名称。您可以在 键或索引或路径 中使用任一表示法。但如果键名称包含点，则必须使用括号表示法，以便 JSON 解析程序可以正确识别整个键名称。例如，如果 JSON 对象根的键是 "layout.response" ，则 keyOrIndexOrPath 将是 " ['layout.response']" 。

以下示例脚本为 JSON 数组中的每个产品创建记录。假设 JSON 数据示例 存储在 $$JSON 变量中，则脚本使用 JSONListValues 来获取产品数组的内容，将其显示值列表，并且使用 ValueCount 来确定列表中的产品数。每次通过循环创建产品记录时，脚本都会使用 GetValue 获取列表中产品的 JSON 对象，并将字段设置为使用 JSONGetElement 获取的值。由于 JSON 函数会解析传递给它们的整个 JSON 对象，在多次重复的循环内较小的 JSON 对象上使用 JSON 函数可能更有效。

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

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

设置变量 [ $产品数量 ; 值: 
   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

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

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

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

设置变量 [ $结果 ; 值: JSONGetElementType( $$JSON, "" ) ]
If [ $结果 ≠ JSONObject ]
    # $$JSON 包含无效的 JSON 数据。
End If

设置变量 [ $url ; "https://bakery.example.com/rest/api/products" ]

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

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