フォーム設定

フォームビルダーを使って、アプリの入力フォームを視覚的に設計します。プログラミングは不要です。

フォームビルダーの画面構成

• 左パネル（フィールドパレット） -- 利用可能なフィールドタイプの一覧。ドラッグで中央キャンバスに配置
• 中央（キャンバス） -- フォームのレイアウト。フィールドのドラッグ並べ替え、セクション管理
• 右パネル（プロパティ） -- 選択中のフィールドの詳細設定
• 上部ツールバー -- 下書き保存、テスト、適用、Undo/Redo

基本操作

すべてのフィールドに共通する設定

• ラベル -- 画面に表示されるフィールド名
• フィールドコード -- API・ルックアップ・帳票で使用する識別子。後から変更しないことを推奨
• 必須 -- ONにすると、未入力では保存できません
• 重複禁止 -- ONにすると、同じ値のレコードを登録できません。テキスト・数値・リンク・日付・日時・自動採番の各フィールドに加えて、複数選択をOFFにしたユーザー選択・組織選択・グループ選択でも設定できます（「社員マスタの対応ユーザーは1人1行」のように使います）。対応していないタイプや、複数選択がONのときは表示されません。空欄は重複と見なさないので、値を入れていないレコードは何件でも登録できます。既にあるデータに重複がある状態ではONにできません（どの行を残すかを自動で決めるとデータが壊れるため、重複しているレコード番号を示してエラーになります。重複を解消してから設定してください）
• 画面に表示しない（設定パネル下部の「高度な設定」を開くと表示されます） -- この項目を画面（入力フォーム・詳細・一覧の列・CSV 出力）に出しません。値は保存され、計算式・条件・並び替え・参照表示・API からは今までどおり使えます。詳しくは下の「画面に表示しない」を参照してください
• 参照表示（設定パネル下部の「高度な設定」を開くと表示されます） -- 同じアプリの別のフィールドを選択すると、このフィールドの入力欄・表示値のすぐ下に、選択したフィールドの値がグレーの小さい文字で表示されます。「確定額の下に見積額」「実績日の下に予定日」のように、基準値と突き合わせながら入力・確認したい場合に使います。詳しくは下の「参照表示」を参照してください
• フィールド名を表示しない -- ONにすると、入力・詳細画面でフィールド名（ラベル）を隠します。値の入力欄自体は表示されるため、見出しなしで値だけを見せたい場合に使います
• ツールチップ -- フィールドラベル横の アイコンに表示される説明文。Markdown が使えます
• 画面ごとのツールチップ -- ツールチップ欄の下の「画面ごとに上書き」を開くと、追加・編集・詳細・公開フォームの各画面に別々の説明文を設定できます。空欄の画面では通常のツールチップが使われます
• プレースホルダー -- 入力欄が空のとき薄く表示されるヒントテキスト（対応するフィールドタイプのみ）
• フィールド幅 -- フィールドの横幅を 25%〜100% で指定します（設定パネルのボタン、または選択中フィールドの右端ドラッグ・←/→キーで変更。Alt 併用で 1% 単位）。狭いフィールドを横に並べてフォームを整えられます。1% 単位で調整した行にフィールドをドラッグで挿し込むと、行に空きがあれば新しいフィールドが空きをそのまま使い（例: 23% + 27% の行なら残り 50% で入る）、空きが足りない場合は挿入先のフィールドからだけ幅を分けてもらいます。いずれも他のフィールドの幅は変わりません（標準幅だけで組まれた行では従来どおり 3 等分などに自動再配分されます）

フォームからフィールドを隠したいとき（3 つの手段の使い分け）

自動採番・計算フィールド・システムが設定する項目など、ユーザーに入力させたくない項目を フォームから外す方法は 3 つあります。隠れる範囲といつ隠れるかが違うので、 目的に合うものを選んでください。

• 新規登録のときだけ隠したい（登録日をシステムが自動で入れ、あとから修正はできるようにしたい等）場合は入力ルールを使います。適用タイミングを「新規追加時」にして、フォームでの表示を「非表示」にすると、 新規フォームには出ず値だけが入り、編集フォームには通常どおり表示されます。 他の 2 つは新規と編集を分けられません
• アクセス権によるフィールドの出し分けは、アプリ管理者には適用されません。 管理者の画面には項目が出て、保存もできます（設定自体は保存できますが効きません）。 全員から確実に隠すなら「画面に表示しない」か入力ルールを使ってください。 アクセス権は「特定の人にだけ見せない・書かせない」ための機能です
• 値そのものを見せたくない（秘匿）場合は、上の 2 つでは守れません。 値は API・CSV・計算式から見えます。アクセス権の「閲覧＝非表示」を使ってください

