JSONの確認条件を整える。設定と12ケースの試験

商品データや設定ファイルを変更したとき、「差分があるか」だけでは確認が終わらないことがあります。変更した場所が予定どおりか、残すべき項目が消えていないか、次の担当者がどこを見ればよいか。この3点をそろえると、確認の手順を繰り返し使いやすくなります。

【必須の欠落と、型の変更は別に見る】

商品データの例で考えます。商品名が空白になれば、項目そのものは残っていても掲載に必要な情報が不足しています。価格が数値50000から文字列「50000」に変わった場合は、見た目が近くても型が変わっています。

今回用意した確認例では、商品名の空白は「必須の要確認1件」、価格の文字列化は「型変更1件」として確認できます。型変更は必須項目の欠落には数えません。両方の結果を見ることが必要です。

【0とfalseを、空欄と混同しない】

在庫数0や公開可否falseは、意味のある値です。一方、null、空文字、空白だけの文字列を空欄として扱うかは、用途に応じて決める必要があります。確認条件を保存し、担当者が変わっても同じ条件を読み込めるようにします。

【導入時に用意する設定と試験】

「JSON差分確認の導入と検証条件を整えます」では、1業務・1形式（JSONまたはNDJSON）を対象に、最大3つの確認設定、必須パス通算30件までの条件表、正常・異常の試験12ケース、結果TXT／JSON、操作・判断・引継ぎ手順を整えます。

制作見本は商品データの公開前確認です。商品基本・価格公開・在庫公開の3つの設定を作り、項目欠落、空白、null、数値から文字列への変更、重複キー、不正なJSONなど12ケースを既存ツールの比較エンジンで実行しました。正常時だけでなく、何を検出できて何は手動確認になるかも試験結果に残しています。

【担当者が判断する部分も決める】

差分なしでも、価格が正しいことや、受取先のシステムに適合することまでは分かりません。必須項目があっても、値の内容が誤っている場合があります。入力エラーなら作成担当へ戻す、未承認の価格変更なら公開を止める、といった判断手順を業務に合わせて整理します。

使用するSave Preflight JP 1.0.0はローカルHTMLで動作し、入力を外部送信したり元ファイルを書き換えたりしません。結果には入力値を含めませんが、項目名・パスに機密情報がないかは共有前に確認してください。

【料金と進め方】

サービス価格は40,000円（税抜表示）。合意範囲の調整2回と、納品後30日以内・基本操作の質問5点を含みます。範囲と資料の確定後14日を目安に、用途確認→条件設計→試験→確認・調整→納品の順で進めます。

API接続、データ修正、新機能開発、完全なJSON Schema検証は含みません。各入力1MiB、深さ64、ノード50,000まで。配列・NDJSONは位置で比較し、ID照合はしません。ローカルHTMLを開けるPCとJSONの基本知識が必要です。

購入前の見積り相談で、用途、OS・ブラウザー、形式、サイズ、確認したい項目をお知らせください。認証情報や実データを送らず、値を置き換えた小さな構造例で適合を確認します。