検証 アクションは JSON パッケージ内で、JSON データソースの内容を検証することを可能にします。 このアクションを使用して、任意の JSON ソースの構文、構造、およびスキーマを検証できます。

概要

検証 アクションを使用すると、JSON データソースに潜在的なエラーがないかを確認してから、下流のアクションに渡すことができます。 このアクションは、ランタイムの失敗を防ぎ、デバッグ時間を短縮することによって、自動化の信頼性を向上させます。 JSON データソースを指定し、検証レベルを設定し、検証結果を複数の変数または単一のディクショナリ変数に保存できます。

検証 アクションはファイル ストリーミング機能をサポートしています。 ファイルストリームに対応したアクションを使用して、ファイルストリームを保持するファイル変数を作成し、そのファイル変数を JSON データソースとして使用できます。

検証レベル一覧

このアクションで利用可能な検証レベルは次のとおりです。

形式
フォーマットオプションは、形式や文法などの構文ルールに対して JSON データソースを検証します。 このオプションを使用すると、波括弧 {}、角括弧 []、コロン :、カンマ ,、文字列のダブルクォーテーション、そして true、false、null などの JSON リテラルの正しい使い方を確認できます。
この検証レベルは、データソースとして ディクショナリ 変数を選択した場合には利用できません。
ノード
ノードオプションは、特定のノードの存在やその正しいデータ型などの構造ルールに対して JSON データソースを検証します。 このオプションを使用すると、ノードキーまたはノードパスを指定してノードの存在を確認できます。 指定されたノードの期待されるデータ型を 値のタイプ ドロップダウンで指定する必要があります。
スキーマ
スキーマオプションは、JSON データソースが指定されたスキーマ定義に従っているかどうかを検証します。 このオプションは、JSONスキーマがJSONの文法、ノード、データ型、必須／任意フィールド、列挙値、最大／最小値を定義するため、フォーマットオプションおよびノードオプションの両方を包含します。
注: スキーマ定義ファイルの変数または文字列に JSON スキーマドラフトバージョンを指定することを確認してください。 バージョンを指定しない場合、検証 アクションは、JSON データソースを検証するためのデフォルトオプションとして JSON schema draft 2020-12 仕様を使用します。

検証結果

検証アクションを使用すると、検証結果を個別の変数または単一のディクショナリ変数として保存できます。 自動化の実行は、JSON データソースに値 Null が存在するなどのプラットフォーム障害がある場合にのみ失敗します。 検証結果は、次のキーに格納されます。

isvalid
isvalid キーには、JSON ソースの検証結果が含まれています。 以下は考えられる値です。
  • true： 検証が正常に完了した場合。
  • false： 検証が失敗した場合。
validationlevel
validationlevelキーには、アクションを構成する際に設定した検証レベルが含まれています。 以下は考えられる値です。
  • 構文： 検証レベルがフォーマットに設定されている場合。
  • 構成： ノードとして検証レベルが設定されている場合。
  • スキーマ： スキーマとして検証レベルが設定されている場合。
errorpath
errorpathキーには、エラーが存在する JSON データソース内のパスが含まれています。
エラーメッセージ
エラーメッセージキーにはエラーメッセージが含まれています。 例えば、JSONスキーマが数値を定義しているが、JSONデータソースが同じ場所に文字列を提供している場合、error messageキーはこのstring found, integer expectedエラーメッセージをその値として保存します。