Zum Hauptinhalt springen

Analysen: Vorstände

Analytics in der linken Navigation öffnet Boards (/dashboards/boards). Ein Board ist ein Dokument, das Sie als YAML- oder Markdown-Quelltext erstellen. Der Analysedienst kompiliert es, wertet die Daten aus und rendert es als SVG, PNG, PDF, HTML oder JSON. Diese Seite beschreibt die aktuellen Funktionen von Boards und deren zukünftige Entwicklung.

Eine schrittweise Anleitung zum Erstellen und Teilen eines Boards finden Sie unter Erstellen, Teilen und Exportieren eines Boards.


Zwei Ansichten, ein Menüeintrag​

Boards unter /dashboards/boards im Vergleich zur alten Arbeitsbereichsoberfläche

SichtWoStatus
BoardsAnalytics → Boards, /dashboards/boardsDie aktuelle Ansicht. Vom Quellcode erstellte Boards, gespeicherte Revisionen, Assistent.
Arbeitsbereich-Leinwand/dashboard/:workspaceId oder /studio/dashboards/:workspaceIdÄltere Streaming-Ansicht. Nur über URL erreichbar; kein Menüeintrag. Siehe Legacy-Arbeitsbereichsansicht.

Die Routen /dashboards und /studio/boards leiten zu /dashboards/boards weiter. Wenn keine Organisation ausgewählt ist, wird auf der Seite „Wählen Sie eine Organisation aus, um Boards zu öffnen“ angezeigt.


Was ein Board ist​

Ein Board besteht aus Quelltext und seinen Datendefinitionen. Das kleinste sinnvolle Board hat queries (Daten), charts (wie es gezeichnet wird) und rows (wo es platziert wird):

title: Service activity (synthetic)
queries:
activity:
rows:
- {month: Jul, visits: 120}
- {month: Aug, visits: 145}
- {month: Sep, visits: 138}
charts:
visits:
type: line
title: Monthly visits
query: activity
x: month
y: visits
rows:
- visits

Die Bibliothek akzeptiert zwei Quellformate, die im Feld Source format angezeigt werden: YAML und Markdown Ein Markdown-Board speichert Fließtext und platziert Diagramme mit {{ chart name }} Markierungen.

Wie eine Platine hergestellt wird

Die Plattform, die Saved-Board-API und das Kommandozeilentool hydra-charts werden vom selben Compiler und denselben Renderern bedient. Das Rendering erfolgt in Go; es gibt keinen Python-Dienst und keinen Browser-Rendering-Schritt.


Die Bibliothek​

Analytics → Boards öffnet die Board-Bibliothek („Ihre Analyse-Dashboards und medizinischen Berichte an einem Ort.“). Jedes Board ist eine Vorschaukarte mit der letzten Aktualisierung und einer Draft oder Published Kennzeichnung.

KontrolleWas es tut
Search boards, Required tags (comma separated)Filtert die Liste. Clear search setzt sie zurück.
Create boardÖffnet das Erstellungsfenster. Siehe die Anleitung.
Open boardÖffnet das Board mit ausgeblendetem Editor.
Delete boardLöscht das Board, alle zugehörigen Revisionen und gespeicherten Exporte. Die Bestätigungsmeldung besagt, dass dies nicht rückgängig gemacht werden kann.

Die Boards gehören zu der von Ihnen ausgewählten Organisation. Beim Wechsel der Organisation wird die Seite neu geladen, daher werden Boards der vorherigen Organisation unter der neuen Organisation nie angezeigt.


Der Redakteur​

Wählen Sie Show editor auf einem offenen Board; Hide editor führt zurück zur vollständigen Vorschau und speichert nicht gespeicherte Änderungen. Registerkarten im Editor:

