ビューとフィルタ

ビューは、レコード一覧画面の表示種別（一覧 / カレンダー / カンバン / ガント / ピボット など）と表示条件（フィルタ・ソート・表示列）を組み合わせて保存したものです。 用途ごとにビューを作成しておくと、必要なデータにすぐアクセスできます。

ビューとは

同じアプリのデータを、異なる視点で見るための「プリセット」です。 レコード一覧画面のドロップダウンから切り替えて使います。

アプリを作成すると、自動的に「すべてのレコード」という一覧ビューが 1 つ用意されます。 ここを起点に、必要に応じてビューを追加していきます。

ビューの種別

ビューには次の種別があります。同じアプリ内に複数の種別を混在させて作れます。

一覧 / カレンダー / カンバン / カード / ガント / ピボット / マトリクス / リソースタイムライン はレコードページ上部のビュー切替ドロップダウンに並びます。 グラフは専用の「グラフ」タブに分かれます。

ビューの作成手順

用途に応じて 2 通りの作り方があります。

1. 簡易作成 -- レコード一覧画面でフィルタ / ソート / 表示列を整えてから、 ツールバーの「ビューとして保存」をクリック。ボタンは設定を変更すると現れます（変更が無いときは表示されません）。表示中のビューはそのまま残るので、既存のビューを壊さずに派生を作れます。 新しいビューの種別は見ているビューと同じになります（カレンダーを見ながら保存すればカレンダービュー）。 アプリ管理者のみ表示されます。
2. 詳細作成 -- アプリの「設定」→「ビュー」（/apps/[appId]/settings/views）から 「新規ビュー」を選び、種別（カレンダー / カンバン / ガント 等）と設定項目をまとめて指定します。 一覧以外の種別は、原則こちらから作成します。

ビューの操作

ビューの作成・編集・削除・並べ替えはアプリ管理者のみが実行できます。 一般メンバーは、自分が閲覧できるビューの切り替えのみ行えます。

ビューごとの閲覧権限

各ビューには「誰がそのビューをドロップダウンに表示できるか」を設定できます。 ビューの設定画面で次のいずれかを選びます。

• 組織 -- 指定した組織またはその子組織に所属するメンバー
• グループ -- 指定したグループに所属するメンバー
• メンバー -- 個別に指定したユーザー

いずれか 1 つに該当すれば表示されます（OR 判定）。 管理者向けの内部用ビューや、特定チームだけが使う集計ビューを分けたいときに使います。

閲覧権限はドロップダウンに出すかどうかを制御するもので、 レコード自体のアクセス権はアプリ・レコード・フィールドの 3 層の権限機構で別途制御されます。

ビューに保存される設定

表示件数（1ページあたりの件数）はビューに保存されません。 表示件数は個人の好み（画面サイズ等）に依存するため、ユーザーごとに自由に変更できます。

フィルタ条件

フィールドの値に基づいてレコードを絞り込みます。ツールバーの「フィルタ」ボタンから設定します。

AND: すべての条件に一致するレコードを表示。OR: いずれかの条件に一致するレコードを表示。

ワークフローを有効にしたアプリでは、条件の項目に実フィールドと並んで「ワークフローのステータス」が現れます。 「承認済みだけを表示する一覧」のようなビューはこれで作れます（演算子は ＝ と ≠ の 2 つ。 複数のステータスを許すときは結合を OR にして条件を並べます）。 一覧のツールバーにもステータス絞り込みがありますが、そちらはその場限りでビューには保存されません。 カンバンビューは保存されたフィルタを読まない設計のため、この条件はカンバンには効きません（カンバンは列の分類にステータスを使います）。

フィルタが適用中は、一覧上部にフィルターチップ（青いタグ）が表示されます。 各チップの「×」で個別解除、「すべて解除」で全解除できます。

フィルタはすべての種別（一覧 / カレンダー / カンバン / ガント）で共通に動作し、 対象のレコードを絞り込んでから種別ごとの方法で描画します。

ソート

レコードの並び順を指定します（主に一覧ビューで使います）。ツールバーの「ソート」ボタンから設定します。

• 複数フィールドでの多段ソートに対応（最大5件）
• 第1ソート→第2ソートの順に適用されます
• 列ヘッダーのクリックでも簡易ソートが可能（レコード番号列を含む）

表示列の設定

ツールバーの「列」ボタンから、一覧に表示するフィールドを選択できます。チェックが入っている項目が表示列です。

