sgcUI リアルタイム UI パック

TsgcUIPresenceModel は、ユーザーとそのステータス (オンライン、退席中、取り込み中、オフライン) を、ステータステキストとともに保持します。アバターのコントロールはモデルに追従するので、ステータスが変わると、そのユーザーのすべてのアバターとインジケーターが一度に再描画されます。

• プレゼンスモデルは、コードから AddOrUpdate と SetStatus で、または変更ごとに 1 つのライブメッセージで更新されます。
• アバター、収まらないユーザーを「+N」チップで示すアバターグループ、ステータスの点とステータステキストを表示するプレゼンスインジケーター。
• sgcDashboard のアクティビティフィードは同じモデルを読むので、すべてのアクターにアバターとステータスが表示されます。

製品

sgcUICore。すべての sgcUI 製品で共有されます

Delphi と C++Builder

TsgcVCLAvatar、TsgcVCLAvatarGroup、TsgcVCLPresenceIndicator と、それぞれの TsgcFMX の対応コントロール

エディション

Community を含むすべてのエディション。ライブのプレゼンスメッセージも同様です

ヘルプ：プレゼンス と アバターとプレゼンスインジケーター。

TsgcDashboardActivityModel は、各アクティビティを、アクター、動詞、オブジェクトと、変更されたフィールドとして記録します。アクティビティフィードと監査証跡は、同じモデルの 2 つのビューです。

• アクティビティフィード：最新のアクティビティを先頭に、相対時刻と、プレゼンスモデルから取得した各アクターのアバターを表示します。
• 監査証跡：行を展開すると、変更されたフィールドが分かるテーブルです。
• どちらも単独のコントロールとして使えるほか、ダッシュボード用のアクティビティタイルと監査タイルとしても使えます。

製品

sgcDashboard

Delphi と C++Builder

TsgcVCLActivityFeed、TsgcVCLAuditTrail、TsgcVCLDashboardActivityTile、TsgcVCLDashboardAuditTile と、それぞれの TsgcFMX の対応コントロール

エディション

Community を含むすべてのエディション。ライブアクティビティメッセージは登録版です。

ヘルプ：アクティビティフィード、ライブアクティビティメッセージ、アクティビティタイル、監査タイル。

• ソースは、接続も、サブスクライブも、送信もしません。URL、資格情報、TLS、再接続はクライアントの役目で、フックは WatchDog による再接続の後も維持されます。
• 1 つのソースがバインディングを通じて複数のモデルに値を届けるので、1 つの接続で画面全体を動かせます。バインディングはアプリケーションのエンベロープを取り出すことができ、クライアントイベントの独自ハンドラーも引き続き呼び出されます。
• モデルは常にメインスレッドで呼び出されます。ソケットスレッドに届いたメッセージはキューに入り、到着順に、メインスレッドへの 1 回の切り替えで適用されます。
• ブリッジは受信専用です。ユーザーが通知を読んだり非表示にしたりしたときは、アプリケーションが同じクライアントを通じて独自のフレームを送ります。

4 つのメッセージ形式

新しいプロトコルはありません。各モデルは、自分のフィードのライブメッセージを読みます。変更ごとに 1 つの JSON オブジェクトで、フィードを示す type メンバーと op メンバーを持ちます。

{"type":"presence","op":"upsert","user":{"id":"u7","presence":"away","statusText":"Lunch"}}
{"type":"notification","op":"add","notification":{"id":"n2","title":"Build 812 passed","severity":"success"}}
{"type":"activity","op":"add","item":{"id":"a20","actorId":"u7","verb":"updated","objectName":"Invoice INV-17"}}
{"type":"log","op":"append","entry":{"level":"warning","source":"api","message":"Slow query"}}

oSource := TsgcUILiveSource_MQTT.Create(Self);
oSource.Client := MQTT;
// モデルごとに 1 つのバインディング。トピックで選択します
oBinding := oSource.Bindings.Add;
oBinding.Target := PresenceModel;
oBinding.Topic := 'ops/presence';
oBinding := oSource.Bindings.Add;
oBinding.Target := NotificationModel;
oBinding.Topic := 'ops/notifications';
oBinding := oSource.Bindings.Add;
oBinding.Target := ActivityModel;
oBinding.Topic := 'ops/activity';
oBinding := oSource.Bindings.Add;
oBinding.Target := LogModel;
oBinding.Topic := 'ops/log/+';
// ソースはサブスクライブしません。クライアントの OnMQTTConnect でサブスクライブします
MQTT.Subscribe('ops/#');

ライブソースは登録版のみで、sgcUI のすべての sgcWebSockets ブリッジと同様に sgcWebSockets が必要です。サーバーがない場合や Community のビルドでは、アプリケーションが各モデルの API を呼び出します。プレゼンスモデルの AddOrUpdate と SetStatus、通知モデルの Add または Post、アクティビティモデルの Add、ログモデルの Append です。

ライブソースのヘルプトピックを読む

• モデル：TsgcUIPresenceModel (名前空間 esegece.sgcUICore)、TsgcNotificationModel と TsgcNotificationPreferences (esegece.sgcNavigation)、TsgcToolbarBadgeLink (esegece.sgcToolbar)、TsgcDashboardActivityModel (esegece.sgcDashboard)、TsgcGridLogModel と TsgcGridLogLink (esegece.sgcGrid)。
• コントロール：TsgcWinFormsAvatar、TsgcWinFormsToastManager、TsgcWinFormsNotificationInbox、TsgcWinFormsActivityFeed、TsgcWinFormsAuditTrail などで、それぞれに TsgcWpf と TsgcAvalonia の対応コントロールがあります。
• ライブソース：パッケージ esegece.sgcUICore.sgcWebSockets の TsgcUILiveSource_WebSocket、TsgcUILiveSource_MQTT、TsgcUILiveSource_SSE。登録版のみです。
• esegece.sgcNavigation.Community や esegece.sgcGrid.Community など、NuGet の無償の Community パッケージは、Delphi の Community ビルドと同じ部分を省いています。
• .NET のデモには、モデル、シミュレーター、自己チェックを収めた 1 つの共有プロジェクトの上に、WinForms、WPF、Avalonia のホストがあります。

ヘルプ：.NET パッケージ と リアルタイム UI パック。