テーブルの管理：開発者向け機能：ドラフト機能

2026-09-172026-09-17

概要¶

スタイル・スクリプト・HTMLの各設定に対して、ドラフト表示時にのみ出力する、またはドラフト表示時のみ出力しない、といった出力の切り替えを行うことができる機能です。本番公開中の画面には反映させずに動作確認を行いたい場合などに利用します。ドラフト表示は、事前にドラフトキーを設定し、表示確認を行う際にURLの末尾にドラフトキーを追加することで確認を行います。

前提条件¶

設定を行うには「サイトの管理権限」が必要です。
本機能はスタイル・スクリプト・HTMLのそれぞれに個別に設定します。

操作手順¶

設定方法¶

テーブルの管理でスタイル・スクリプト・HTMLタブのいずれかを選択します。
このマニュアルではHTMLの設定を例に挙げ、設定方法を説明します。
新規作成又は、HTMLの一覧から登録済の項目をクリックすると、編集ダイアログが表示されます。「ドラフト出力」「ドラフトキー」の項目を使用します。
HTMLを記述後、「ドラフト出力」で出力タイミングを選択します。設定可能な内容は以下の通りです。

選択肢	説明
通常出力（常に）	ドラフト表示かどうかに関わらず、常に出力します。（既定値）
ドラフト時のみ出力	ドラフト表示時（URLに ?Draft= パラメータが付与され、値がドラフトキーと一致する場合）のみ出力します。
ドラフト時は出力しない	ドラフト表示時は出力せず、それ以外の場合（通常表示時）に出力します。

ここでは、ドラフト表示の動作を確認するために、「ドラフト時のみ出力」を選択してください。

「ドラフトキー」にドラフト表示を判定するための任意の文字列を入力します。（例：mydraftkey）省略した場合は既定値「1」が使用されます。
画面下部のコマンドボタンエリアにある追加ボタンまたは変更ボタンをクリックします。
「更新」ボタンをクリックします。
作成したHTMLが保存されます。

表示の確認¶

動作イメージ¶

設定内容	通常表示	ドラフト表示（?Draft=付与）
ドラフト時のみ出力	出力されない	出力される
ドラフト時は出力しない	出力される	出力されない

表示の確認（一覧画面）¶

テーブルの一覧の表示を確認します。はじめに、ドラフトキーを付与しない通常の表示でHTMLが表示されないことを確認します。
http://{サーバ名}/items/{サイトID}/index
ドラフトモードのテーブルの一覧の表示を確認します。一覧画面でドラフトキーを付与したURLを表示します。
http://{サーバ名}/items/{サイトID}/index?Draft=mydraftkey
一覧画面でドラフト表示が有効となるため、HTMLが表示されます。

APIでの設定¶

本機能はAPI（サイト設定の更新）からも設定できます。詳細はサイト設定の更新（部分追加/更新/削除）を参照ください。

対応バージョン	内容
1.5.7.0 以降	機能追加