フォーム管理ヘルプ

概要

フォーム管理では、施設で使用するあらゆる情報収集フォームを一元管理できます。チェックイン時のゲスト情報収集（従来のゲストフォームの上位互換）から、会員登録・アンケート・施設点検まで、用途別に複数のフォームを作成・運用できます。

このページでできること：

施設に紐付いたフォームの一覧表示と絞り込み
新しいフォームの作成（名前・説明・適用範囲・公開URLスラッグを設定）
各フォームをクリックして詳細設定（フィールド・紐付け）を編集
フォームのステータス管理（下書き / 公開中 / アーカイブ）

アクセス方法

メインメニュー → 「フォーム」を選択してください。

詳細機能

機能1: フォーム一覧と絞り込み

すべてのフォームがカード形式で一覧表示されます。各カードには、フォーム名・適用範囲バッジ・ステータスバッジ・公開URLスラッグ（設定されている場合）・最終更新日が表示されます。

適用範囲フィルター

ドロップダウンで特定の適用範囲のフォームだけを絞り込めます。

適用範囲	用途
予約	チェックイン / 宿泊申込時のゲスト情報収集
会員	会員登録・更新時の個人情報収集
部屋・設備	部屋や設備に紐付く点検・レポートフォーム
施設	施設全体に関わる設定・申請フォーム
スタンドアロン	URL公開型アンケート・問い合わせフォーム

機能2: 新規フォームの作成

「新規フォームを作成」ボタンをクリックするとインラインに入力フォームが展開されます。

入力項目

項目	説明	必須
フォーム名	管理画面に表示される識別名（例：チェックイン用ゲストフォーム）	はい
説明	フォームの用途メモ（ゲストには表示されない）	いいえ
適用範囲	上記の5種類から選択	はい
公開URLスラッグ	スタンドアロン選択時のみ表示。英数字とハイフンで指定（例：customer-survey-2026）	スタンドアロン時は任意

作成手順

「新規フォームを作成」ボタンをクリックします
フォーム名を入力します
必要に応じて説明を入力します
適用範囲をドロップダウンから選択します
スタンドアロン選択時は公開URLスラッグを入力します
「作成」ボタンをクリックします
作成後、自動的にフォーム設定画面に遷移します

機能3: フォーム設定（フォームエディタ）

フォーム一覧のカードをクリックすると、フォームエディタが開きます。フォームエディタでは以下の3つのセクションを管理します。

3-1: フォームメタデータ

項目	説明
フォーム名	管理画面での表示名
説明	フォームの用途メモ
ステータス	下書き / 公開中 / アーカイブ
適用範囲	5種類から選択
公開URLスラッグ	スタンドアロン時のみ。/form-demo?facility=…&slug=… の形式で公開
再利用ポリシー	以下の3種類から選択（後述）
保存範囲	UnlockPass全体 / 組織内施設 / 当施設のみ

変更後は「保存」ボタンで確定します。

「削除」ボタンをクリックするとフォームを削除できます（確認ダイアログが表示されます）。「Default Reservation Form」などシステムデフォルトフォームは削除できません。

同一予約内では二度入力を求めません

プランにフォームを紐付けると、ゲストは予約時にフォームを入力します。その予約で既に回答が記録されている場合、同じ予約のチェックイン時には、そのフォームは再表示されません。予約とチェックインは同じ滞在の連続した手続きであるため、下記の再利用ポリシー（毎回入力・初回のみ・期限付き）の設定にかかわらず、同一予約の中で同じゲストに二度入力を求めることはありません。

直接チェックイン（walk-in）や、予約時にフォームを入力しなかった場合は、従来どおりチェックイン時にフォームが表示されます。

再利用ポリシー（UnlockPassプリフィル）

再利用ポリシーは「別の予約・次回の滞在」でフォームをどう扱うかを制御する設定です（同一予約内の二度聞き防止は上記のとおり、ポリシーに関係なく常に適用されます）。同じゲストが以前の予約でフォームを提出したことがある場合、前回の回答を確認画面に表示してプリフィルします。

ポリシー	挙動	代表的なユースケース
毎回入力（per_visit）	予約ごとに新たに入力させる。保存範囲が「当施設のみ」の場合はプリフィルなし	旅館業法に基づく宿泊者名簿など法定帳票
初回のみ（one_time）	一度提出後は、次回以降の予約では内容の確認のみ（修正不可）	会員サロン・サブスクの初回登録
期限付き（periodic）	N日経過後の予約で再入力を求める	年次更新が必要な施設利用申込など

保存範囲を「UnlockPass全体」にすると、ゲストが他施設で提出した回答もプリフィルの対象になります。

