JSON 関数の使い方

FileMaker Pro には、REST API を使用して JSON 形式のデータを転送する Web サービスなど、他のソースの JSON データをソリューションで解析および変更できるようにするテキスト関数がいくつか用意されています。

URL から挿入スクリプトステップを使用して Web サービスへのアクセス、取得する情報に対する引数指定、HTTP ヘッダの送受信、変数またはフィールドへの結果の保存を行います。

たとえば、あるベーカリーで顧客が購入できる製品の一覧を、REST API を使用して JSON 形式で作成します。次の例では、本日の特売一覧を $$JSON 変数に格納された JSON データとして返します。

変数を設定 [ $url ; "https://<ベーカリードメイン名>/rest/api/products" ]

URL から挿入 [ SSL 証明書の検証 ; ダイアログあり: オフ ; $$JSON ;
$url ; "--data 一覧 = 特売" ]

FileMaker Pro には、一部の REST API で必要な文字エンコードと暗号化署名を処理するユーティリティ関数もいくつか用意されています。

JSON データでは要素間のスペースや改行は必要ありません。ただし、問題をデバッグするときにデータを読みやすくするには、JSON データの例に示すようにタブや改行コード文字を追加する JSONFormatElements 関数を使用します。

次の JSON 関数を使用して JSON データを解析します。つまり、キー、値、JSON オブジェクト全体 (さらに処理が可能な配列) を取得します。

これらの関数の 1 番目の引数 json では、処理対象の有効な JSON データを含むテキストフィールド、変数、またはテキスト式を指定します。

キーまたは索引またはパス引数	意味
"."	(オプション) 1 番目の文字である場合はルートレベル
".[n]"	ルートレベルの配列の索引 n の位置にある要素
".名前"	ルートレベルの名前というオブジェクトのキー
".名前 A.名前 B.名前 C"	名前 C というオブジェクト、名前 B および名前 A の子孫
".[3][2][1]名前 A[0]"	名前 A オブジェクトの配列の 1 番目の要素、ネストされた配列セットの 3 番目のレベル

次の例のスクリプトでは JSONListKeys を使用して JSON データの例 ($$JSON 変数に格納されている) 内の製品の数を求め、各製品のレコードを作成して各レコードのフィールドに JSONGetElement を使用して取得した各製品の値を設定しています。

変数を設定 [ $ProductCount ; 値:
   ValueCount (
      JSONListKeys ( $$JSON ; "ベーカリー.製品" )
   ) ]
変数を設定 [ $i ; 値: 0 ]
If [ $ProductCount > 0 ]
   Loop
      新規レコード/検索条件
      フィールド設定 [ 製品::ID ;
         JSONGetElement ( $$JSON ; "ベーカリー.製品[" & $i & "]ID" ) ]
      フィールド設定 [ 製品::価格 ;
         JSONGetElement ( $$JSON ; "ベーカリー.製品[" & $i & "]価格" ) ]
      フィールド設定 [ 製品::在庫 ;
         JSONGetElement ( $$JSON ; "ベーカリー.製品[" & $i & "]在庫" ) ]
      レコード/検索条件確定 [ ダイアログあり: オフ ]
      変数を設定 [ $i ; 値 : $i + 1 ]
      Exit Loop If [ $i ≥ $ProductCount ]
   End Loop
End If

JSON データの値を変更したり要素を追加したりするには JSONSetElement 関数を使用します。この関数の json およびキーまたは索引またはパス引数は JSON データの解析で説明したとおりに機能します。キーまたは索引またはパスで既存の要素を指定した場合はその要素の値が変更され、要素が存在しない場合は新しい要素が追加されます。

JSONSetElement は指定された要素に値引数を設定します。単純な文字列や数値から複雑なオブジェクトや配列まで、すべての有効な JSON 値を指定できます。