画面に表示しない（データ・計算専用の項目にする）

フィールド設定パネル下部の「高度な設定」にある「画面に表示しない」を オンにすると、その項目は画面の部品ではなくデータ・計算専用の部品になります。 中間計算・連携キー・並べ替え用の正規化値・打刻の裏付けなど、 「値としては必要だが画面に並べたくない」項目のための設定です。

• 全員に一律で効きます（アプリ管理者にも同じように出ません）。特定の人にだけ隠したい場合は「アクセス権」タブ > フィールドを使います
• 秘匿ではありません -- 値は API や CSV 取り込み、計算式から見えます。見せたくない値は必ずアクセス権（閲覧＝非表示）で守ってください
• 書き込み禁止でもありません -- 画面という入り口が消えるだけで、入力ルールや API からは書けます。書き換えを防ぐならアクセス権（新規追加・編集＝非表示）を併用します
• 必須とは併用できません（入力欄が出ないため、必須のままだとレコードを保存できなくなります）
• フォームの編集画面（フォームビルダー）には今までどおり表示され、バッジで区別できます

参照表示（別のフィールドの値を下に並べて表示する）

フィールド設定パネル下部の「高度な設定」を開くと参照表示を設定できます。 同じアプリの別のフィールドを選ぶと、そのフィールドの値が、設定したフィールドの入力欄・表示値の すぐ下にグレーの小さい文字で表示されます（値だけを見せる表示専用の行で、そこから編集はできません）。

• 表示される画面 -- 新規・編集フォーム、詳細画面、公開フォーム、一覧のセル
• 一覧では列見出しが 2 段になります -- セルごとにラベルを繰り返さず、列見出しに「出勤時刻」＋「(打刻)」の 2 段でラベルを出し、セルには値だけを上下 2 段で表示します
• 参照表示のラベル -- 既定では参照先の項目名がそのまま使われます。「出勤打刻」のような長い項目名で表示がくどくなる場合は、参照表示のラベルだけを「打刻」などに上書きできます（項目名そのものは変わりません）
• 値が未入力のときは表示されません -- 新規作成時など参照先が空なら行ごと出ません
• 参照先フィールドを削除した場合 -- 設定は残りますが、参照先が無いため何も表示されなくなります（エラーにはなりません）
• ビューごとに変えられます -- 一覧のビュー設定にある「表示」で、ビューごとに参照表示を出さないようにしたり、別の項目に差し替えたりできます（詳しくは「ビューとフィルタ」の「列の表示タイプ」）
• 選べないフィールド -- 自分自身、テーブル（サブテーブル）、システムが内部利用するフィールドは選べません

アクセス権との関係：参照表示は値の閲覧権にだけ従います。 参照先フィールドを閲覧できないメンバー（「アクセス権」タブ > フィールドで閲覧軸が「非表示」）には、 参照表示の行も出ません。一方、フォームに入力欄を出さないだけの設定 （「フォームでは非表示」プリセット、表示条件、入力ルールの自動セットで隠している場合）では、 参照表示はそのまま表示されます。同じ値が一覧・詳細では見えているため、隠す意味がないからです。

活用例：ヘルパー項目を画面から外し、参照表示としてだけ見せる -- 参照先フィールド（例：「打刻」）を「画面に表示しない」にするのが最もきれいな構成です。 入力フォーム・詳細画面・一覧の列すべてから打刻が消え、「出勤時刻」の下にグレーの参照表示としてだけ現れます。

打刻を書き換えられないようにする（完全形） -- 「画面に表示しない」は画面に出さないだけで、書き込み禁止ではありません。改ざんも防ぎたい場合は次の 3 点セットにします。

• 「画面に表示しない」を打刻フィールドに設定（画面という入り口を消す）
• 入力ルールで「作成時・出勤時刻を打刻にコピー・上書きモード」を設定（値はサーバー側で入る）
• アクセス権タブ > フィールドで打刻を 新規追加＝非表示 / 編集＝非表示 / 閲覧＝表示（プリセット「フォームでは非表示」）に設定（API から直接送られても拒否される）