ゲストが見る確認画面（Confirm ステップ）：

前回の回答がある場合、ゲストには前回の提出内容が一覧で表示され、以下のボタンが表示されます。

「この内容で送信」— 変更なしでそのまま提出
「修正する」— 入力フォームに戻って内容を変更（one_time ポリシーでは表示されない）

3-2: フォームフィールド

フォームに含まれるすべてのフィールドをテーブル形式で確認・管理できます。

予約スコープのフォームには以下の11項目がデフォルトで含まれます（削除不可）：

#	フィールド名	タイプ	初期状態	必須/任意	表示条件
1	氏名	テキスト	有効	必須	常時
2	生年月日	日付	無効	任意	常時
3	電話番号	テキスト	有効	必須	常時
4	住所	テキスト	有効	必須	常時
5	都道府県	テキスト	無効	任意	常時
6	郵便番号	テキスト	無効	任意	常時
7	国籍	選択肢	有効	必須	常時
8	パスポート番号	テキスト	有効	必須	国籍が施設所在国以外の場合
9	パスポート写真	画像	有効	必須	国籍が施設所在国以外の場合
10	身分証番号	テキスト	有効	必須	国籍が施設所在国の場合
11	身分証写真	画像	有効	必須	国籍が施設所在国の場合

**「連絡先」は「電話番号」に改名されました。**既存データの field_key は contact のままで後方互換を維持しています。

初期状態が「無効」のフィールド（生年月日・都道府県・郵便番号）は一覧にグレーアウトと「無効」バッジで表示されます。ワンタップで有効化できます。有効化後に必須/任意の切り替えが可能です。

その他のスコープでは、デフォルトフィールドはなく自由にカスタムフィールドを追加できます。

デフォルトフィールドの有効化・無効化

デフォルトフィールドはすべて有効/無効をトグルで切り替えられます。

無効状態のフィールドはゲストの入力画面に表示されません
一覧ではグレーアウトと「無効」バッジで視覚的に区別されます
有効にするには行の「有効」トグルをオンにします（即時保存）
必須トグルは有効状態のフィールドにのみ操作できます
例：海外ゲストを受け入れない施設は国籍・パスポート系をすべて OFF にできます

並び替え

フィールドの表示順を変更できます。変更は即時保存されます。

デスクトップ: 各行左端の ⋮⋮ ハンドルをドラッグ＆ドロップで並び替えます。ドロップ先がブランドカラーでハイライトされます
モバイル: 各カードに表示される ↑ / ↓ ボタンで1段ずつ移動できます
カスタムフィールドとデフォルトフィールドを混在させて並び替え可能です

カスタムフィールドの追加

入力項目	説明	必須
ラベル（日本語）	日本語表示のフィールド名	はい
ラベル（English）	英語表示のフィールド名	いいえ（未入力時は日本語ラベルを使用）
フィールドID	システム内部で使用するID	いいえ（自動生成）
フィールドタイプ	text / textarea / select / date / image から選択	はい

追加されたカスタムフィールドは初期状態では「任意」です。必須にする場合は必須トグルをオンにしてください。

仮予約フォーム（Default Pending Reservation Form）

承認制予約など事前審査が目的の仮予約フォームは、国際身分確認系フィールドを除いた以下の8項目で構成されています：

氏名 / 生年月日 / 電話番号 / 住所 / 都道府県 / 郵便番号 / 身分証番号 / 身分証写真

（国籍・パスポート番号・パスポート写真は含まれません）

有効化/無効化・必須切り替え・並び替えの操作方法は通常のフォームと同じです。

即時保存（Auto-save）について

以下の操作はクリック直後にサーバへ自動保存されます（「保存」ボタン不要）：

有効トグルの切り替え
必須トグルの切り替え
並び替え（ドラッグ＆ドロップ・↑↓ボタン）
カスタムフィールドの追加・削除

「保存」ボタンが必要なのはフォームメタデータ（名前・説明・ステータス・適用範囲・再利用ポリシーなど）のみです。

3-3: 紐付け (Bindings)

フォームをどこで表示するかを指定します。

種類	説明	フォームが出るタイミング
プラン	特定の予約プランに紐付け。そのプランで予約したゲストにフォームが表示される	予約時（Booking / Go アプリの決済直前ステップ）
イベント	特定のイベントに紐付け	イベント申込時
公開URL	スタンドアロンフォームとして公開（URLで直接アクセス可能）	URL直接アクセス時（ログイン不要）

紐付けを追加するには種類を選択し、プランまたはイベントの場合はUUIDを入力して「追加」をクリックします。

