Erstellen, teilen und exportieren Sie ein Board
In dieser Anleitung erstellen Sie ein Analytics → Boards, überprüfen die Vorschau, speichern es, exportieren es und teilen es mit Kollegen in Ihrem Unternehmen. Informationen zu Boards und seinen Grenzen finden Sie in der Analytics-Referenz.
Es gibt keinen Abschnitt Reports, keinen integrierten Management- oder Compliance-Bericht und keine geplante oder per E-Mail versendete Zustellung. Ein „Bericht“ in Tietai ist ein Board, das Sie selbst erstellen und exportieren. Boards befindet sich in der Beta-Phase.
Bevor Sie beginnen
- Wählen Sie Ihre Organisation aus. Ohne Angabe einer Organisation wird auf der Seite „Wählen Sie eine Organisation aus, um Vorstände zu öffnen“ angezeigt.
- Um echte Daten zu verwenden, benötigen Sie eine gespeicherte SQL- oder FHIR-Verbindung in derselben Organisation (Tiet · Hub → Platform → Connectors in der Seitenleiste; im Boards-Bildschirm selbst wird dieser Bereich als „Datenschicht → Konnektoren“ bezeichnet). Für diese Anleitung genügen synthetische Inline-Zeilen.
Ein Beispielboard
Dies ist das Starterboard, das mit dem Analytics-Dienst ausgeliefert wird. Es benötigt keine Datenbank. Wir haben es mit dem Befehlszeilentool hydra-charts validiert und gerendert: Es gibt "valid":true aus und erzeugt ein SVG mit dem Board-Titel Service activity (synthetic), einem Diagramm mit dem Titel Monthly visits, den Monaten Juli, August und September auf der x-Achse und den Achsenwerten 120, 130 und 140.
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
queriesenthält die Daten (activity).chartsbindet Daten an einen Diagrammtyp: einlineDiagramm mitmonthauf der x-Achse undvisitsauf der y-Achse.rowsplatziert das Diagramm. Ein Diagramm, das zwar deklariert, aber nicht in einem Layout aufgeführt ist, wird nicht unbedingt platziert.
Namen sind Referenzen. Wenn Sie activity oder visits umbenennen, aktualisieren Sie alle Stellen, an denen diese Namen verwendet werden.
Erstelle ein Board
- Öffnen Analytics → Boards.
- Wählen Sie Create board.
- Wählen Sie eine Startkarte: Blank canvas, Performance overview oder Service operations, und geben Sie einen Namen für das Spielbrett ein. Die Vorlagen verwenden markierte Beispieldaten.
- Um das obige Beispiel zu verwenden, öffnen Sie Datei Advanced source, wählen Sie das Quellformat YAML aus und fügen Sie den Inhalt ein. Ungültiger Quelltext bleibt bearbeitbar, sodass Sie ihn korrigieren können.
- Wählen Sie Create draft & open editor.
Das Board sollte im Editor angezeigt werden und ist für Ihre Organisation als Draft gespeichert. Alternativ können Sie Create with assistant das Board beschreiben; siehe „Assistent verwenden“.
Tausche das Board aus.
- Wählen Sie auf dem leeren Feld die Show editor aus.
- Wählen Sie Add chart eine Kategorie (Vergleich, Trends, Proportionen, Zusammenfassung, Karten, Medizin) und anschließend eine Karte aus. Das Diagramm wird angehängt und der zugehörige Inspektor geöffnet.
- Ersetzen Sie die Ausgangsdaten oder wählen Sie Dataset, und ordnen Sie dann die Spalten des Diagramms den Spaltennamen dieses Datensatzes zu.
- Verwenden Sie Arrange charts zum Neuanordnen oder Ändern der Größe und Board settings für Titel und Breite.
- Überprüfen Sie die Live-Vorschau. Falls ein Fehler angezeigt wird, behält die Vorschau die letzte gültige Darstellung bei; korrigieren Sie die Quelle oder das Steuerelement.
Um verbundene Daten zu verwenden: Datasets → Connected data sources, wählen Sie die Verbindung aus, geben Sie den schreibgeschützten SQL-Code oder die FHIR-Filter ein, wählen Sie Run preview und dann Add to dashboard. Wenn die Verbindung nicht aufgeführt ist, verwenden Sie Manage connections und dann Refresh connections.
Nutzen Sie den Assistenten
- Wählen Sie Dashboard assistant.
- Beschreiben Sie das Ergebnis, zum Beispiel: „Erstellen Sie ein Operations-Dashboard mit synthetischen monatlichen Besuchen, einer KPI-Gesamtzahl, einem Liniendiagramm und einer Abteilungsübersicht.“
- Erweitern Sie Review proposed source und wählen Sie dann Apply to draft aus.
- Vorschau prüfen, dann Save.
Bei einer Anfrage nach echten Daten lassen Sie die Option Connected data only aktiviert und benennen Sie die Verbindung. Der Assistent sieht Metadaten, nicht Ergebnisse; überprüfen Sie die Zahlen in der Vorschau.
Speichern und veröffentlichen
- Wählen Sie Save. Sie sollten „Board gespeichert“ und eine neue Revision sehen.
- Wählen Sie Publish, sobald das Board bereit ist. Die Revision ist mit Published gekennzeichnet. Dies ändert nichts daran, wer das Board sehen kann.
Wenn beim Speichern ein Revisionskonflikt gemeldet wird, hat jemand eine neuere Version gespeichert. Kopieren Sie Ihren Quellcode, laden Sie ihn neu und führen Sie die Änderungen manuell zusammen.
Export
Wählen Sie Export und anschließend SVG, PNG, PDF, HTML oder JSON. Die Datei wird als board.<format> heruntergeladen und enthält ungespeicherte Änderungen. Die JSON-Datei enthält die ausgewerteten Daten. Boards bietet keinen Export in Parquet- oder Excel-Format.
Teilen Sie es mit Ihrer Organisation
- Öffnen Sie Stored exports, wählen Sie Format und dann Store export. Mit „Export stored“ bestätigen Sie den Vorgang.
- Wählen Sie in der Liste Copy organization link aus. Auf der Seite wird die Meldung „Organisationslink kopiert. Empfänger müssen sich bei derselben Organisation anmelden.“ angezeigt.
- Sende den Link. Er sieht aus wie
https://<platform host>/dashboards/boards?artifact=<id>.
Gespeicherte Exporte werden Expires (UTC) angezeigt; die Standardeinstellung des Dienstes beträgt sieben Tage. Verwenden Sie Delete export, um die Verknüpfung sofort zu widerrufen.
Verifizieren
- Die Vorschau entspricht den erwarteten Daten, einschließlich Einheiten und Datumsangaben.
- Das Display zeigt wie vorgesehen Draft oder Published in der Bibliothek an.
- Öffnen Sie den freigegebenen Link in einem privaten Fenster, in dem Sie als Kollege derselben Organisation angemeldet sind.
Häufige Probleme
| Was Sie sehen | Fix |
|---|---|
| "Wählen Sie eine Organisation aus, um Vorstände zu eröffnen." | Wählen Sie zuerst eine Organisation aus. |
| „Das Board konnte nicht verarbeitet werden. Ihr Entwurf ist weiterhin verfügbar; versuchen Sie es erneut.“ | Wiederholen. Falls das Problem erneut auftritt, überprüfen Sie die Quelle in Source & data. |
| Die Vorschau ändert sich nach der Bearbeitung nicht. | Die Quelle ist ungültig; beheben Sie den angezeigten Fehler. |
| Das Modell des Assistenten ist nicht verfügbar. | Bitten Sie einen Administrator, die Modellkonfiguration der Workflow-Engine zu überprüfen. Ihr Entwurf bleibt unverändert. |
| „Dieser Entwurf überschreitet das Limit von 128 KB für den Assistenten.“ | Bearbeiten Sie den Quellcode direkt oder verkleinern Sie das Board. |
| Es fehlt eine Verbindung zu Datasets | Es muss zu Ihrer Organisation gehören, aktiviert sein und zum Projekt passen; verwenden Sie Refresh connections. |
| Der geteilte Link lässt sich nicht öffnen. | Der Empfänger muss bei derselben Organisation angemeldet sein, und der Export darf nicht abgelaufen oder gelöscht sein. |
Verwandt
- Analysereferenz
- Die Dokumentengenerierung aus einer Pipeline nutzt einen separaten Berichtsgenerator (PDF, HTML, Excel, JSON). Dieser wird den Agenten von der Workflow-Engine als Werkzeug zur Verfügung gestellt; er ist kein Knoten im Knotenkatalog und gehört nicht zu den Boards. Die beiden sind unabhängig.
Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..