Das sgcUI Realtime-UI-Paket

TsgcUIPresenceModel verwaltet die Benutzer und ihren Status (online, abwesend, beschäftigt oder offline) mit einem Statustext. Die Avatar-Steuerelemente folgen dem Modell, sodass eine Statusänderung jeden Avatar und jede Anzeige dieses Benutzers sofort neu zeichnet.

• Das Präsenzmodell übernimmt seine Änderungen aus AddOrUpdate und SetStatus im Code oder aus einer Live-Nachricht pro Änderung.
• Ein Avatar, eine Avatar-Gruppe mit einem "+N"-Chip für die Benutzer, die nicht hineinpassen, und eine Präsenzanzeige mit Statuspunkt und Statustext.
• Der Aktivitäts-Feed von sgcDashboard liest dasselbe Modell, sodass jeder Akteur seinen Avatar und seinen Status zeigt.

Produkt

sgcUICore, von jedem sgcUI-Produkt gemeinsam genutzt

Delphi und C++Builder

TsgcVCLAvatar, TsgcVCLAvatarGroup, TsgcVCLPresenceIndicator und ihre TsgcFMX-Gegenstücke

Edition

Jede Edition, auch Community, ebenso die Live-Präsenznachrichten

Hilfe: Präsenz und Avatare und Präsenzanzeige.

TsgcDashboardActivityModel erfasst jede Aktivität als Akteur, Verb und Objekt, mit den Feldern, die sich geändert haben. Der Aktivitäts-Feed und der Audit-Trail sind zwei Ansichten desselben Modells.

• Aktivitäts-Feed: die neueste Aktivität zuerst, mit relativen Zeitangaben und dem Avatar jedes Akteurs aus dem Präsenzmodell.
• Audit-Trail: eine Tabelle, deren Zeilen sich zu den geänderten Feldern aufklappen.
• Beide sind eigenständige Steuerelemente und auch Aktivitäts- und Audit-Kacheln für ein Dashboard.

Produkt

sgcDashboard

Delphi und C++Builder

TsgcVCLActivityFeed, TsgcVCLAuditTrail, TsgcVCLDashboardActivityTile, TsgcVCLDashboardAuditTile und ihre TsgcFMX-Gegenstücke

Edition

Jede Edition, auch Community. Die Live-Aktivitätsnachrichten sind Registriert.

Hilfe: Aktivitäts-Feed, Live-Aktivitätsnachrichten, Aktivitäts-Kachel und Audit-Kachel.

• Die Quelle verbindet sich nie, abonniert nichts und sendet nichts. Die URL, die Zugangsdaten, TLS und die Wiederverbindung gehören dem Client, und der Hook übersteht eine Wiederverbindung durch den WatchDog.
• Eine Quelle speist über ihre Bindungen mehrere Modelle, sodass eine Verbindung eine ganze Oberfläche antreiben kann. Eine Bindung kann einen Anwendungs-Umschlag auspacken, und dein eigener Handler des Client-Ereignisses wird weiterhin aufgerufen.
• Die Modelle werden immer im Hauptthread aufgerufen. Nachrichten, die in einem Socket-Thread eintreffen, werden eingereiht und in einem einzigen Besuch im Hauptthread in der Reihenfolge ihres Eintreffens angewendet.
• Die Brücke ist nur eingehend. Wenn der Benutzer eine Benachrichtigung liest oder verwirft, sendet die Anwendung ihren eigenen Frame über denselben Client.

Die vier Nachrichtenformen

Es gibt kein neues Protokoll. Jedes Modell liest die Live-Nachricht seines Feeds: ein JSON-Objekt pro Änderung, mit einem Member type, der den Feed benennt, und einem Member 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;
// eine Bindung pro Modell, gewählt über sein Topic
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/+';
// die Quelle abonniert nie: abonniere in OnMQTTConnect des Clients
MQTT.Subscribe('ops/#');

Die Live-Quellen sind nur in Registriert enthalten und brauchen sgcWebSockets, wie jede sgcWebSockets-Brücke von sgcUI. Ohne Server oder in einem Community-Build ruft die Anwendung stattdessen die API jedes Modells auf: AddOrUpdate und SetStatus des Präsenzmodells, Add oder Post des Benachrichtigungsmodells, Add des Aktivitätsmodells und Append des Logmodells.

Das Hilfethema zu den Live-Quellen lesen

• Modelle: TsgcUIPresenceModel (Namespace esegece.sgcUICore), TsgcNotificationModel und TsgcNotificationPreferences (esegece.sgcNavigation), TsgcToolbarBadgeLink (esegece.sgcToolbar), TsgcDashboardActivityModel (esegece.sgcDashboard) und TsgcGridLogModel mit TsgcGridLogLink (esegece.sgcGrid).
• Steuerelemente: TsgcWinFormsAvatar, TsgcWinFormsToastManager, TsgcWinFormsNotificationInbox, TsgcWinFormsActivityFeed, TsgcWinFormsAuditTrail und die übrigen Steuerelemente, jedes mit seinem TsgcWpf- und TsgcAvalonia-Gegenstück.
• Live-Quellen: TsgcUILiveSource_WebSocket, TsgcUILiveSource_MQTT und TsgcUILiveSource_SSE im Paket esegece.sgcUICore.sgcWebSockets, nur in Registriert.
• Die kostenlosen Community-Pakete auf NuGet, wie esegece.sgcNavigation.Community und esegece.sgcGrid.Community, lassen dieselben Teile weg wie die Delphi-Community-Builds.
• Die .NET-Demo hat WinForms-, WPF- und Avalonia-Hosts über einem gemeinsamen Projekt mit den Modellen, dem Simulator und dem Selbsttest.

Hilfe: .NET-Pakete und Realtime-UI-Paket.