概要

JSON PATHを使用することで、アプリオペレーションを実行した際のAPIリクエスト結果から任意の値を取得し、アウトプットとして後続のオペレーションで使用することが可能です。

JSON PATHについて

Yoomではアプリと連携するオペレーションで実行したAPIリクエストの結果はJSON形式のテキストで確認できるようになっています。

JSON PATHは特定のフォーマットでパスを記載することで、リクエスト結果のJSONテキストから任意の値を抽出することが可能です。（HTMLで用いるXPATHと近しいものとなります。）

1.レスポンス結果が表示されたあとに、画面下部にある「＋取得する値を追加」を押します。

2.画面上にJSON PATHの指定画面が表示されるので、取得したい値横の＋マークを押すことで、自動でその値を取得するJSON PATHが取得され、アウトプットとして追加されます。

3.アウトプット追加後、その項目にカーソルを合わせると以下のようにペンマークが表示されるので押します。

4.項目名や入力形式などを自由に変更することが可能です。

以下のように複数行に跨った値を取得する場合、取得したJSON PATHの一部を修正することで、特定箇所の値やすべての値を取得することが可能です。

例えば＋マークにより、このようなJSON PATHを最初に取得します。

record['テーブル_0'].value[0].value['文字列__1行__4'].value

これはテーブル_0というテーブル内に、文字列_1_4という列が複数ある状況を指します。

value横[]にある数字は値の位置を指し、0であれば最初の値(以下図の場合1111)、1であれば2つ目の値(以下図の場合2222)、*でればすべての値（以下図の場合1111,2222,3333)となります。

文字列_1_4の列▼

1.パターン2で先に紹介した1〜4までを操作し、以下のように項目名や入力形式の編集画面まで進みます。

2.取得したJSON PATHの値をコピーします。

3.再度「＋取得する値を追加」を押し、JSON PATHの取得画面を開いたら、検索窓にコピーしたJSON PATHをペーストします。

4.複数の値を取得するために、任意のvalue横[]に*を入れ値をすべて取得されたことが確認できたら、「＋JSONPath指定」を押します。

5.最後に1の段階で取得していたJSON PATHのアウトプットを削除し、新しく取得したアウトプットの項目名や入力形式を任意のものに変えたら設定完了です。

以上がJSON PATHによるアウトプットの取得方法です。

# 操作,JSON,JSONPATH,アウトプット