Codeer.LowCode.Blazor.Extras.Server 0.17.1

Codeer.LowCode.Blazor.Extras

Codeer.LowCode.Blazor に高機能UIコンポーネントと、 アプリケーション開発でよく使うクライアント/サーバーサービスを追加する拡張ライブラリです。 ソースは MIT で公開しているため、動作を変えたい場合はクラスを丸ごと差し替えたり、ソースをコピーして改変できます。

パッケージ構成

提供フィールド

一覧の見出しに置く部品

一覧レイアウトの見出しセルの「プロコード」(ListElementComponent) に指定して使う部品です。

認証 (ログイン)

Codeer.LowCode.Blazor 本体が持つのは認可だけで、認証 (ログイン) はライブラリに含まれません。認証はホストアプリの担当で、その実装をこの Extras が MIT で提供します。 セッションは Cookie、ログインアカウントの宣言はユーザーモジュールの契約フィールド。パスワード / Entra ID / Google / AWS Cognito / OpenID Connect / 二要素認証のどれでログインしても、本体の認可 (CurrentUser・モジュール / 行 / PageFrame の条件) は変わりません。

業務機能

いずれもデザイナの Tools > メールのセットアップ / 承認フローのセットアップ / 編集履歴のセットアップ / 監査ログのセットアップ (または CLI の mail-setup / approval-setup / edit-history-setup / audit-log-setup) で 必要なモジュール群 (監査ログは閲覧モジュールとテーブル作成 DDL) を生成できます。

スクリプトオブジェクト

スクリプト (*.mod.cs) から利用できるサービス・型です。ExtrasClientInitializer.Initialize で一括登録されます。

各オブジェクトの正確なシグネチャと使用例は、デザイナの入力補完、またはデザイナ CLI の script-catalog サブコマンドが生成するカタログで確認できます。

クライアントサービス

アプリテンプレートの DI に登録して使う実装です。インターフェース (IHttpService / IToastService 等) で 登録するため、自前実装への丸ごと差し替えができます。

• HttpService — ローディング表示・エラー通知付きの HTTP 通信ラッパー
• UIService — ファイルダウンロード・通知トースト
• Logger — ブラウザコンソール + トースト通知のロガー
• ToastService — Sotsera.Blazor.Toaster ベースのトースト実装
• LocalizeService — TSV リソースによるローカライズ

サーバーサービス (Codeer.LowCode.Blazor.Extras.Server)

• AITextAnalyzeService — Azure Document Intelligence + Azure OpenAI による帳票・テキスト解析 (AITextAnalyzerField のサーバー側)
• AI チャット — AIChatService (AIChatField の受け口。送信をバックグラウンドの Agent に渡し、ポーリングに状態を返す) と標準 Agent の RawDataAccessAgent (アプリの設計を読み、DB を SQL で読んで集計・グラフで答える)。独自の Agent は IAIChatAgent で追加。AIChatField
• 意味検索 — SemanticSearchService (SemanticSearchField のサーバー側。保存時に行の文章へ埋め込みベクトルを付け、再索引をジョブで実行し、AI チャットに search_records ツールを提供)。埋め込みモデルは IEmbeddingProvider (Azure OpenAI 実装を同梱。独自実装で差し替え可)。類似度の計算は DB 側 (PostgreSQL pgvector / SQL Server 2025)。SemanticSearchField
• 認証 — LoginAccountStore (ID/パスワード照合・ユーザー行の解決) / 外部 IdP (OidcLoginProvider と Entra / Google / Cognito 実装) / TotpLogin・EmailOtpLogin (二要素認証)。認証の全体像
• メール送信 — MailDispatcher (テンプレート解決・一斉送信・送信履歴) と SMTP / Microsoft Graph / SendGrid / Gmail API 送信。独自の送信手段は IMailSender で追加
• 承認フロー — ApprovalEngine (状態遷移の検証と実行)
• 編集履歴 — EditHistoryRecorder (本体の IO インターセプタ。ModuleDataIO の派生 (テンプレートの CustomizedModuleDataIO) で AddInterceptor(new EditHistoryRecorder(designData)) と登録すると、保存時の記録・復活と、版の内容を読む人の権限に落とす処理の両方に効く)。編集履歴
• 一括ファイル入出力 — BulkFileTransfer (一覧の一括ダウンロード / 一括更新とスクリプトの入出力の処理本体。ModuleDataController から移譲する)、CsvUtils (CSV の生成 / 解析)。一括ファイル入出力
• StorageAccess / TemporaryFileManager — ファイルストレージ (ファイルシステム / Azure Blob / Amazon S3 (S3 互換含む)。独自の保存先は IFileStorage で追加) と一時ファイル管理。FileStorage
• CustomFontResolver — Excel PDF 変換用のフォントリゾルバ
• 監査ログ — AuditLogger (いつ・誰が・どこから・何に・何をして・どうなったかを WebAPI ごとに 1 レコード記録。DB / JSON Lines ファイルへ。Strict/BestEffort・保持期限・追記専用の保護)。appsettings だけで有効化。監査ログ
• Web ヘルパ — ETag 付きファイル応答 (FileWithETag)、ホットリロード (HotReloadHub / FileWatcherService)