TabVerwenden Sie es, um
Arrange chartsDiagramme neu anordnen, in der Größe anpassen und gruppieren.
ChartsListen Sie Diagramme nach Titel und Typ auf und bearbeiten Sie das ausgewählte Diagramm in einem Inspektionsfenster.
Add chartFügen Sie ein Startdiagramm nach Kategorie ein: Vergleich, Trends, Proportionen, Zusammenfassung, Karten, Medizin.
DatasetsDaten in der Vorschau ansehen und wiederverwenden. Siehe Daten.
Board settingsBoardtitel, Breite und Ausrichtung des Titels, Größe und Farbe.
Source & dataBearbeiten Sie den gesamten YAML- oder Markdown-Code sowie die Variablen.

Änderungen an den Steuerelementen und im Quellcode werden synchronisiert, und die Vorschau wird nach einer kurzen Pause (450 ms im Frontend) aktualisiert. Falls eine Bearbeitung den Quellcode ungültig macht, behält die Vorschau die letzte gültige Darstellung bei und zeigt den Fehler an; beheben Sie ihn, bevor Sie speichern.

Die Standard-Starterpakete umfassen sechzehn Diagrammtypen sowie acht medizinische Voreinstellungen. Die Kartendiagrammtypen stellen eingebettete Grenzen in Go ohne Kartenkacheln dar.

Speichern, Veröffentlichen, Verlauf​

AktionErgebnis
SaveSpeichert den aktuellen Entwurf und alle ausstehenden Bearbeitungsschritte als neue Revision. Falls jemand zuvor eine neuere Revision gespeichert hat, entsteht ein Revisionskonflikt; behalten Sie Ihre ursprüngliche Version, laden Sie sie neu und gleichen Sie die Revisionen ab.
PublishDer Entwurf wird validiert und gerendert, anschließend wird diese unveränderliche Revision als Published markiert. Spätere Speichervorgänge erstellen neue Entwürfe, die veröffentlichte Revision bleibt jedoch unverändert. Durch die Veröffentlichung wird kein öffentlicher Link erstellt und es ändert sich nicht, wer das Board sehen kann.
Revision historyÄltere Versionen werden schreibgeschützt aufgelistet. Durch das Wiederherstellen einer Version wird eine neue aktuelle Revision erstellt.

Daten​

Ein Diagramm liest eine benannte Abfrage. Eine Abfrage kann Folgendes sein:

  • Inline rows wird wie im obigen Beispiel an die Tafel geschrieben. Starter und Erstellungsvorlagen verwenden deutlich gekennzeichnete synthetische Daten.
  • Der Servicekatalog. Option Datasets → Service catalogue listet serverseitige Datensätze Ihrer Organisation auf, beispielsweise Pipeline- und Agentenaktivitätsströme. Run preview zeigt die zurückgegebenen Zeilen an, ohne das Board zu verändern, und Use dataset fügt dem Entwurf eine benannte Abfrage und Tabelle hinzu. Die Abfrage wird bei jeder Aktualisierung des Boards neu ausgewertet; es handelt sich nicht um eine gespeicherte Momentaufnahme.
  • Eine gespeicherte Verbindung. Datasets → Connected data sources listet SQL- und FHIR-R4-Verbindungen von den Datenschicht-Konnektoren derselben Organisation auf. Die Anmeldeinformationen verbleiben im Konnektor; das Board speichert lediglich eine Referenz. SQL muss schreibgeschützt sein. Für FHIR wählen Sie eine Ressource und Filter im Editor aus. Vorschauen sind auf 200 Zeilen und 20 Sekunden begrenzt, und eine verbundene Abfrage liefert maximal 1.000 Zeilen. Ein Board kann keine Verbindungen aus verschiedenen Organisationen kombinieren, und quellenübergreifende Joins werden nicht unterstützt.
  • Configured read-only SQL sources, vom Betreiber in der Analytics-Hostkonfiguration an eine Organisation gebunden.