• チェックのON/OFFで即座に列の表示/非表示を切替（表示列は最低 1 つ必要 — 最後の 1 列は外せません）
• フォームに新しく追加したフィールドは、既定で自動的に一覧にも表示されます。逆に一度非表示にした列は、他のフィールドが追加された後も非表示のまま維持されます（「隠した列だけ」を覚える方式のため）
• 複合フィールドの結合列（「結合表示」バッジが付く列）は通常のフィールドと逆で、既定は非表示。チェックを入れて選んだときだけ一覧に追加されます
• 列ヘッダーの右クリックメニューからも「この列を非表示」が可能
• 「列」ポップオーバーでのチェック変更はその場限りの一時的な表示切替です。ページを離れたり別のビューに切り替えると元に戻ります。ポップオーバー上部の「ビューの設定に戻す」で、選択中ビューの保存済みの列設定にいつでも戻せます
• 一時的な変更を残したい場合は、ツールバーの「保存」（既存ビューの上書き）または「ビューとして保存」（新規ビュー）で確定します

列の表示タイプ（参照表示の制御 / タイムラインバー）

ビュー設定（歯車アイコン）の「表示」で、列ごとに見せ方を切り替えられます。 同じフィールドでも、ビューによって「値だけを出す」「時間帯を横棒で出す」といった出し分けができます。

参照表示をビューごとに制御する

フィールド設定の参照表示（値の下にもう 1 つの項目をグレーの小さい文字で並べる機能）は、 ビュー側で上書きできます。

• 一覧では列見出しの下段に参照先の項目名（またはラベル）が出て、各行のセルには値だけが並びます
• 値を閲覧できない項目は、ビューで指定しても表示されません（アクセス権が優先）

タイムラインバー

時刻の範囲フィールドの列は、値の文字列（例: 09:00〜18:00）ではなく時間軸上の横棒で表示できます。勤務時間帯や予約枠のように「いつからいつまでか」を 行同士で見比べたいときに使います。

• 列見出しには時刻の目盛りが並びます。目盛りの細かさは列の幅に応じて自動で切り替わり（1 / 2 / 3 / 6 / 12 時間刻み）、列を広げるほど細かくなります
• 各行のセルにも目盛りと同じ位置に薄い縦線が入るので、バーの開始・終了を目で追えます
• 24 時を超える軸では、目盛りは翌日の時刻として表示されます（25:00 は「1」）
• この列は幅を広げて使うことを前提にしています。既定では画面の余りを使って伸縮し、狭い画面でも読める幅（320px 相当）は確保されます。もちろん幅を固定することもできます（下の「列幅」を参照）
• 値が空の行にはバーを描きません。開始と終了が逆転している値や、軸から完全に外れる値も描画されません

列幅の決まり方と調整

一覧の列幅は、次の順で決まります。上にあるものが優先されます。

1. 自分で調整した幅 -- ドラッグや自動調整で決めた幅。ユーザーごと・アプリごとに保存され、次回も同じ幅で開きます
2. ビューの既定幅 -- アプリを管理できる人が、そのビューの標準として保存した幅
3. 項目の種類ごとの標準幅 -- 日付・時刻・数値・選択肢などは内容が収まる幅、文字列やリンクのように長さが決まらない項目は残りの幅を分け合って伸縮します

• 1 つでも幅を調整すると、そのときの見た目のまま固定されます（他の列が急に動かないよう、表示中の幅をそのまま引き継ぎます）
• 伸縮させている列の境界をドラッグすると、その時点の幅で固定に切り替わります
• 列幅の合計が画面に収まらない場合は横スクロールになります（各列がつぶれて読めなくなることはありません）

ビューの既定幅として保存する（アプリを管理できる人）: 列ヘッダーの右クリックメニューに「現在の列幅をこのビューの既定にする」 「ビュー既定の列幅をクリア」が表示されます。 自分で調整した幅と伸縮の指定をそのビューの標準として保存でき、 まだ幅を調整していないメンバーはその幅で一覧を開きます （個々のメンバーが後から調整した幅のほうが優先されます）。

条件付き書式

条件に応じてレコード行の背景色を変更し、視覚的にデータを区別できます。設定はアプリの「設定」→「条件付き書式」タブから行います。

適用の優先順位:

1. ビューに個別の条件付き書式が設定されている場合 → そのルールを適用
2. ビューに個別設定がない場合 → 「デフォルト（全件表示）」のルールにフォールバック
3. ビューで「条件付き書式を使用しない」が有効な場合 → デフォルトも含め一切適用しない

