Il pacchetto Realtime UI di sgcUI

TsgcUIPresenceModel tiene gli utenti e il loro stato (online, assente, occupato o offline) con un testo di stato. I controlli avatar seguono il modello, quindi un cambio di stato ridisegna subito ogni avatar e indicatore di quell'utente.

• Il modello di presenza riceve le modifiche da AddOrUpdate e SetStatus nel codice, oppure da un messaggio live per ogni modifica.
• Un avatar, un gruppo di avatar con un chip "+N" per gli utenti che non entrano e un indicatore di presenza con il pallino di stato e il testo di stato.
• Il feed delle attività di sgcDashboard legge lo stesso modello, quindi ogni attore mostra il suo avatar e il suo stato.

Prodotto

sgcUICore, condiviso da ogni prodotto sgcUI

Delphi e C++Builder

TsgcVCLAvatar, TsgcVCLAvatarGroup, TsgcVCLPresenceIndicator e i loro gemelli TsgcFMX

Edizione

Ogni edizione, Community compresa, anche i messaggi live di presenza

Guida: Presenza e Avatar e indicatore di presenza.

TsgcDashboardActivityModel registra ogni attività come un attore, un verbo e un oggetto, con i campi modificati. Il feed delle attività e il registro di controllo sono due viste dello stesso modello.

• Feed delle attività: l'attività più recente per prima, con orari relativi e l'avatar di ogni attore preso dal modello di presenza.
• Registro di controllo: una tabella le cui righe si espandono sui campi modificati.
• Entrambi sono controlli autonomi e anche tile di attività e di controllo per una dashboard.

Prodotto

sgcDashboard

Delphi and C++Builder

TsgcVCLActivityFeed, TsgcVCLAuditTrail, TsgcVCLDashboardActivityTile, TsgcVCLDashboardAuditTile e i loro gemelli TsgcFMX

Edizione

Ogni edizione, Community compresa. I messaggi live di attività sono Registered.

Guida: Feed delle attività, Messaggi live di attività, Tile attività e Tile controllo.

• La sorgente non si connette, non si sottoscrive e non invia mai. L'URL, le credenziali, TLS e la riconnessione appartengono al client, e l'aggancio sopravvive a una riconnessione del WatchDog.
• Una sorgente alimenta più modelli tramite i suoi binding, quindi una connessione può pilotare un'intera schermata. Un binding può estrarre il contenuto da una busta applicativa, e il tuo gestore dell'evento del client scatta comunque.
• I modelli sono sempre chiamati nel thread principale. I messaggi che arrivano in un thread socket sono messi in coda e applicati in una sola visita al thread principale, in ordine di arrivo.
• Il ponte è solo in ingresso. Quando l'utente legge o chiude una notifica, l'applicazione invia un suo frame tramite lo stesso client.

Le quattro forme dei messaggi

Non c'è alcun nuovo protocollo. Ogni modello legge il messaggio live del suo feed: un oggetto JSON per ogni modifica, con un membro type che nomina il feed e un membro 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;
// un binding per modello, selezionato dal suo 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/+';
// la sorgente non si sottoscrive mai: sottoscrivi in OnMQTTConnect del client
MQTT.Subscribe('ops/#');

Le sorgenti live sono solo Registered e richiedono sgcWebSockets, come ogni ponte sgcWebSockets di sgcUI. Senza un server, o in una build Community, l'applicazione chiama invece l'API di ogni modello: AddOrUpdate e SetStatus del modello di presenza, Add o Post del modello di notifica, Add del modello di attività e Append del modello di log.

Leggi l'argomento della guida sulle sorgenti live

• Modelli: TsgcUIPresenceModel (namespace esegece.sgcUICore), TsgcNotificationModel e TsgcNotificationPreferences (esegece.sgcNavigation), TsgcToolbarBadgeLink (esegece.sgcToolbar), TsgcDashboardActivityModel (esegece.sgcDashboard) e TsgcGridLogModel con TsgcGridLogLink (esegece.sgcGrid).
• Controlli: TsgcWinFormsAvatar, TsgcWinFormsToastManager, TsgcWinFormsNotificationInbox, TsgcWinFormsActivityFeed, TsgcWinFormsAuditTrail e gli altri controlli, ciascuno con il suo gemello TsgcWpf e TsgcAvalonia.
• Sorgenti live: TsgcUILiveSource_WebSocket, TsgcUILiveSource_MQTT e TsgcUILiveSource_SSE nel pacchetto esegece.sgcUICore.sgcWebSockets, solo Registered.
• I pacchetti Community gratuiti su NuGet, come esegece.sgcNavigation.Community e esegece.sgcGrid.Community, escludono le stesse parti delle build Delphi Community.
• La demo .NET ha host WinForms, WPF e Avalonia su un unico progetto condiviso con i modelli, il simulatore e l'autoverifica.

Guida: Pacchetti .NET e Pacchetto Realtime UI.