ポータル（ホーム）

ポータルは、ログイン直後のホーム画面です。お知らせ、タスク、通知、アプリ一覧などを ウィジェット形式で自由に配置できます。複数のポータルを作成して切り替えることも可能です。

ウィジェットの種類

以下の種類のウィジェットをポータルに配置できます。

アクションボタンを設定できるのは対象アプリの管理者だけです。ボタンがセットする値は 「設定した人が決めた値」として書き込まれるため（項目ごとの編集権限では止まりません）、 対象アプリを管理できる人だけが設定できます。

アクションボタンウィジェットは「対象」→「状態」→「ボタン」の順に設定します。 まず対象アプリと「今のレコード」を引き当てる条件を決め、そのレコードが取りうる状態を並べ、 最後に各ボタンがどの状態で押せるかを選びます。状態は上から順に判定され、最初に一致した 1 つが採用されます。 採用された状態の名前がそのままバッジとして表示されるため、バッジは常に 1 枚です。

ボタンには「押せないときの扱い」を設定できます。出勤と退勤のように対になる操作は 「無効化して表示する」を選ぶと、状態が変わってもボタンの位置が動かず誤タップを防げます（押せない方はグレーアウトします）。単発の操作は「隠す」（既定）のままで構いません。 ボタンの色はプリセット12色（白文字が読みやすい濃色）またはカスタム色から選べ、ラベルには絵文字も使えます。色を指定しない場合はテーマの既定色（他の主要ボタンと同じ色）で表示されます。指定した色は「既定の色に戻す」で解除できます （例:「☕ 休憩開始」）。従ボタンに「コンパクト表示」を有効にすると小さく控えめになり、主ボタンとの階層を付けられます。

ボタンは既定で縦 1 列に並びますが、「ボタンの並び」で2 列を選ぶと横に 2 つずつ並びます。 「出勤・退勤」と「休憩開始・休憩終了」のように対になる操作が 2 組ある場合は、2 列にすると 2 行 2 列に収まり、 対の関係がひと目で分かります。2 列は「最大 2 列」の意味で、幅が足りないときは自動的に 1 列で表示されます（ウィジェットの幅を狭くしたときや、スマートフォンなど画面の小さい端末でも、ボタンのラベルが潰れません）。 判定は画面の大きさではなくウィジェット自身の幅で行われるため、広い画面でも幅の狭いウィジェットは 1 列になります。 2 列で使うときは、押せないときの扱いを「無効化して表示する」にしてください （「隠す」だと、押せないボタンが消えたときに残りのボタンが横方向にも詰めて位置が動きます）。

1 枚のカードに独立した状態が 2 系統以上ある場合（例: 同じ日次レコードで「体温報告」と「日報提出」を並行して管理する）だけ、 「状態系統を追加」で対象を増やします（最大 5 つ）。この場合はバッジも系統ごとに表示されます。通常は 1 つで足ります。

各状態には名前・アイコン・色を設定でき、採用された状態がボタンの上にバッジとして表示されます （例: 出勤前は「勤務外」、出勤後は「勤務中」に切り替わります）。 バッジを出したくない状態は「バッジを表示しない」を選べます。

アクションボタンがセットする値

ボタンの「セットする値」では、押したときに作成・更新するレコードへ書き込む値を項目ごとに指定します。 値の指定には次の3種類があります。

「別のアプリから引く」は、押した人ごとに決まっている値をボタンで記録したいときに使います。 たとえば社員マスタを「対応ユーザー ＝ 押した人」で検索し、その社員の勤務区分を日次の勤怠レコードに書き込む、といった使い方です。 ボタンは押す人が値を選べないため、この指定がないと項目が空のまま作られます。 勤怠に限りません。問い合わせ受付で押した人の所属部署を記録する、申請の受付でその人の上長を自動で入れる、といった使い方も同じ仕組みです。 設定は「どのアプリから」「押した人と照合する項目」「書き込む値の項目」の3つを選ぶだけです。