• フィルタと同様の条件式でルールを定義
• 複数ルールが該当する場合は、上位（優先度の高い）ルールが適用されます
• 色はプリセットから選択（赤、黄、緑、青、紫、グレーなど）

一覧画面のその他の操作

一覧のスキャンアクション（バーコード / QR コード読み取り）

一覧ビューの設定でスキャンアクションを有効にすると、ツールバーにスキャンボタンが表示されます。 カメラや外付けリーダーでバーコード / QR コードを読み取ると、指定したキーフィールドの値で一致レコードを検索し、設定した操作を自動実行します。

• 設定場所: ビュー設定（歯車アイコン）→「スキャンアクション」セクションで有効化・キーフィールドを指定
• アクション — 開く: 一致レコードの詳細画面を即座に開く
• アクション — 更新: 数値フィールドを自動で増減（固定量 or スキャンごとに数量入力。マイナス量で出庫）、またはフィールドに値をセット（複数項目を同時に設定可）
• アクション — 新規作成: スキャンするたびに新規レコードを作成。キー項目にスキャン値、他の項目は下記「値の決め方」で初期値を設定。作成前の確認ダイアログの表示有無、同じキーが既にある場合の動作（そのまま作成 / 警告してスキップ / 既存を開く）を選べます
• フィードバック表示項目: 更新・作成時のトーストに「どのレコードか」を示す項目（商品名など）を指定。未設定ならキー項目の値を表示
• 一致なし（開く / 更新）: 「該当なし」を通知。「新規作成」ボタンを有効にすると、スキャン値を入力済みで新規レコード作成画面へ移行（新規作成アクションを使わない場合の補助導線）
• 複数一致: 候補リストから目的のレコードを選択して操作を続行
• 連続スキャン: 同じ値の連続読み取りはデバウンスで重複排除。在庫の入出庫ループなど繰り返し操作に対応（数量更新は同時スキャン時も正確に反映）
• 対応コード: QR コードのほか、JAN/EAN-13・EAN-8・CODE128・CODE39・ITF・UPC などの 1 次元バーコードに対応

値の決め方（更新・新規作成でフィールドに値をセットするとき）:

• 定数: 設定時に決めた固定値をセット（例: ステータス →「出荷済み」）
• スキャン時に入力: スキャンするたびにダイアログで値を入力（例: ロット番号・棚番を毎回手入力）
• 動的値: スキャン時点で自動算出した値をセット — 今日（日付項目）/ 現在日時（日時項目）/ 現在ユーザー（ユーザー選択項目に、スキャンした本人を記録）

照合キーの前処理:

ビュー設定の「スキャンキー前処理」を使うと、読み取った値をレコード検索に使う前に加工できます。 ラベルプリンタが出力する SKU:RAXEL123 のようにプレフィックスが付いたコードも、プレフィックスを除去して RAXEL123 で正しく照合できます。

• 制御文字除去: バーコードに混入した C0 制御文字（GS・RS など）をまとめて削除
• プレフィックス除去: 指定した文字列で始まる場合にその部分を除去（例: SKU: を除去）
• サフィックス除去: 指定した文字列で終わる場合にその部分を除去
• 区切り文字で分割して特定セグメントを取得: 複合コードの一部だけを照合キーに使用（例: | で分割して先頭セグメントを使用）
• 桁指定: 開始位置と長さで部分文字列を抽出（例: 先頭 8 文字のみ）

ルックアップ項目をキーにしたスキャンとマスタ自動コピー:

スキャンのキーフィールドにルックアップ項目を指定すると、スキャン結果でマスタを照合するだけでなく、 ルックアップに設定された「コピー先フィールド」の値（商品名・単価など）がサーバー側で自動的にレコードにコピーされます。 フォームでのスキャン（即コピー）も、一覧スキャン作成・更新（サーバー側コピー）も同じ仕組みが働くため、 手入力なしでマスタの最新情報をレコードに反映できます。

体験用に、サンプルアプリ「バーコード運用 (連続スキャン・項目振り分け)」（アプリストアから導入）に、入庫（数量+1）・出庫（数量入力）・棚卸し（値セット）・新規登録・在庫照会（開く）の各ビューを用意しています。 「在庫照会（開く）」ビューでは SKU:RAXEL123 をスキャンすると SKU: を除去してから照合する前処理が設定済みです。 フォームの入力欄（商品コード・ロット・棚番）にもスキャンボタンを表示します。 また「在庫管理（商品マスタ連携）」サンプルアプリの「在庫管理」アプリには、「スキャンで入荷登録」ビューを用意しています。 商品コード（P001〜P010）をスキャンすると新規レコードが作成され、商品マスタから商品名・カテゴリ・単価・発注点が自動コピーされます。

