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

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

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

アプリと連携するオペレーションの作成画面で「テスト」ボタンを押すとAPI接続のリクエスト結果が表示されます。

表示されたリクエスト結果から取得した値の隣にある＋マークを押すことで、自動的にアウトプットに値が取得されます。

また、項目名や入力形式を値に併せて任意に変更することも可能です。

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

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

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

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

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

文字列_1_4の列▼

添付動画のようにvalue横[]に*を入れることで、列の値をカンマ区切りですべて取得することも可能です。

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

JSON PATHの記載方法