• 照合する項目は「重複禁止」にしてください — 参照先で同じ人の行が2件以上あるとどれを引くか決められないため、値は書き込まれません。照合に使う項目（社員マスタの「対応ユーザー」など）の フィールド設定で「重複禁止」を有効にしておくと、誤って同じ人を2行に登録した時点で保存が止まり、 後から打刻の値が入らない形で気付く事態を防げます。設定画面でも、重複禁止になっていない項目を選ぶと注意書きが出ます
• 引けなかったときは値が空のまま作られます — 参照先に自分の行が無い、値が空欄、 または行が複数見つかった場合は、その項目だけが空になります。 打刻や記録そのものは成立し（操作が止まることはありません）、押した人には「引けませんでした」という警告が表示されます
• 書き込まれる値はその時点のコピーです — 後から参照先のアプリを書き換えても、 過去のレコードは書き換わりません（先月の勤務区分が後から変わると、確定済みの集計が崩れるため）
• 選べる項目は自動的に絞られます — 照合する項目は「複数選択ではないユーザー項目」だけ、 書き込む値の項目は書き込み先と同じ形の値を持つ項目だけが候補に出ます （文字列の項目に数値を書き込む、といった組み合わせは選べず、保存もできません）
• 同じ項目に 2 つ以上の値は指定できません — 1 つのボタンで同じ項目に複数の値を並べると、 どちらが書き込まれるかが決まらないため保存時にエラーになります。 どれか 1 つに絞ってください（別のボタンが同じ項目を書くのは問題ありません）
• 動作が「フォームを開く（初期値入り）」のボタンでは使えません（フォームを開く時点では参照先を検索できないため）

行の操作（サブテーブル）

ボタンの動作が「レコードを更新」のとき、「セットする値」で通常の項目に書き込むのに加えて、サブテーブルに行を追加したり、条件に一致する行を更新したりできます。 休憩の1回目は専用フィールド、2回目以降はサブテーブルの行、といった記録方法を組み立てられます。

例えば打刻カードの「休憩開始（2回目以降）」ボタンは休憩サブテーブルに行を追加し、「休憩終了（2回目以降）」ボタンは「終了が空の行」を探して終了時刻を書き込みます。

• 条件に一致する行が複数ある場合は、最後の行が更新されます
• 条件に一致する行が無い場合はエラーになります（黙って何も起きない、ということはありません。押した人にはエラーが表示されます）
• 同じボタンを連打しても、押した時点でレコードの状態がすでに変わっていれば「状態が変わりました」と表示され、二重に書き込まれることはありません

時計ウィジェットは枠のないシンプルな表示（日付＋大きな時刻）で、他のウィジェットと組み合わせて使います。 例えば、打刻・点検・受付など時刻の記録を伴う操作のカードの真上に配置すると、見出しのように一体感のある見た目になります。 記録される時刻はサーバー側で確定するため、端末の時計のずれは記録に影響しません。

ポータルの編集（管理者向け）

管理者は「管理」→「ポータル管理」からポータルを作成・編集できます。

• 作成 — 「ポータルを作成」でポータルを追加（複数ポータルを持つことも可能）
• 編集 — 編集ボタンからウィジェットの追加・削除・並び替え・設定変更
• デフォルト設定 — 星アイコンでデフォルトポータルを設定（ホーム画面で最初に表示される）
• 削除 — ゴミ箱アイコンで削除（最後の1つは削除不可）

ポータルエディタ

2カラムレイアウト（左カラム・右カラム）でウィジェットを配置します。

• 各カラムで「ウィジェットを追加」ボタンをクリック
• ウィジェットをクリックして設定パネルを開く
• 種類・タイトル・配置カラム・表示件数などを設定
• 矢印ボタン（↑↓）で順序を入れ替え
• 「保存」で反映

複数ポータルの切替

複数のポータルが作成されている場合、ホーム画面の上部にタブが表示され、クリックで切り替えられます（1 つだけのときはタブは出ません）。 部署ごと・役割ごとに異なるポータルを用意しておき、組織ごとに最初に開くポータルを指定できます。

• アプリの権限が無いウィジェットは表示されません。レコード一覧・グラフは対象アプリを見る権限が無い人には出ず、アクションボタンは対象アプリに書き込む権限が無い人には出ません。残りのウィジェット（リッチテキスト・時計・お知らせ・通知など）は誰にでも表示されます
• ポータルそのもの（タブ）は全員に並びます。組織ごとに変わるのは「最初に開くポータル」だけで、他のポータルが見えなくなるわけではありません（ポータル単位の公開範囲設定はまだありません）
• 作成できるポータルは1 つの契約につき 30 個までです。パッケージの導入がポータルを作ることもあるため、上限に達すると導入が失敗することがあります