リソースタイムライン（行 = リソース × 時間軸）

人・部屋・設備などを行にして、横軸の時間の上にレコードを横棒（バー）で並べるビューです。 シフト表、会議室・設備の予約表、当日の稼働状況のように 「誰（何）が・いつ・どれだけ埋まっているか」を一望したい場面で使います。

• レコードが 1 件も無い行も表示されます。空いているリソースが見えることが、このビューの主な価値です
• 同じ行で時間が重なるレコードは上下に積んで表示されます（重なり = 二重割当のサイン）
• 横棒をドラッグすると、時間や割当先を一覧画面のまま変更できます

マトリクス / ガントとの使い分け

ガントは「1 行 = 1 レコード」で工程の前後関係を見るためのもの、 リソースタイムラインは「1 行 = 1 リソース、1 行に何本でもバーが載る」割付管理のためのものです。 同じアプリに両方作って、目的で使い分けられます。

横軸の 2 つのモード

ビュー設定の「横軸の単位」で切り替えます。切り替えると、そのモードで使わない設定項目は自動的に外れます。

• 時間帯モードの「時間軸の範囲」は既定 0:00〜24:00 です。終了側の「翌日」を入れると、夜勤のように日をまたぐ軸（例: 5:00〜翌 5:00）にできます
• 日付モードで日時の項目を使う場合、位置は日単位に丸めて表示されます。ドラッグしても時刻の部分は変わりません（日付だけがずれます）
• 表示範囲の外まで続くレコードは、横棒が画面の端で切れて表示されます。切れて見えるだけで、保存されている値は切り詰められません

行（リソース）の決まり方

ビュー設定の「行にする項目（リソース）」で指定します。指定できる項目の種類は 3 つです。

• 行にする項目の値が空のレコードは、最下段の「未割当」行にまとまります。未割当行のバーを担当者の行へドラッグすれば、そのまま割り当てられます
• 行が多い場合は先頭 50 件までを表示し、上部に「行は先頭 50 件のみ表示しています」と出ます
• 選択肢が 0 件だったり、参照先の閲覧権限が無い場合は、その旨のメッセージを表示します（無言で空にはしません）

横棒（バー）の操作

• 少し動かしただけ（クリックとの区別がつかない程度）では保存されません。詳細を開くつもりのクリックで値が変わることはありません
• 保存されるのは実際に変わった項目だけです。開始 + 終了の 2 項目形式で右端だけを動かした場合、送られるのは終了の項目だけです
• 保存後は再読み込みを待たずに移動後の位置で描画されます。保存に失敗した場合は元の位置に戻り、メッセージが出ます

重なりと「重複を禁止」との連携

同じ行で時間が重なるバーは上下に積まれるため、二重予約・二重割当がその場で分かります。 さらに、元になっている範囲フィールドで「重複を禁止」を有効にしていると、 重なる位置へのドラッグは保存が拒否されます（「この期間は既に埋まっています」）。 バーは元の位置に戻ります。

• 重複の判定範囲（同じ部屋どうし・同じ担当者どうし等）は、範囲フィールド側の設定に従います
• 別の行へ移して重なりが解消される場合は、そのまま保存できます
• ロック期間内のレコードや、ワークフローで編集が制限されているステータスのレコードは、ドラッグしても保存されません（通常の編集と同じ制限が働きます）

ドラッグできない場合

次のいずれかに当てはまるバーは掴めません（クリックで詳細を開くことはできます）。

• アプリでレコードの編集権限が無い
• そのレコードが編集できない（レコード単位のアクセス権）
• 時間 / 期間の項目が閲覧のみ（フィールド単位のアクセス権）。行の項目が閲覧のみの場合は、時間は変えられても行間の移動だけできません

スマートフォン・タブレットでは閲覧のみです（横スクロールで確認できます）。 値の変更はレコードの詳細画面から行ってください。

次の場合は、盤面が不完全になるため表示や編集を止めます（誤った「空き」を見せないため）。

• 行や期間に使っている項目が権限で閲覧できない場合は、表そのものを表示しません
• 表示範囲のレコードが2,000 件を超える場合は警告を出し、ドラッグでの変更とダブルクリックでの新規作成を停止します（フィルタで絞り込んでください）
• 行に指定した項目の値が、行の対象（選択肢・グループ / 組織のメンバー・参照先レコード）に含まれないレコードは表示できません。件数を表の上に注記します