プラン紐付けとチェックイン設定フォームの違い：

プラン紐付け → Booking / Go アプリで予約するゲストに予約時にフォームが表示されます

チェックイン設定（既定）のフォーム → ホストのチェックインURL やキオスク経由のゲストにチェックイン時に表示されます

同じプランの予約でも、ゲストが Booking でセルフチェックインするか、キオスクを使うかで表示タイミングが変わります。詳しくはチェックイン設定のヘルプを参照してください。

機能4: 公開アンケート（スタンドアロン）

スタンドアロンスコープのフォームは、ログイン不要の公開URLでアクセスできます。

設定手順

フォームを作成する際、適用範囲に「スタンドアロン (URL公開)」を選択します
公開URLスラッグを設定します（例：satisfaction-survey-2026）
フォームのステータスを「公開中」にします

以下のURLを共有します：

/form-demo?facility=<施設ID>&slug=<スラッグ>

主なユースケース

満足度アンケートのQRコード配布
イベント後の参加者フィードバック収集
施設見学・内覧の申込フォーム

機能5: 承認制予約

プランの設定で approval_mode を「手動承認」にすると、ゲストが予約した時点でステータスが pending_approval（承認待ち）になります。施設オーナーが「予約承認」ページで承認または拒否するまで予約は確定しません。

承認フロー

ゲストが予約 → pending_approval（承認待ち）
  ↓ 施設オーナーが承認 → confirmed（確定）
  ↓ 施設オーナーが拒否 → cancelled（キャンセル）

承認手順

メインメニュー → 「予約承認」を選択します
承認待ちの予約が一覧表示されます
各予約カードの「承認」ボタンをクリックすると予約が確定します
「拒否」ボタンをクリックすると理由の入力フィールドが表示されます
拒否理由を入力して「拒否を確定」をクリックします

詳細は予約承認のヘルプを参照してください。

従来のゲストフォーム設定からの移行

予約管理タブ内の「ゲストフォーム」タブ（旧 /booking?tab=guestForm）は 2026-05-19 に削除されました。

	旧「ゲストフォーム」タブ	新フォーム管理 (`/forms`)
フォーム数	施設ごとに1つのみ	複数作成可能
適用範囲	予約のみ	予約・会員・空間・施設・公開URL
プラン別切替	不可	プランごとに別フォームを紐付け可
公開アンケート	不可	slug設定でURLから直接アクセス可
データ移行	—	自動（Default Reservation Form として移行済み）

旧タブで編集していた内容は「Default Reservation Form」として /forms に自動移行されています。引き続き同じデータを編集できます。

よくある質問

Q: 従来の「ゲストフォーム設定」のデータはどうなりますか？

自動的に「Default Reservation Form」として新フォーム管理に取り込まれています。設定した内容はそのまま引き継がれます。

Q: 1つのプランに複数のフォームを紐付けられますか？

現時点では、1プランに対して1フォームを紐付けることを推奨します。複数の紐付けが存在する場合の優先順位は未確定です。

Q: スタンドアロンフォームへの回答はどこで確認できますか？

回答データの確認・CSV出力機能は今後追加予定です。現時点では管理画面からの直接確認はできません。

Q: 従来の「宿泊者名簿」ページはどこに行きましたか？

宿泊者名簿はフォーム管理に統合されました。フォーム一覧から 回答ハブ (Form Responses Hub) を開き、ショートカットカード「宿泊者名簿」を選択すると、Default Reservation Form の回答を従来と同じ日付フィルター・CSV出力で確認できます。フォーム名のドロップダウンから他のフォームの回答も同じ画面で参照できます。

Q: フォームをアーカイブするとどうなりますか？

アーカイブされたフォームは一覧に表示されますが、紐付け先でのフォーム表示が停止します。データは削除されません。

Q: デフォルトフィールドの必須/任意は変更できますか？

はい、変更できます。予約スコープのデフォルト11項目はすべて必須/任意の切り替えが可能です。また有効/無効の切り替えや並び替えも可能です。ただし無効状態のフィールドは必須化できません（先に有効にしてください）。

Q: 予約時に入力したフォームが、チェックイン時にまた表示されることはありますか？

いいえ。予約時にフォームへの回答が記録されている場合、同じ予約のチェックイン時にはそのフォームは再表示されません。予約とチェックインは同じ滞在の連続した手続きとして扱われるため、再利用ポリシーの設定にかかわらず同一予約内で再入力を求めることはありません。チェックイン時にフォームが表示されるのは、予約フローを経由せず直接チェックイン（walk-in）した場合、または予約時にフォームを入力しなかった場合です。

フォーム管理 ヘルプ

概要