この構成なら、一般メンバーが API を直接叩いて打刻に任意の値を入れようとしても保存が拒否され、 画面には出勤時刻の下に打刻がグレーで表示されます（閲覧は「表示」のままなので参照表示は出ます）。

※ 参照先を「画面に表示しない」にしない場合、詳細画面では参照先フィールド自体も （閲覧できる人には）通常どおり表示され、同じ値が 2 か所に出ます。気になる場合は 参照先フィールドをフォームの末尾やグループ（折りたたみ）の中に置いておくと目立ちません。

下書き・テスト・適用のフロー

フォームの変更は直接本番に反映されません。安全な3ステップで適用します。

プレビュー

ツールバーの 「プレビュー」 ボタンを押すと、実際のレコード登録／編集画面と同じ見た目で フォームを確認できます（入力はテストされず、保存もされません）。レイアウト・項目幅・セクション・ ステップフォームの見え方を、本番に適用する前にチェックできます。

• 「新規追加 / 編集」 切替 — 新規追加画面と編集画面で見え方が変わる場合 （ステップフォームが有効、または「新規時のみ入力」 等のフィールドアクセス権がある場合）にだけ表示されます。 変わらない場合は切替を出しません。
• 「視点」 切替（管理者 / すべてのユーザー） — フィールドアクセス権で見え方が変わるときだけ表示されます。 「すべてのユーザー」 を選ぶと一般メンバーから見たフォームを再現し、非表示フィールドは消え、 読み取り専用フィールドはロックアイコン付きで表示されます。管理者は実際のフォームでは全項目を編集できるため、 「管理者」 視点は全項目を表示します。詳しくは 「フィールドアクセス権」 を参照してください。

QR・バーコード読み取り

この機能を使うには、まずアプリの 設定 → 機能拡張 で「バーコード/QR スキャン」 を有効にします。有効にしていないと、以下で説明するフィールド設定の「QR・バーコード読み取り」 トグルは表示されません。

機能を有効にすると、テキスト・数値・リンク・ルックアップの各フィールドで、フィールド設定パネルの「QR・バーコード読み取り」 をONにできます。ONにすると、レコード入力フォームにカメラスキャンボタンが表示され、 タップするとカメラが起動し、読み取った値をそのフィールドに自動入力します。

• 対応コード -- QRコード、JAN/EAN-13、EAN-8、UPC、Code 128、Code 39、ITF（主要な1次元バーコード）
• 連続読み取り -- 「連続読み取り」オプションをONにするとカメラが開いたまま複数回スキャンできます（在庫入力など連続作業向け）
• 数値フィールドのバリデーション -- 数値フィールドへのスキャン結果が数値以外の場合は入力を拒否し、エラーを通知します
• ルックアップ連携 -- ルックアップフィールドでスキャンすると、読み取り値で検索を自動実行します。さらにルックアップの「コピー先フィールド」が設定されている場合は、スキャン確定と同時にマスタの関連項目（商品名・単価など）がレコードに自動コピーされます
• HTTPS 必須 -- カメラ機能はブラウザのセキュリティ要件により HTTPS 環境でのみ動作します（スマートフォン・タブレット推奨）

複数フィールドへの振り分け（1スキャン → 複数フィールド同時入力）:

フィールド設定の「複数フィールドに振り分ける」を有効にすると、1 回のスキャンで複数のフィールドに値を分割して入力できます。 たとえば RAXEL123|LOT55|20261231 のような区切り QR コードをスキャンすると、商品コード・ロット番号・賞味期限の 3 フィールドに自動入力されます。

• 抽出方法 — 全体: 読み取った値をそのまま対象フィールドにセット
• 抽出方法 — 区切り: 指定した区切り文字（|・タブ・改行・GS・RS など）で分割し、指定番目のセグメントを使用
• 抽出方法 — 桁指定: 開始位置と長さで部分文字列を切り出して使用
• 後処理: 各振り分けルールごとにプレフィックス除去・サフィックス除去・大文字小文字変換・前後スペース除去を設定できます
• 制御文字除去: GS1 複合コードなどに混入する制御文字を一括除去してから分割します（GS・RS 区切りを使う場合は除去 OFF）

サンプルアプリ「バーコード運用 (連続スキャン・項目振り分け)」の「商品コード(SKU)」フィールドに振り分け設定の例が入っています（| 区切りで 商品コード・ロット番号・賞味期限へ分配）。

AI で生成（フィールド単位）