Manage connections öffnet die Seite „Konnektoren“ in einem neuen Tab, sodass Ihr Entwurf erhalten bleibt; kehren Sie zurück und verwenden Sie Refresh connections.

validate prüft lediglich Syntax und Schema. Ein Board kann die Validierung bestehen, aber dennoch nicht ausgewertet werden, weil ein Datensatz nicht verfügbar ist. Überprüfen Sie daher immer die Vorschau.

Medizinische Komponenten​

Add chart → Medical fügt eine von acht vordefinierten Versionen ein: medical.patient_summary, medical.vitals_overview, medical.lab_results, medical.medications_allergies, medical.conditions_procedures, medical.clinical_timeline, medical.clinical_report und medical.evidence_summary. Diese zeigen die von Ihnen bereitgestellten Datensätze an; sie werden nicht klinisch interpretiert. Überprüfen Sie Einheiten, Datumsangaben, Referenzbereiche und fehlende Werte in der Vorschau. Verwenden Sie zum Testen synthetische Datensätze.


Dashboard-Assistent​

Auf einem zur Bearbeitung geöffneten Board öffnet Dashboard assistant ein Seitenfenster. Der Assistent ruft die Workflow-Engine unter /copilot/board-assistant auf, die dasselbe konfigurierte Modell wie der Workflow-Copilot verwendet. Sie schlägt neuen Board-Quellcode vor; Analytics validiert den Vorschlag mit dem Board-Compiler.

  1. Beschreiben Sie das Dashboard oder die Änderung in Your request (maximal 4.000 Zeichen).
  2. Eine Validated proposal erscheint. Klicken Sie auf Review proposed source, um sie zu lesen.
  3. Apply to draft öffnet den Editor und zeigt die Vorschau an. Es wird nichts gespeichert, bis Sie Save (oder Create in der Bibliothek) auswählen.

Wissenswertes:

  • Connected data only (eine standardmäßig aktivierte Checkbox) lehnt Vorschläge ab, die statische Abfragedaten beibehalten. Deaktivieren Sie diese Option nur, wenn Sie ein gemischtes oder Beispiel-Board wünschen.
  • Der Assistent empfängt Verbindungsmetadaten (Tabellen, FHIR-Suchparameter), keine Abfrageergebnisse. Er überprüft nicht die Daten, die eine verbundene Abfrage zurückgibt.
  • Wenn Sie den Entwurf bearbeitet haben, während der Assistent gearbeitet hat, wird der Vorschlag als veraltet markiert: „Der Entwurf hat sich geändert. Senden Sie eine neue Anfrage, um den Vorschlag zu aktualisieren.“
  • Entwürfe, die größer als 128 KB sind, können nicht an den Assistenten gesendet werden („Dieser Entwurf überschreitet das Limit von 128 KB für den Assistenten“). Historische Versionen sind schreibgeschützt und können keine Vorschläge annehmen.
  • Mögliche Fehlermeldungen: „Das Modell des Assistenten ist nicht verfügbar“ (ein Bediener muss die Modellkonfiguration der Workflow-Engine überprüfen) und „Der Assistent konnte keine gültige Konfiguration erstellen. Ihr Board hat sich nicht geändert.“
  • Der Editor des Befehlszeilentools beinhaltet keinen Assistenten.

Exportieren und teilen​

Export lädt das aktuelle Board inklusive ungespeicherter Änderungen als SVG, PNG, PDF, HTML or JSON (ausgewertete Daten) herunter. Die Plattform benennt die Datei board.<format>.

Stored exports speichert unveränderliche Kopien einer gespeicherten Board-Revision. Jede Zeile zeigt Format, Revision und Expires (UTC) mit Download, Delete export und Copy organization link. Die vom Dienst dokumentierten Beschränkungen sind: standardmäßige Aufbewahrungsdauer von sieben Tagen, 8 MiB pro Export und 64 MiB oder 128 Exporte pro Organisation. Der laufende Dienst gibt seine eigenen Beschränkungen mit /capabilities an.

