sgcUI Realtime UI 팩

TsgcUIPresenceModel은 사용자와 그 상태(온라인, 자리 비움, 다른 용무 중, 오프라인)를 상태 텍스트와 함께 관리합니다. 아바타 컨트롤이 모델을 따르므로 상태가 바뀌면 그 사용자의 모든 아바타와 표시점이 한꺼번에 다시 그려집니다.

• 접속 상태 모델은 코드에서 AddOrUpdate와 SetStatus로, 또는 변경 하나당 실시간 메시지 하나로 변경을 받습니다.
• 아바타, 들어가지 않는 사용자를 "+N" 칩으로 보여 주는 아바타 그룹, 상태 점과 상태 텍스트가 있는 접속 상태 표시점이 있습니다.
• sgcDashboard의 활동 피드가 같은 모델을 읽으므로 모든 행위자에게 아바타와 상태가 표시됩니다.

제품

sgcUICore, 모든 sgcUI 제품이 공유

Delphi 및 C++Builder

TsgcVCLAvatar, TsgcVCLAvatarGroup, TsgcVCLPresenceIndicator와 대응하는 TsgcFMX 클래스

에디션

Community를 포함한 모든 에디션, 실시간 접속 상태 메시지도 포함

도움말: 접속 상태, 아바타와 접속 상태 표시점.

TsgcDashboardActivityModel은 각 활동을 행위자, 동사, 객체와 바뀐 필드로 기록합니다. 활동 피드와 감사 추적은 같은 모델의 두 가지 뷰입니다.

• 활동 피드: 최신 활동이 먼저 오며, 상대 시간과 접속 상태 모델에서 가져온 각 행위자의 아바타를 표시합니다.
• 감사 추적: 행을 펼치면 바뀐 필드가 나오는 테이블입니다.
• 둘 다 독립 컨트롤이며, 대시보드용 활동 타일과 감사 타일로도 제공됩니다.

제품

sgcDashboard

Delphi 및 C++Builder

TsgcVCLActivityFeed, TsgcVCLAuditTrail, TsgcVCLDashboardActivityTile, TsgcVCLDashboardAuditTile와 대응하는 TsgcFMX 클래스

에디션

Community를 포함한 모든 에디션. 실시간 활동 메시지는 Registered입니다.

도움말: 활동 피드, 활동 실시간 메시지, 활동 타일, 감사 타일.

• 소스는 연결, 구독, 전송을 하지 않습니다. URL, 자격 증명, TLS, 재연결은 클라이언트의 몫이며, WatchDog가 다시 연결해도 훅은 유지됩니다.
• 소스 하나가 바인딩을 통해 여러 모델에 데이터를 공급하므로 연결 하나로 화면 전체를 구동할 수 있습니다. 바인딩은 애플리케이션 봉투를 풀 수 있으며, 클라이언트 이벤트에 단 사용자 핸들러도 그대로 호출됩니다.
• 모델은 항상 메인 스레드에서 호출됩니다. 소켓 스레드에 도착한 메시지는 큐에 쌓였다가 도착 순서대로 메인 스레드를 한 번만 거쳐 적용됩니다.
• 브리지는 수신 전용입니다. 사용자가 알림을 읽거나 닫으면 애플리케이션이 같은 클라이언트로 자체 프레임을 보냅니다.

네 가지 메시지 형식

새로운 프로토콜은 없습니다. 각 모델은 자신의 피드의 실시간 메시지를 읽습니다. 변경 하나당 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;
// 모델마다 바인딩 하나, 토픽으로 선택
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/#');

실시간 소스는 Registered 에디션에만 포함되며, 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이며 Registered 전용입니다.
• esegece.sgcNavigation.Community, esegece.sgcGrid.Community와 같은 NuGet의 무료 Community 패키지는 Delphi Community 빌드와 같은 부분을 제외합니다.
• .NET 데모에는 모델, 시뮬레이터, 자체 점검이 들어 있는 공유 프로젝트 하나 위에 WinForms, WPF, Avalonia 호스트가 있습니다.

도움말: .NET 패키지, Realtime UI 팩.