この機能を使うには、まずアプリの 設定 → 機能拡張 で「AI で生成」 を有効にします（AI クレジットを消費する機能のため、既定は無効です）。

機能を有効にすると、テキスト・文字列（複数行）・リッチテキスト・数値・日付・日時・時刻・ドロップダウン・ ラジオボタン・チェックボックス・複数選択・リンクの各フィールドで、フィールド設定パネルの「AI で生成を有効にする」 をONにできます。ONにすると、レコード入力フォームのそのフィールドの横に ✨ ボタンが表示され、タップすると設定したプロンプトと参照フィールドの値をもとに AI が値を生成し、そのフィールドに入力します。

• プロンプト -- AI への指示文（必須、最大 2,000 文字）。「参照した情報から、丁寧な問い合わせ返信文を作成してください」のように、生成してほしい内容を具体的に書きます
• 参照フィールド -- 生成の材料にするフィールドを最大 10 個まで選択できます（対象と同じ 12 種類のフィールド型から選択可能。自分自身も選択できます）。実行時、選択したフィールドの現在の入力値がプロンプトと一緒に AI へ送られます
• ボタンのラベル -- 省略するとアイコンのみのボタンになります。文言を入れるとテキスト付きボタンになります（任意、最大 20 文字）
• 実行時のテキスト貼り付けを許可 -- ONにすると、ボタンを押したときにポップオーバーが開き、参照フィールドとは別に任意のテキスト（最大 8,000 文字）をその場で貼り付けて生成の材料に加えられます
• 実行時の追加指示を許可 -- ONにすると、ポップオーバーで「もっと簡潔に」のような追加の指示（最大 500 文字）をその場で入力できます

実行時のテキスト貼り付け・追加指示のいずれも許可していない場合、ボタンを押すと即座に生成が始まります （いずれか 1 つでも許可している場合は、先にポップオーバーで入力してから「生成」を押します）。 参照フィールドの値と貼り付けテキストが両方とも空のまま実行しようとした場合は生成できません（クレジットは消費されません）。 生成した値はフォームに入力されるだけで、レコードを保存するまで確定しません。フィールドに入力済みの値があった場合も、 生成直後に表示されるメッセージの「元に戻す」から生成前の値に戻せます。 クレジットの消費量の目安は AI機能 ページを参照してください。

プロンプトの書き方と例

フィールドの名前や参照フィールドの値は実行時に自動で AI へ渡されるため、プロンプトには「何をどう作るか」だけを書けば動作します。 「タスク + 出力形式 + してはいけないこと」の 3 点を書くのがコツです。

• 参照フィールドに出力先フィールド自身を含めるかどうかは「今入っている値を材料にするか」で決めます。校閲・整形のように現在の値を直す用途では自身を含めます（含めないと AI は対象の文章を見られません）。要約・分類のように他のフィールドから作る用途では含めません（含めると再実行時に前回の生成結果まで材料に混ざります）
• 参照フィールドが複数あるときは「『本文』を主材料に、『件名』は文脈の補足として使う」のようにフィールド名で役割を指定できます
• 「書かれていない情報を補わない」の一文を入れると、AI が事実を創作するのを防げます
• 出力の長さや件数の上限はプロンプトで明示してください（フィールドの文字数制限を超えると生成がエラーになります）
• 読み手や媒体ごとに文体を変えた出力が欲しい場合は、1 つのフィールドで使い分けるのではなく「紹介文（社内向け）」「紹介文（顧客向け）」のようにフィールドを分けてそれぞれに AI 生成を設定します（フィールドごとの値のスタイルが一定になり、一覧や出力でも扱いやすくなります）

フィールドタイプ一覧

各フィールドの詳しい設定方法は、以下のリンクから確認してください。

プリセット

フィールドパレットの「プリセット」タブには、よく使うフィールドの組み合わせがあらかじめ用意されています。 ドラッグまたはクリックで、設定済みのフィールドをまとめて追加できます。

セクション

フォームをセクション（区切り）で分けて整理できます。関連するフィールドをグループ化し、見やすいフォームを作成してください。

• セクションにはタイトルを設定できます
• フィールドをセクション間でドラッグ移動できます
• 空のセクションは削除できます

表示モード（通常 / タブ）

セクションごとに表示モードを切り替えられます。フィールド数が多いフォームでも、関連する項目をタブにまとめて切替表示することで、入力時のスクロール量を大きく減らせます。

