入力項目(列)の設定
日ごとに入力する列を、ラベル・ハンドル・タイプ・オプション・初期値の 5 項目で定義します。ハンドルはテンプレート出力のキーになります。
「入力項目」は、日ごとに入力する列(カラム)の定義です。「追加」ボタンで行を増やし、ゴミ箱アイコンで削除します。
設定する項目
| 設定項目 | 説明 |
|---|---|
| ラベル | 入力画面に表示される列の見出し(例:「営業」「開店時刻」) |
| ハンドル | テンプレートからデータを取り出すときのキー(英数字とアンダースコア) |
| タイプ | 入力欄の種類(12 種類から選択) |
| オプション | ドロップダウン・チェックボックス・ラジオボタンの選択肢(カンマ区切り) |
| 初期値 | 日付の行が作られたときに入る値 |
ハンドルの決め方
- 使用できるのは半角の英数字とアンダースコア(
_)です。それ以外の文字(日本語・ハイフン・スペースなど)は入力時に自動的に削除されます - 同じフィールド内でハンドルが重複しないようにしてください。重複すると、同じキーに複数の列の値が保存され、データが上書きされます
- ハンドルはそのまま JSON のキー名になります。運用開始後にハンドルを変更すると、入力済みのデータはそのハンドルでは取り出せなくなります(元のハンドルに戻せば再び表示されます)
初期値の扱い
- 初期値は、日付の行が新しく作られたときだけ 適用されます。すでに入力済みの行に後から反映されることはありません
- チェックボックスの初期値は、カンマ区切りで複数指定できます(例:
午前,午後) - ドロップダウン・ラジオボタンの初期値には、「オプション」に指定した選択肢と同じ文字列を指定します
- テキストなどの入力タイプでは、初期値にカンマを含めないでください。 カンマを含む値は複数値として扱われるため、正しく表示されません
設定例:営業日カレンダー
| ラベル | ハンドル | タイプ | オプション | 初期値 |
|---|---|---|---|---|
| 営業 | open | ドロップダウン | ○,×,△ | ○ |
| 開店時刻 | openTime | 時刻 | 10:00 | |
| 閉店時刻 | closeTime | 時刻 | 19:00 | |
| 備考 | note | テキスト(複数行) |
この設定では、コンテンツデータ編集画面に「日付 / 営業 / 開店時刻 / 閉店時刻 / 備考」の 5 列の表が表示されます。
設定例:宿泊プランの空室状況
| ラベル | ハンドル | タイプ | オプション | 初期値 |
|---|---|---|---|---|
| 空室状況 | vacancy | ラジオボタン | 空室,残りわずか,満室 | 空室 |
| 料金 | price | 数値 | 12000 | |
| プラン | plans | チェックボックス | 素泊まり,朝食付き,2食付き | |
| 補足 | note | テキスト |
設定を変更したときの注意
入力項目を削除すると、その列に入力済みのデータはテンプレートから取り出せなくなります(保存済みの JSON には残りますが、入力画面には表示されません)。同じハンドルで列を作り直すと、再び表示されます。