JSON 関数

適用対象: キャンバス アプリ モデル駆動型アプリ Power Pages

テーブル、レコード、または値の JSON テキスト文字列を生成します。

内容

JSON 関数は、テキストとしてデータ構造の JavaScript Object Notation (JSON) 表現を返すため、ネットワーク間での保存や送信に適しています。 [ECMA-404](https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf と IETF RFC 8259 は JavaScript や他のプログラミング言語で広く使用されている形式について説明します。

キャンバス アプリは、このテーブルがテキスト表現についての詳細とともにリストするデータ型 をサポートします:

結果の読み取り方法と、サポートされていないおよびバイナリ データの種類の処理方法を制御するために、任意の形式引数を指定します。 既定では、出力は不要なスペースや改行なしで可能な限りコンパクトであり、サポートされていないデータの種類とバイナリ データは許可されません。 & 演算子を指定する場合、複数の形式を組み合わせることができます。

結果を含むデータを制御し、サポートされていないデータの種類を削除するために、ShowColumns および DropColumns 関数を使用します。

JSON はメモリおよびコンピューティング処理となる可能性があるため、この関数は、動作関数 でのみ使用します。 JSON からの結果を変数 にキャプチャして、データ フローで使用できます。

列に表示名と論理名の両方がある場合、結果には論理名が含まれます。 表示名はアプリ ユーザーの言語を反映するため、一般的なサービスへのデータ転送には不適切です。

構文

JSON( データ構造 [, フォーマット ] )

• DataStructure – 必須。 JSON に変換するデータ構造。 テーブル、レコード、およびプリミティブ値がサポートされ、任意に入り子にされます。
• フォーマット - オプション。 JSONFormat 列挙型 値。 既定値は JSONFormat.Compact で、改行またはスペースを追加せず、バイナリ データとサポートされていない列をブロックします。

例

階層データ

1. Button コントロールを挿入し、OnSelect プロパティに次の数式を設定します。

   ClearCollect( CityPopulations,
       { City: "London",    Country: "United Kingdom", Population: 8615000 },
       { City: "Berlin",    Country: "Germany",        Population: 3562000 },
       { City: "Madrid",    Country: "Spain",          Population: 3165000 },
       { City: "Hamburg",   Country: "Germany",        Population: 1760000 },
       { City: "Barcelona", Country: "Spain",          Population: 1602000 },
       { City: "Munich",    Country: "Germany",        Population: 1494000 }
   );
   ClearCollect( CitiesByCountry, GroupBy( CityPopulations, "Country", "Cities" ) )
   

2. Alt キーを押しながら、ボタンを選択します。

   CitiesByCountry コレクションは、このデータ構造で作成されます。ファイル メニューのコレクションを選択した後、コレクションの名前を選択すると表示できます。

   

   また、設定>今後の機能>数式バーの結果ビューを有効にするを選択し、数式バーのコレクション名を選択し、数式バーのコレクション名の横にある下矢印を選択すると、このコレクションを表示することができます。

   

3. 別のボタンを挿入し、OnSelect プロパティに次の数式を設定します:

   Set( CitiesByCountryJSON, JSON( CitiesByCountry ) )
   

   この数式はグローバル変数 CitiesByCountryJSON を CitiesByCountry の JSON 表現に設定します。

4. Alt キーを押しながら、ボタンを選択します。

5. Label コントロールを挿入し、その Text プロパティを次の変数に設定します。

   CitiesByCountryJSON
   

   ラベルはこの結果を、すべてスペースなしの 1 行で示し、ネットワークを介した送信に適しています。

   [
     {
       "Cities": [{ "City": "London", "Population": 8615000 }],
       "Country": "United Kingdom"
     },
     {
       "Cities": [
         { "City": "Berlin", "Population": 3562000 },
         { "City": "Hamburg", "Population": 1760000 },
         { "City": "Munich", "Population": 1494000 }
       ],
       "Country": "Germany"
     },
     {
       "Cities": [
         { "City": "Madrid", "Population": 3165000 },
         { "City": "Barcelona", "Population": 1602000 }
       ],
       "Country": "Spain"
     }
   ]
   

6. 出力をより読みやすくするため、2 番目のボタンの数式を変更します。

   Set( CitiesByCountryJSON, JSON(CitiesByCountry, JSONFormat.IndentFour ))
   

7. Alt キーを押しながら 2 つ目のボタンを選択します。

   ラベルは、より読みやすい結果を示します。

   [
     {
       "Cities": [
         {
           "City": "London",
           "Population": 8615000
         }
       ],
       "Country": "United Kingdom"
     },
     {
       "Cities": [
         {
           "City": "Berlin",
           "Population": 3562000
         },
         {
           "City": "Hamburg",
           "Population": 1760000
         },
         {
           "City": "Munich",
           "Population": 1494000
         }
       ],
       "Country": "Germany"
     },
     {
       "Cities": [
         {
           "City": "Madrid",
           "Population": 3165000
         },
         {
           "City": "Barcelona",
           "Population": 1602000
         }
       ],
       "Country": "Spain"
     }
   ]
   

Base64 のイメージおよびメディア

1. Image コントロールを追加します。

   このコントロールは SampleImage を提供します。

2. Button コントロールを追加し、その OnSelect プロパティを次の数式に設定します。

   Set( ImageJSON, JSON( SampleImage, JSONFormat.IncludeBinaryData ) )
   

3. Alt キーを押しながら、ボタンを選択します。

4. ラベルを追加し、その Text プロパティを次の変数に設定します。

   ImageJSON
   

5. コントロールのサイズを変更し、ほとんどの結果を表示するために、必要に応じてフォント サイズを小さくします。

   ラベルは、JSON 関数がキャプチャしたテキスト文字列を示します。

   "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxzdmcgdmVyc2lvbj0iMS4xIg0KCSB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB4bWxuczphPSJodHRwOi8vbnMuYWRvYmUuY29tL0Fkb2JlU1ZHVmlld2VyRXh0ZW5zaW9ucy8zLjAvIg0KCSB4PSIwcHgiIHk9IjBweCIgd2lkdGg9IjI3MHB4IiBoZWlnaHQ9IjI3MHB4IiBlbmFibGUtYmFja2dyb3VuZD0ibmV3IDAgMCAyNzAgMjcwIiB4bWw6c3BhY2U9InByZXNlcnZlIj4NCgk8ZyBjbGFzcz0ic3QwIj4NCgkJPHJlY3QgeT0iMC43IiBmaWxsPSIjRTlFOUU5IiB3aWR0aD0iMjY5IiBoZWlnaHQ9IjI2OS4zIi8+DQoJCTxwb2x5Z29uIGZpbGw9IiNDQkNCQ0EiIHBvaW50cz0iMjc3LjksMTg3LjEgMjQ1LDE0My40IDE4OC42LDIwMi44IDc1LDgwLjUgLTQuMSwxNjUuMyAtNC4xLDI3MiAyNzcuOSwyNzIiLz4NCgkJPGVsbGlwc2UgZmlsbD0iI0NCQ0JDQSIgY3g9IjIwMi40IiBjeT0iODQuMSIgcng9IjI0LjQiIHJ5PSIyNC4zIi8+DQoJPC9nPg0KPC9zdmc+"
   

値のテーブル

この式:

JSON( [1,2,3] )

テキスト文字列 [{"Value":1},{"Value":2},{"Value":3}] を生成します。

JSONFormat.FlattenValueTables オプションを使用した同じ式:

JSON( [1,2,3], JSONFormat.FlattenValueTables )

テキスト文字列 [1,2,3] を作ります。

これらのテーブルは値テーブルではないため、CityPopulations または CitiesByCountry コレクションで JSON を使用する場合、FlattenValueTables オプションは影響しません。 値テーブルには 1 つの列があり、"Value" という名前を付ける必要があります。