TROUBLESHOOTING / JSON
JSONを読み込めないときの確認手順
読み込みが失敗したときは、ファイルの形式と項目のつながりを確認します。ツールはファイルをブラウザ内で読み取り、全体の検証を通った後に画面のリストへ反映します。
先に現在のリストを保存する
読み込めるJSONは現在の画面のリストを置き換えます。残しておきたい内容は、試す前に「JSONを保存」で別ファイルにしてください。読み込みに失敗した場合は、現在の画面データが保持され、エラー理由がステータス欄に表示されます。
エラー別の確認
| 表示・症状 | 確認する内容 | 直し方 |
|---|---|---|
| JSONを読み取れませんでした | かっこ・引用符・カンマの抜けなど、JSONとして解析できる形か | 保存したファイルをテキストで開き、構文を直して保存し直す。末尾の余分なカンマを避ける |
| 対応していないschemaVersion | schemaVersion が数値の 1 か | このツールが保存したJSONを使う。手で直す場合も対応形式に合わせる |
| itemsとbagsは配列で指定してください | 最上位に items と bags の配列があるか | 空でも配列 [] にする。バッグは1件以上必要 |
| バッグがバッグ一覧にありません | 各品目の bag がバッグ一覧の名前と一致するか | バッグ名の表記をそろえるか、対応するバッグを追加する |
| 個数・単重量のエラー | quantity は1以上の整数、unitWeightG は0以上の整数gか | 数値を引用符で囲まず、g単位の整数で入力する |
| 持ち物は200件まで | itemsの件数が201以上になっていないか | 不要な重複行を整理し、200件以内に分ける |
最小の形を確認する
次は形式を示すだけの架空サンプルです。バッグ名は品目側とバッグ側で同じにします。
{
"schemaVersion": 1,
"items": [{
"id": "bottle-1",
"name": "水筒",
"quantity": 1,
"unitWeightG": 500,
"bag": "リュック",
"required": true,
"prepared": false
}],
"bags": [{ "name": "リュック", "limitG": 5000 }]
}
limitG は整数gか、上限なしなら null です。required と prepared は true または false にします。
この例を読み込むと、全体とリュックの重量は500g、5,000gの上限内、忘れ物は「水筒」となるのが期待結果です。
再読込の手順
- 失敗メッセージを読み、上の表にある該当項目を確認します。
- 元ファイルのコピーを直し、品目ID・バッグ名・数値・真偽値を確認します。
- 「JSONを読み込む」から修正版を選び、バッグ別重量と一覧が想定どおりか確認します。
- 続けて使うデータなら「JSONを保存」で修正版を手元へ保存します。
制約
対応するデータ形式は schemaVersion: 1 です。パスワード付きファイルや別アプリ独自の形式を変換する機能はありません。手作業で直すときは、まず保存した元ファイルのコピーを編集してください。