コマンド行から JSON ファイルを事前に検証する
HCL Domino には、ワンタッチセットアップ JSON 構成ファイルを検証するための簡単なコマンド行ツールが付属しています。
ワンタッチ・セットアップ JSON 構成ファイルを有効にするには、そのファイルに有効な JSON が含まれている必要があります。また、この設定は、Domino に付属している dominoOneTouchSetup.schema.json ファイルに定義されている、ワンタッチ・セットアップ・スキーマの要件を満たしている必要があります。
ワンタッチ・セットアップ JSON 構成ファイルを検証するには、Domino に用意されている実行可能ファイル validjson (Windows の場合は validjson.exe など) を使用します。ツールを実行するには、以下のいずれかのオプションを使用します。
注: このツールは Notes アプリケーションです。このため、プログラム・ディレクトリーからコマンド・ラインを使用して実行するか、サーバー・コンソール (例えば
load validjson valid.json
など) から実行できます 。ファイルに有効な JSON が含まれるかを検証する
以下のコマンドを実行します。
validjson <fileToValidate>.json
例:
validjson valid.json
成功すると、次のメッセージが表示されます。
Success - valid.json is valid
JSON 構文エラーがある場合、次のようなメッセージが表示されます。
Failed - JSON validation - invalid.json
==> Missing a comma or '}' after an object member. at offset 60 ["type": "first"]
ファイルに有効な JSON が含まれ、デフォルトの Domino スキーマに準拠していることを検証する
ファイルに有効な JSON が含まれており、dominoOneTouchSetup.schema.json で定義されたデフォルトのスキーマに準拠していることを検証するには、 次のコマンドを使用します。
validjson <fileToValidate>.json -default
例:
validjson valid.json -default
成功すると、次のメッセージが表示されます。
Success - valid.json is valid with respect to schema dominoOneTouchSetup.schema.json
JSON は有効で、デフォルトの Domino スキーマに準拠していない場合は、次のようなメッセージが表示されます。
Failed - JSON validation - nonconforming.json
==> Schema reference: #/properties/serverSetup/properties/server/properties/type
==> Schema keyword: enum
==> Document reference: #/serverSetup/server/type
==> Likely cause: serverSetup/server/type value must be one of the allowed values
ファイルに有効な JSON が含まれ、ユーザー提供のスキーマに準拠していることを検証する
ファイルに有効な JSON が含まれ、 かつ https://json-schema.org/specification.html で詳しく説明されているスキーマ要件に準拠していることを検証するには、次のコマンドを使用します。
validjson <fileToValidate>.json <userProvidedSchema>.json