O Pacote Realtime UI do sgcUI

TsgcUIPresenceModel mantém os usuários e o seu status (online, ausente, ocupado ou offline) com um texto de status. Os controles de avatar acompanham o modelo, de modo que uma mudança de status repinta de uma só vez todos os avatares e indicadores desse usuário.

• O modelo de presença recebe as suas mudanças de AddOrUpdate e SetStatus no código, ou de uma mensagem ao vivo por mudança.
• Um avatar, um grupo de avatares com um chip "+N" para os usuários que não cabem, e um indicador de presença com o ponto de status e o texto de status.
• O feed de atividades do sgcDashboard lê o mesmo modelo, de modo que cada autor mostra o seu avatar e o seu status.

Produto

sgcUICore, compartilhado por todos os produtos sgcUI

Delphi e C++Builder

TsgcVCLAvatar, TsgcVCLAvatarGroup, TsgcVCLPresenceIndicator e os seus gêmeos TsgcFMX

Edição

Todas as edições, Community inclusive, e também as mensagens de presença ao vivo

Ajuda: Presença e Avatares e indicador de presença.

TsgcDashboardActivityModel registra cada atividade como um autor, um verbo e um objeto, com os campos que mudaram. O feed de atividades e a trilha de auditoria são duas visões do mesmo modelo.

• Feed de atividades: a atividade mais recente primeiro, com tempos relativos e o avatar de cada autor vindo do modelo de presença.
• Trilha de auditoria: uma tabela cujas linhas se expandem até os campos alterados.
• Ambos são controles independentes e também tiles de atividades e de auditoria para um dashboard.

Produto

sgcDashboard

Delphi e C++Builder

TsgcVCLActivityFeed, TsgcVCLAuditTrail, TsgcVCLDashboardActivityTile, TsgcVCLDashboardAuditTile e os seus gêmeos TsgcFMX

Edição

Todas as edições, Community inclusive. As mensagens de atividade ao vivo são Registrada.

Ajuda: Feed de atividades, Mensagens de atividade ao vivo, Tile de atividades e Tile de auditoria.

• A fonte nunca conecta, assina nem envia. A URL, as credenciais, o TLS e a reconexão pertencem ao cliente, e o gancho sobrevive a uma reconexão do WatchDog.
• Uma fonte alimenta vários modelos por meio dos seus bindings, de modo que uma conexão pode controlar uma tela inteira. Um binding pode desembrulhar um envelope da aplicação, e o seu próprio tratador do evento do cliente continua a ser disparado.
• Os modelos são sempre chamados na thread principal. As mensagens que chegam em uma thread de socket entram em fila e são aplicadas em uma única visita à thread principal, na ordem de chegada.
• A bridge é somente de entrada. Quando o usuário lê ou dispensa uma notificação, a aplicação envia o seu próprio frame pelo mesmo cliente.

Os quatro formatos de mensagem

Não há um novo protocolo. Cada modelo lê a mensagem ao vivo do seu feed: um objeto JSON por mudança, com um membro type que nomeia o feed e um 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;
// um binding por modelo, selecionado pelo seu tópico
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/+';
// a fonte nunca assina: assine no OnMQTTConnect do cliente
MQTT.Subscribe('ops/#');

As fontes ao vivo são somente Registrada e exigem o sgcWebSockets, como toda bridge do sgcUI com o sgcWebSockets. Sem um servidor, ou em um build Community, a aplicação chama a API de cada modelo: AddOrUpdate e SetStatus do modelo de presença, Add ou Post do modelo de notificações, Add do modelo de atividades e Append do modelo de log.

Leia o tópico de ajuda Fontes ao vivo

• Modelos: TsgcUIPresenceModel (namespace esegece.sgcUICore), TsgcNotificationModel e TsgcNotificationPreferences (esegece.sgcNavigation), TsgcToolbarBadgeLink (esegece.sgcToolbar), TsgcDashboardActivityModel (esegece.sgcDashboard) e TsgcGridLogModel com TsgcGridLogLink (esegece.sgcGrid).
• Controles: TsgcWinFormsAvatar, TsgcWinFormsToastManager, TsgcWinFormsNotificationInbox, TsgcWinFormsActivityFeed, TsgcWinFormsAuditTrail e os demais controles, cada um com o seu gêmeo TsgcWpf e TsgcAvalonia.
• Fontes ao vivo: TsgcUILiveSource_WebSocket, TsgcUILiveSource_MQTT e TsgcUILiveSource_SSE no pacote esegece.sgcUICore.sgcWebSockets, somente Registrada.
• Os pacotes Community gratuitos no NuGet, como esegece.sgcNavigation.Community e esegece.sgcGrid.Community, deixam de fora as mesmas partes que os builds Community do Delphi.
• A demo .NET tem hosts WinForms, WPF e Avalonia sobre um único projeto compartilhado com os modelos, o simulador e a autoverificação.

Ajuda: Pacotes .NET e Pacote Realtime UI.