デフォルトポータル

初回アクセス時に、お知らせ・タスク・通知・アプリ一覧の4つのウィジェットを含むデフォルトポータルが自動生成されます。 管理者はこれをカスタマイズするか、新しいポータルを作成して代わりに使用できます。

レシピ: 打刻ボタンを作る

アクションボタンウィジェットのテンプレートを使うと、出勤・退勤を1タップで記録するボタンを作成できます。 ウィジェットを追加して種類を「アクションボタン」にしたら、以下の手順で設定します。

テンプレートはよくある構成を例として初期投入するものです。投入後の内容はすべて編集でき、 テンプレートを使わず一から設定することもできます。

1. 対象アプリを選ぶ — 日付（日付型）・出勤時刻／退勤時刻（いずれも日時型）・従業員（ユーザー選択型）を持つ 勤怠アプリを指定します。出勤・退勤の打刻には「現在日時」を自動セットするため、 出勤・退勤のフィールドは時刻型ではなく日時型で用意してください
2. テンプレート「打刻（出勤/退勤）」を選ぶ — 「テンプレートから作成」欄のボタンをクリックすると、 フィールドの割り当てダイアログが開きます
3. 役割ごとにフィールドを選ぶ — 「日付」「従業員」「出勤時刻」「退勤時刻」の4つの役割に、 対応する型を持つフィールドを割り当てます。該当する型のフィールドがアプリに1つしか無い役割は自動で選択されます。 同じ型のフィールドが複数ある場合（出勤時刻・退勤時刻のように日時型が2つある場合など）は、 どちらを割り当てるか誤って自動選択されることはなく、必ず自分で選びます。「休憩開始」「休憩終了」は任意で、割り当てると休憩の打刻ボタンも一緒に作られます（未割り当てなら出勤・退勤のみ）。 「休憩開始」「休憩終了」に加えて休憩を記録するサブテーブルとその中の開始・終了の2項目（いずれも任意）まで割り当てると、「休憩開始（2回目以降）」「休憩終了（2回目以降）」のボタンも一緒に作られます （1回目の休憩は専用フィールド、2回目以降はサブテーブルの行として記録されます。上記「行の操作」を参照）。 必須の役割を選び終えると「投入」ボタンが押せるようになります
4. 投入して保存 — 「投入」を押すと状態とボタンが割り当てたフィールドで組み立てられます。 共通条件・状態・ボタンの内容を確認して保存してください

保存すると、状態に応じて押せるボタンが切り替わります（休憩ありの場合）。

4つのボタンは常に同じ位置に並び、押せないものはグレーアウトします（「無効化して表示する」が既定で入ります）。 休憩中は退勤が押せません（休憩を終えてから退勤する運用）。上記の表は休憩を1日1回だけ記録する基本形です。 休憩を2回以上取る運用では、「休憩開始（2回目以降）」「休憩終了（2回目以降）」の2ボタンを追加できます（上記「役割ごとにフィールドを選ぶ」を参照）。

実働時間を自動計算したい場合は、勤怠アプリに計算フィールドを追加し、MINUTES_BETWEEN(clock_in, clock_out) のような数式で出勤・退勤の時刻差を計算します。

日々の打刻はこのアクションボタンで、月の一覧・打刻漏れの確認はマトリクスビューで行うと役割分担がはっきりします。作成手順はマトリクスビューのページの「レシピ: 勤怠アプリのタイムカード一覧を作る」を参照してください。

打刻以外のテンプレート

「テンプレートから作成」には打刻・日報提出のほかに、次の2つのテンプレートがあります。 いずれも手順は打刻と同じで、テンプレートを選ぶとフィールドの割り当てダイアログが開きます。

会議室・共用備品の貸出管理や、設備の日次点検記録など、打刻と同じ「状態に応じてボタンが切り替わる」体験を 勤怠以外の業務にも適用できます。