JsonMerge - JSONのマージ

ひとつ以上の入力のJSONに対して更新箇所をJSONPath式で指定して、別のJSONフィールドを差し込みます。

■ストリーム情報

■コンポーネントプロパティ

■トランザクション処理

■エラー処理

■更新内容の定義

ベース側JSONPath式と入力側JSONPath式は、JSONPath式エディタを使って指定することができます。

ベース側JSONPath式

JSONフィールド名

入力JSON

入力側JSONPath式

■JSONPath

JSONPathは、JSONデータ内の特定の要素や値にアクセスするためのパス指定方法です。 ファイルの階層をたどるように、目的のデータにアクセスできます。 詳細はJSONPathのRFCをご参照ください。

基本的な書き方

例

{
  "ユーザー": {
    "名前": "太郎",
    "年齢": 30
  },
  "商品": [
    { "名前": "製品A", "価格": 1000 },
    { "名前": "製品B", "価格": 2000 }
  ]
}
				

■変数の使用

JSONPath式の中ではフロー変数とシステム変数、外部変数セット、ストリーム変数が使用できます。
以下の様に条件式内に変数を埋め込むと、実際の値に置き替えてJSONPathを評価します。

$.商品[?(@.名前==$flow.<フロー変数名>)].価格
					

■例

オブジェクトのフィールドに別のオブジェクトを挿入する例

{
  "会社": {
  }
}
					

{
  "役員": {
    "名前" : "山田太郎",
    "年齢" : 30
  }
}
					

{
  "会社": {
    "リーダー": { <-- リーダーフィールドとしてマージ
      "名前" : "山田太郎",
      "年齢" : 30
    }
  }
}
					

配列の末尾にオブジェクトを挿入する例

{
  "チーム": {
    "メンバー":[]
  }
}
					

{
  "新規メンバー": {
    "名前" : "山田太郎",
    "年齢" : 30
  }
}
					

{
  "チーム": {
    "メンバー":[ <-- 末尾にオブジェクトをマージ
      { 
        "名前" : "山田太郎",
        "年齢" : 30
      }
    ]
  }
}
					

■JSONPath式エディタ

JSONPath式エディタはプロパティ値にJSONPath式を指定する場合にその入力をサポートするためのエディタです。ツリーからJSONフィールドを選択して、そこまでのJSONPath式をプロパティに設定することができます。
JSONPath式を指定するフィールドの右にある「...」をクリックすると起動します。

ツリー

ツリーにはJSONPath式の対象となるストリームのフィールド定義が表示されます。コンポーネントの入力側にリンクが繋がっていない場合や入力ストリームにフィールド定義がされていない場合は初期状態では何も表示されません。

「サンプル参照」ボタン

任意のJSONを読み込み、その構造をツリーに表示させることができます。

「保存する」チェックボックス

サンプル参照からJSONを読み込んでいる場合、［保存する］チェックボックスをオンにすると、読み込んだJSONがxfpファイル（プロジェクトファイル）に保存され、次回xfpファイルを開いたときに、同じサンプルを利用できるようになります。

注意：サンプルJSONはコンポーネントの実行に必要な情報ではありません。ファイルサイズの大きなJSONを保存するとxfpファイル（プロジェクトファイル）のファイルサイズが大きくなり、保存やコンパイルに時間がかかってしまいます。そのため、サンプルJSONの保存は開発やテストの段階のみ行うようにしてください 。

JSONPathの設定

ツリーでノードを選択すると、そのJSONPathが「選択パス」欄に表示されます。「↓」ボタンを押すとそのパスが「JSONPath」欄にコピーされます。 「JSONPath」欄は編集可能なテキストフィールドで、複雑なJSONPath式を指定する場合はそこに直接記述することができます。

変数の挿入

JSONPath式エディタの「カーソル位置への挿入」ボタンで変数タブで選択した変数を「JSONPath」欄のカーソル位置に追加する事が出来ます。

JSONPath式のテスト

テストボタンをクリックする事でJSONPath式のテストダイアログを開き、JSONPath式の動作をテストする事が出来ます。
実行ボタンをクリックすると、左側の「JSON」テキストエリアに入力されたJSONに対して、「JSONPath」欄に入力されたJSONPath式を評価した結果を確認する事ができます。
「JSONPath」欄は編集する事が出来、編集後は「適用」ボタンをクリックする事でJSONPath式エディタの「JSONPath」欄に反映する事が出来ます。