Skip to content

Latest commit

 

History

History
139 lines (102 loc) · 5.72 KB

File metadata and controls

139 lines (102 loc) · 5.72 KB

Field — 一覧と概念

Field は Module を構成する部品です。TextField・NumberField のような入力部品、Label・Button のような UI 部品、List や Module のような構造部品まで、画面と値の最小単位として振る舞います。

Field の性質

  • 大部分の Field は値を持つ
  • DB とマッピングすると、モジュールが ORM の Entity のように振る舞う
  • 多くの Field はUI を持ち、レイアウト(Grid / Canvas / Flow)に配置できる
  • UI を持たずデータ保持だけに使う Field もある
  • スクリプトから名前で直接参照でき、プロパティ・メソッドを呼び出せる

System Field — 特別な役割を持つ Field

名前で役割が決まる Field です。ツールボックスからドラッグで作成し、名前は変更できません。DB 業務アプリで必要になる機能に対応します。

名前 種別 役割
Id Id モジュールのデータを特定する主キー(追加・更新・削除に必須)
LogicalDelete Boolean 論理削除のフラグ
CreatedAt DateTime 作成日時
UpdatedAt DateTime 更新日時
Creator Link 作成者(CurrentUserModule 設定時)
Updater Link 更新者(CurrentUserModule 設定時)
OptimisticLocking OptimisticLocking 楽観ロック

このほか、削除時にレコードを別テーブルへ退避してから物理削除する予約名 DeleteArchive の System Field があります。詳細は DeleteArchive を参照。


DB Field — DB のカラムから自動生成

Module に Data Source を設定すると、ツールボックスに「DB フィールド」リストが出ます。そこからドラッグ&ドロップで Field を追加すると、DB 列の型と名前に応じた Field が自動生成されます。

  • 名前は DB 定義名をパスカルケースに変換したもの
  • 名前は変更可能(ただし System Field の名前は使えない)
  • System Field の名前と DB 列名が合わない時は、先に System Field を作って DbColumn で列を指定

Field 一覧(系統別)

共通事項

入力系

Field 用途
Text 文字列入力(1 行/複数行)
Number 数値入力(最小・最大・スライダー対応)
Boolean 真偽値(チェック/スイッチ/トグル)
Date 日付のみ
DateTime 日時
Time 時刻のみ
Password パスワード(確認入力チェック付き)
File ファイルアップロード(画像プレビュー対応)

選択系

Field 用途
Select プルダウン選択(他モジュールから候補取得可)
RadioGroup ラジオボタンのコンテナ
RadioButton 個別のラジオボタン
Link 他モジュール 1 件を検索ダイアログで選択

表示系

Field 用途
Label 文字列の表示(見出し・キャプション)
AnchorTag ハイパーリンク
Id 主キー/外部キー
ImageViewer 画像表示
MarkupString HTML 直接表示

構造系

Field 用途
List 一覧(テーブル形式)
DetailList 一覧(カード形式、縦並び)
TileList 一覧(タイル形式、折り返し)
ListNumber 一覧内の行番号列
ListPaging リストのページャーを独立配置
Module 他モジュールを画面内に埋め込む
Search 検索バー

操作系

Field 用途
Button 独自スクリプトを実行
SubmitButton 登録・更新の標準ボタン
AutoSubmit 変更を自動で保存
CopyModuleButton 現在のデータをコピーして新規作成
ViewEditToggleButton 参照/編集モードを切り替え
ContextMenu 右クリックメニュー

メニュー系(PageFrame 連携)

Field 用途
HeaderMenu / SidebarMenu カスタムヘッダー/サイドバー内で標準メニューを取り込む

特殊

Field 用途
ProCode 独自の Blazor コンポーネントを埋め込み
OptimisticLocking 楽観ロック(System Field)
DeleteArchive 削除時にレコードを退避テーブルへ移す(System Field)

DB 系(データベースセクション参照)

Field 用途
Query カスタム SQL で一覧を作る
ExecuteSql 任意の SQL を実行する
Json 複数の値を JSON でまとめて 1 列に保存

廃止

Field 備考
ModuleSelect 最新バージョンには存在しません(代替については各ページ参照)

関連項目