タイプ引数では値のデータタイプを指定して、JSON パーサが各データタイプを扱うときの厳格なルールに従うようにします。サポートされるデータタイプについては JSONSetElement 関数を参照してください。JSON データを json に挿入するには、タイプを JSONRaw に設定して JSON パーサが値のデータタイプを判定できるようにします。

次の例では新製品のキー/値ペアを空の JSON オブジェクトに追加します。次に新しいオブジェクトを $$JSON 変数の製品配列の末尾に追加します (JSON データの例を参照してください)。

変数を設定 [ $NewProduct ; 値 :
   JSONSetElement ( "{}" ;
      [ "ID" ; "FB4" ; JSONString ] ;
      [ "名前" ; "バニラケーキ" ; JSONString ] ;
      [ "価格" ; 17.5 ; JSONNumber ] ;
      [ "在庫" ; 12 ; JSONNumber ] ;
      [ "カテゴリ" ; "ケーキ" ; JSONString ] ;
      [ "特売" ; true ; JSONBoolean ]
   ) ]
変数を設定 [ $NextIndex ; 値 :
   ValueCount (
      JSONListKeys ( $$JSON ; "ベーカリー.製品" )
   ) ]
変数を設定 [ $$JSON ; 値 :
   JSONSetElement (
      $$JSON ; "ベーカリー.製品[" & $NextIndex & "]" ; $NewProduct ;
      JSONObject
   ) ]

要素を削除するには JSONDeleteElement 関数を使用します。この関数の json およびキーまたは索引またはパス引数は JSON データの解析で説明したとおりに機能します。キーまたは索引またはパス引数では json の既存の要素を指定する必要があります。

次の例では $$JSON 変数の "ID" キーの値が "FB3" の製品配列の要素を削除します (JSON データの例を参照してください)。

変数を設定 [ $ProductCount ; 値:
   ValueCount (
      JSONListKeys ( $$JSON ; "ベーカリー.製品" )
   ) ]
変数を設定 [ $i ; 値 : 0 ]
If [ $ProductCount > 0 ]
   Loop
      変数を設定 [ $ID ; 値 :
         JSONGetElement ( $$JSON ; "ベーカリー.製品[" & $i & "]ID" ) ]
      If [ $ID = "FB3" ]
         変数を設定 [ $$JSON ; 値 :
            JSONDeleteElement ( $$JSON ; "ベーカリー.製品[" & $i & "]" ) ]
         現在のスクリプト終了 [テキスト結果: 0 ]
      End If
      変数を設定 [ $i ; 値 : $i + 1 ]
      Exit Loop If [ $i ≥ $ProductCount ]
   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 関数を使用して先頭の文字が「?」であるかどうかをテストします。例:

変数を設定 [ $result ; 値 : JSONFormatElement ( $$JSON ) ]
If [ Left ( $result ; 1 ) = "?"]
# $$JSON に無効な JSON データが含まれています。
End If

次の例では、JSON データに「ベーカリー」オブジェクトが含まれています。「ベーカリー」オブジェクトは 3 つの「製品」オブジェクトを含み、それぞれがキー/値ペアを複数持ちます。

{
"ベーカリー" :
{
"製品" :
[
{
"id" : "FB1",
"名前" : "ドーナツ",
"価格" : 1.99,
"在庫" : 43,
"カテゴリ" : "パン",
"特売" : true
},
{
"id" : "FB2",
"価格" : 22.5,
"名前" : "チョコレートケーキ",
"在庫" : 23,
"カテゴリ" : "ケーキ",
"特売" : true
},
{
"id" : "FB3",
"価格" : 3.95,
"名前" : "バゲット",
"在庫" : 34,
"カテゴリ" : "パン",
"特売" : true
}
]
}
}

•JSON パーサは配列内の要素の順序は維持しますが、オブジェクト内の要素の順序は維持しません。そのため、JSON 関数は指定した順序とは異なる順序でオブジェクトの要素を返すことがあります。