• 通常 (縦並び)（既定） — セクションを上から順に常時表示。フィールド数の少ない単純なフォームに向きます
• タブ — 同じ「タブ」モードのセクションが 1 つのタブグループにまとめられ、タブで切替表示されます。「通常」と「タブ」を混在させると、「通常」セクション（常時表示）→ タブグループ の順で描画されます
• 各「タブ」セクションには タブ色（青 / 緑 / オレンジ / 紫 等）を設定でき、選択中タブのアンダーライン色に反映されます
• 設定は「フォーム編集」画面でセクションタイトル横の歯車アイコンから開きます。レコード詳細・追加・編集の各画面に共通で反映されます

サンプルアプリ「顧客名簿」で実例を確認できます。基本情報（通常）+ 連絡先 / 営業情報 / 取引履歴 / メモ（タブ）の混在例です。

ステップフォーム表示モード

アプリの「基本設定」タブで 「新規追加時にステップフォーム形式で表示する」 を ON にすると、新規追加画面（/add）で すべてのセクションが 1 ページずつ順に表示されます。項目数の多いフォームでも、回答者は今のステップに集中して入力でき、進捗バーで全体像を把握できます。

• 編集・詳細画面では通常表示で固定 — ステップフォームは新規追加の体験を整えるためのもので、編集や詳細閲覧では従来どおりセクションを上から並べた表示になります
• セクション設定が活きる — フォーム編集画面でセクションタイトル横の歯車アイコンから「ステップフォーム表示時の設定」を開き、ステップタイトル / ステップの説明 / ステップ完了メッセージ / 表示条件（条件分岐）を設定できます。これらはステップフォーム ON のときのみ反映されます
• 条件分岐でステップをスキップ — 表示条件を満たさないセクションはステップとして表示されず、進捗バーからも除外されます
• 公開フォームでも同等の機能を 「ステップフォーム」 として提供しています

条件分岐の運用例

• 個人 / 法人で分岐 — ステップ 1 のドロップダウン「種別」で「法人」を選んだときだけ、ステップ「会社情報」を表示する。「個人」を選んだ場合は会社情報ステップを丸ごとスキップして、回答者の入力負荷を最小化できます
• イベント申込での懇親会オプション — ステップ 1 でチェックボックス「懇親会に参加する」を ON にしたときだけ、ステップ「懇親会の情報（アレルギー・同伴者）」を表示する
• 採用応募でのポジション別質問 — ステップ 1 で応募ポジション（エンジニア / デザイナー / 営業）を選び、ステップ 2 以降は選択に応じた質問だけを順に出す

表示条件はアプリの「入力ルール」と同じ条件式を使えます。サーバー側でも条件を再評価するため、非表示にしたフィールド・セクションが必須でも保存をブロックしません。

制限事項

• 1つのアプリにつき、フィールドは500個まで配置できます（ラベル・罫線・スペースは含みません）
• フィールドコードはアプリ内で一意である必要があります
• フォーム変更は「適用」するまで本番に反映されません

フィールドコードの変更

本番に反映済みのフィールドのコードは、フィールド設定パネルでは読み取り専用です。 変更する場合はコード欄の隣の「変更…」ボタンから専用ダイアログを開き、影響を確認したうえで実行します。 テーブル内のサブフィールド・複合フィールドのメンバーのコードも同じ手順で変更できます。

• 変更はバックグラウンドで安全に実行され、レコードデータのキー・数式・ビュー設定・入力ルール・通知条件・メールテンプレート・帳票・公開フォーム/公開ビュー・他アプリの関連レコード集計/ルックアップ/データパイプラインの参照が自動で追従します。
• 実行前に影響サマリ (移行対象レコード数・書き換わる設定・他アプリへの影響) を確認できます。
• フォームビルダーに未保存の編集がある間は実行できません。ダイアログの「保存して続行」で下書きを保存してそのまま進むか、ページを再読み込みして編集を破棄してください。
• 実行中は、そのアプリへのレコードの追加・編集・削除・インポートとフォームの本番反映が一時的にブロックされます。進捗はフォーム設定とレコード一覧のバナーで確認できます。
• REST API / Webhook のペイロードのキー名も新しいコードに変わります。外部連携がこのフィールドのコードを参照している場合は、連携側の修正が必要です (API トークンや Webhook が設定されているアプリでは、ダイアログで強調して警告します)。
• レコードの変更履歴は書き換えません。過去の履歴には旧コードのままの項目が「(削除されたフィールド: 旧コード)」として表示されます。