セットアップ

新しいアプリテンプレートで作成したプロジェクトには最初から組み込まれています。 既存プロジェクトに追加する場合は以下の手順で設定してください。

1. NuGet パッケージのインストール

2. コードの修正

LowCodeApp.Client.Shared

Services/AppInfoService.cs の AppInfoService コンストラクタに以下のコードを追加してください。

using Codeer.LowCode.Blazor.Extras;

// フィールドのみ使う場合
ExtrasClientInitializer.Initialize(this);

// スクリプトオブジェクト (Excel / WebApi / Toaster) も使う場合
ExtrasClientInitializer.Initialize(this, http, logger, toaster);

メール送信・承認フロー・Excel PDF 変換・AI 解析・AI チャット・意味検索・スクリプトの一括ファイル入出力・自分の認証アプリ解除ボタンを使う場合は、エンドポイント URL を起動時に設定します (URL はアプリのコントローラに合わせて変更してください)。

using Codeer.LowCode.Blazor.Extras.Fields;
using Codeer.LowCode.Blazor.Extras.Mail;
using Codeer.LowCode.Blazor.Extras.Approval;
using Codeer.LowCode.Blazor.Extras.ScriptObjects;

MailTransport.SendMailEndPoint = "/api/mail";
MailTransport.BulkSearchMailEndPoint = "/api/mail/bulk_search";
MailTransport.PreviewMailEndPoint = "/api/mail/preview";
MailTransport.BulkPreviewMailEndPoint = "/api/mail/bulk_preview";
ApprovalTransport.EndPointBase = "/api/approval";
Codeer.LowCode.Blazor.Extras.ScriptObjects.Excel.ConvertPdfEndPoint = "api/excel/pdf";
AITextAnalyzerField.FileToModuleDataEndPoint = "/api/ai_text_analyze/file";
AITextAnalyzerField.TextToModuleDataEndPoint = "/api/ai_text_analyze/text";
AIChatField.EndPoint = "/api/ai_chat";
SemanticSearchField.EndPoint = "/api/semantic_search/reindex";
BulkFileReader.ParseFileEndPoint = "/api/module_data/parse_file";
BulkFileTransferService.ListFileByDataEndPoint = "/api/module_data/list_file_by_data";
BulkFileTransferService.BulkSubmitEndPoint = "/api/module_data/bulk_submit";
TotpResetClient.StatusEndPoint = "/api/account/totp/status";
TotpResetClient.ResetEndPoint = "/api/account/totp/reset";

LowCodeApp.Server

Program.cs に以下のコードを追加してください。

using Codeer.LowCode.Blazor.Extras;

ExtrasServerInitializer.Initialize();

メール送信・承認フローを使う場合は、受け口となるコントローラ (MailController / ApprovalController) と 送信インフラの対応表 (MailSenderTable) が必要です。新しいアプリテンプレートには含まれています。 詳細は メール送信 / 承認フロー を参照してください。

一括ファイル入出力 (CSV / 固定長 / 列マッピング / 値の変換) を使う場合は、ModuleDataController の list_file / submit_by_file を BulkFileTransfer に移譲し、スクリプト用の list_file_by_data / bulk_submit / parse_file を足します。新しいアプリテンプレートには含まれています。詳細は 一括ファイル入出力 を参照してください。

