Jinba FlowのJSON入力を検証する

公開ワークフローでJSON値を受け取る場合はINPUT_JSON_WITH_VALIDATIONを使います。valueにJSON文字列を渡し、任意のschema設定にJSON Schema文字列を指定するとフィールドと型を検証できます。有効なオブジェクトは後続ステップ用にresultへ返ります。

受信JSONの必須フィールドを指定する

- id: customer_input
  tool: INPUT_JSON_WITH_VALIDATION
  config:
    - name: schema
      value: '{"type":"object","properties":{"name":{"type":"string"},"age":{"type":"number"}},"required":["name","age"]}'
  input:
    - name: value
      value: '{"name":"Ada","age":30}'

この例ではresult.nameがAdaのオブジェクトを返します。ageがない、またはJSONが無効な場合、ステップはInvalid JSONエラーで失敗し、resultはnullになります。optionalがfalseでvalueが空の場合はJSON value is requiredで失敗します。schemaがない場合はJSONを解析しますが、追加のフィールド条件は検証しません。use_as_inputの既定値はtrue、optionalはfalseです。後続ステップでnullを扱える場合だけoptionalをtrueにします。ワークフローの最後に返すJSON値を検証する場合はJSON出力の検証を使います。

​受信JSONの必須フィールドを指定する

受信JSONの必須フィールドを指定する