Der Freigabelink hat die Form https://<platform host>/dashboards/boards?artifact=<export id>. Es handelt sich um einen Organisationslink: Die Plattform meldet: „Organisationslink kopiert. Empfänger müssen sich in derselben Organisation anmelden.“ Durch das Löschen des Exports wird der Link ungültig.


Echtzeit​

Boards sind kein Livestream. Jedes Board wertet seine Abfragen bei jeder Vorschau oder Darstellung neu aus. Live-Übertragung ist nur im untenstehenden, älteren Canvas möglich.

Der Analysedienst empfängt auch Ereignisse von NATS und kann diese über WebSocket an Browser übermitteln. Fehlt die NATS-Verbindung, ist die Datenerfassung zwar möglich, der Dienst läuft jedoch nicht weiter. Daher beweist ein positiver Wert /health nicht, dass das Streaming funktioniert.


Legacy-Arbeitsbereichs-Canvas​

Legacy-Ansicht

Dies ist das ältere Streaming-Dashboard. Es ist nicht mit dem Menü verlinkt und von Boards getrennt: Ein Workspace-Layout ist kein gespeichertes Board.

Öffnen Sie /dashboard/:workspaceId (oder /studio/dashboards/:workspaceId) mit einer Arbeitsbereichs-ID. Die Seite zeigt einen Titel, eine Schaltfläche mit der Zahl Copilot und ein Raster zum Verschieben und Anpassen der Größe. Auf einer leeren Arbeitsfläche steht: „Ihre Arbeitsfläche ist leer. Öffnen Sie den Copiloten und fügen Sie ein Diagramm hinzu.“

Module. Jedes Modul hat einen Diagrammtyp: kpi, line, bar, table, pie, scatter, gauge, heatmap, alert, funnel, markdown, statlist, radar. Es werden keine Standardmodule erstellt; ein Arbeitsbereich beginnt leer.

Daten. Ein Modul ist an ein Stream-Subjekt gebunden. Die Seite abonniert dieses über einen WebSocket (/api/v1/dashboard/ws/<workspaceId>) und ruft zusätzlich alle 30 Sekunden einen Snapshot ab, falls NATS nicht streamt. Es gibt keinen „Live“-Schalter.

Dashboard Copilot. Das Copilot-Panel sendet Ihre Nachricht an den Analysedienst und wendet die von diesem zurückgegebenen Aktionen an:

AktionAuswirkungen auf den Kunden
add_moduleFügt dem Raster ein Modul hinzu.
update_moduleÄndert den Diagrammtyp oder die Konfiguration eines Moduls.
remove_moduleEntfernt ein Modul.
run_queryFügt ein einmaliges Tabellenmodul hinzu, das die SQL-Anweisung enthält; das Modul selbst ist nicht das Ergebnis.
extract_dataLädt eine Datei von der download_url herunter, die der Server zurückgibt, und nennt sie export.<format> (csv, falls keine vorhanden).
answerNur per SMS antworten.

Der Clienttyp listet ebenfalls create_workspace auf, aber der Client hat keinen Handler dafür, also passiert nichts.


Nicht verfügbar​

  • Geplante Lieferung, E-Mail-Zustellung der Boards und ein Abschnitt Reports.
  • Parquet-Export. Die Formate sind die fünf oben genannten.
  • Freigabe für bestimmte Benutzer oder Rollen. Links sind ausschließlich Organisationslinks, und die Veröffentlichung eines Boards ändert die Berechtigungen nicht.
  • Eine Drag-and-Drop-fähige Arbeitsfläche für Boards. Der Editor ist ein Quelltext- und Eigenschafteneditor mit einer Registerkarte zur Diagrammanordnung.
  • Automatische Umwandlung beliebiger Datensätze in beliebige Diagramme und Bearbeitung einer importierten übergeordneten Datei direkt im Editor.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..