AI チャット・意味検索を使う場合も同じ形で、受け口のコントローラ (AIChatController / SemanticSearchController) と対応表 (Agent 名 → Agent の AIChatAgentTable、埋め込みプロバイダの呼び名 → 実装の EmbeddingProviderTable) をアプリが持ちます。 新しいアプリテンプレート (Cookie) には含まれています。モデルの接続先は appsettings の AISettings (チャット) と SemanticSearch / AzureOpenAIEmbedding (埋め込み) で、 未設定なら AI チャットの Agent と意味検索は使えないだけでアプリは動きます。詳細は AIChatField / SemanticSearchField を参照してください。

LowCodeApp.Designer

App.xaml.cs に以下のコードを追加してください。

using Codeer.LowCode.Blazor.Extras.Designer;

// OnStartup メソッド内 (base.OnStartup(e) より前)
ExtrasDesignerInitializer.Initialize(BlazorRuntime);

// base.OnStartup(e) の後 (Tools メニュー: 承認フローのセットアップ / メールのセットアップ / 編集履歴のセットアップ)
ExtrasDesignerInitializer.Setup(DesignerEnvironment);

セットアップメニューは承認フロー・メール履歴・編集履歴・監査ログに必要なモジュール群をテンプレートから生成し、 テーブル作成 DDL の提示 (その場で実行可) と次にやることの案内まで行います (headless CLI の approval-setup / mail-setup / edit-history-setup / audit-log-setup verb からも同じ生成を実行できます)。

3. セットアップ完了

以上でセットアップは完了です。Designer から Extras のフィールドが配置できるようになります。

カスタマイズ

ソースは MIT で公開しています。動作を変えたい場合は次のいずれかで対応できます。

• インターフェースで登録するサービス (IHttpService / IToastService / ITemporaryFileManager 等) は、自前実装を DI 登録して丸ごと差し替える
• それ以外のクラスは、このリポジトリのソースをコピーしてアプリ内で改変し、元のクラスの代わりに使う

各フィールドの詳細

各フィールドの詳しい説明は以下のドキュメントを参照してください。

• CalendarField - カレンダー
• GanttField - ガントチャート
• TaskBoardField - カンバンボード
• RichTextField - リッチテキストエディタ
• MarkdownField - Markdown エディタ / ビューア
• ColorPickerField - カラーピッカー
• MarkerListField - 画像マーカー
• QrCodeField - QRコード
• ProgressField - 進捗バー / メーター
• EnterFocusMoveField - Enterキーでフォーカス移動
• ExcelReportButtonField - Excel 帳票ボタン
• 一括ファイル入出力 (CsvFileFormatField / FileColumnMappingField / FileValueConversionField / BulkFileTransferButtonField)
• FileStorage - ファイルの保存先
• 認証の全体像 (ログインアカウント契約 / パスワード / 外部 IdP / 二要素認証)
• 外部ログイン (Entra ID / Google / AWS Cognito / OpenID Connect)
• 二要素認証 (認証アプリ TOTP / メールのワンタイムコード)
• サーバー API の権限チェック (メール / 承認 / AI のフィールド起点 API)
• PasswordHashField - パスワードハッシュ
• OrientationLockField - 画面の向き制御
• AITextAnalyzerField - AI 帳票解析
• AIChatField - AI チャット
• SemanticSearchField - 意味検索 (AI)
• メール送信 (MailField / BulkMailField)
• MailSender - 担当者本人のアカウント名義でメールを送る
• 承認フロー (ApprovalFlowField)
• 編集履歴 (EditHistoryField)

CSS カスタマイズ

各フィールドの見た目はCSSで自由にカスタマイズできます。詳しくは CSS カスタマイズガイド を参照してください。

ライセンス

MIT License

使用している OSS

各パッケージが NuGet 参照で取り込む第三者ライブラリとそのライセンスです (Microsoft.* / Azure.* / System.* の Microsoft 製パッケージはすべて MIT)。 いずれも商用利用・再配布が可能なライセンスで、NuGet パッケージ自体がライセンス文を同梱しているため、利用側で追加の手続きは要りません。

本体 (Codeer.LowCode.Blazor / .Designer) は Codeer の商用ライセンスです。