Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:dashboard:dashboard_documentation [2015/12/18 10:04]
jan.mayer [Layout und Anordnung]
+++ software:dashboard:dashboard_documentation [2021/07/01 09:52] (aktuell)
@@ Zeile 1: / Zeile 1: @@
+====== Dashboard - Übersicht ======
 ==== Login Dashboard ====
-{{ :software:dashboard:loginscreen.jpg?300 |}}
 Momentan kann sich jeder TIM Benutzer mit seinen Logindaten in das Dashboard einloggen und dort seine eigenen Ansichten gestalten. Um überhaupt eine Ansicht anzulegen, kann im Menü **Dashboards** ein neues Dashboard angelegt werden.
+{{ :software:dashboard:loginscreen.jpg?300 |}}
 {{ :software:dashboard:new_dashboard.jpg?300 |}}
@@ Zeile 8: / Zeile 10: @@
 ==== Widgets hinzufügen/anlegen ====
 {{ :software:dashboard:widget_hinzufuegen.jpg?direct&300|}}
-Jedes Dashboard kann beliebig viele Widgets enthalten. Ein Widget kann nahezu jeden Informationsgehalt beinhalten und muss von einem [[software:tim:rights|Administrator]] definiert werden. Wenn der eingeloggte Nutzer keine Adminrechte besitzt, ist es diesem nicht möglich ein Widget hinzuzufügen.
+Jedes Dashboard kann beliebig viele Widgets enthalten. Ein Widget kann nahezu jeden Informationsgehalt beinhalten und muss von einem [[software:tim:roles|Administrator]] definiert werden. Wenn der eingeloggte Nutzer keine Adminrechte besitzt, ist es diesem nicht möglich ein Widget hinzuzufügen.
 > Welche Tabelle und welche Struktur von TIM genutzt werden kann, kann in der [[dashboard_tablestructure|Tabellenstruktur]] nachgelesen werden.
@@ Zeile 31: / Zeile 33: @@
 ==== Layout und Anordnung ====
 Das Dashboard bietet eine Reihe verschiedener Layouts bzw. Anordnungen. Das entsprechende Layout wirkt sich immer auf das aktuell ausgewählte Dashboard aus und ordnet die Widgets automatisch an. Sollte ein Widget falsch positioniert sein, kann dieses in eine andere Kachel gezogen werden und nimmt dann die Größe des vordefinierten Layouts an. \\
-{{:software:dashboard:layout.jpg? }}
+{{:software:dashboard:layout.jpg?600 }}
-{{ :software:dashboard:widget_drag_and_drop.jpg? }}
+{{ :software:dashboard:widget_drag_and_drop.jpg?600 }}
 \\
@@ Zeile 48: / Zeile 50: @@
 ==== Grafische Auswertungen von Widgets====
-Sollte eine grafische Ansicht eines Widgets gewünscht sein, kann dies auch einfach und flexibel umgesetzt werden. Hierzu muss eine sinnvolle X und Y-Achse vorhanden sein, was in unserem Beispiel nicht gegeben ist, da sich aus Name und Email keine Achsen bilden lassen. Somit erstellen wir uns ein neues Widget, welches anzeigen soll wie viel Benutzer an welchen Wochentagen erstellt wurden.
+Widgets können mit unterschiedlichen Grafiken (Barchart, Piechart, etc.) visualisiert wird. Für eine sinnvolle Visualisierung werden Daten benötigt, die in einem Koordinatensystem abgebildet werden können. Dies ist im obigen Widget nicht gegeben, da dieses alle Nutzer sowie die zugehörigen Email-Adressen zurückgibt. \\
+Der folgende SQL-Code gibt zurück wie viele Benutzer pro Wochentag erstellt wurden. Das Widget lässt sich gut als Barchart darstellen (s. Screenshot).
 <code sql>
 select DAYNAME(creationtime) as Tag, count(DAYNAME(creationtime)) as Anzahl from view_identity group by DAYNAME(creationtime)
 </code>
 Dieses können wir wie gewohnt abspeichern und auf einem Dashboard hinzufügen. Danach, kann über das Diagramm Symbol die X-, und Y-Achse eingestellt werden und das Diagramm erscheint. Sollte eine Art von Diagramm gewünscht sein, kann dies über die Konfiguration des entsprechenden Widgets angepasst werden.
->> TIPP!
-> Sollte eine Auswertung nicht mehr aussagekräftig sein, weil ein Wert außerhalb der Norm liegt, kann dieser über einen Klick in der Legende entfernt werden.
+<note tip>Sollte eine Auswertung nicht mehr aussagekräftig sein, weil ein Wert außerhalb der Norm liegt, kann dieser über einen Klick in der Legende entfernt werden.</note>
 {{ :software:dashboard:widget_grafische_auswertung.jpg?800 |}}
@@ Zeile 60: / Zeile 63: @@
 -------
 ==== Arbeiten mit Variablen ====
-Das Dashboard ermöglicht es auch, Widgets nach einer Auswahl eines variablen Wertes anzuzeigen. In dem Beispiel des ersten Widgets, sollen nicht alle Benutzer angezeigt werden, sondern es soll selber ausgewählt werden können welcher Inhalt angezeigt werden soll. Hierzu wird das Widget wie folgt geändert:
+Im Dashboard können Widgets anhand eines Variablenwertes angezeigt werden. Im Benutzer-Email-Widget sollen nicht automatisch alle Benutzer angezeigt werden. Der Benutzer soll selbst entscheiden können, welche Information angezeigt werden sollen. Das Widget wird wie folgt verändert:
 <code sql>
 SELECT name, email FROM view_identity WHERE identityType = :identType
 </code>
 {{ :software:dashboard:variablendefinition.jpg?direct&300|}}
->>Hinweis!
-> Variablen werden im Dashboard immer mit einem :Variablenname gekennzeichnet
-Im zweiten Schritt, müssen wir definieren, welchen Inhalt unsere Variable haben soll. Hierzu kann das Menü \\
+<note> Variablen werden im Dashboard immer mit einem :Variablenname gekennzeichnet</note>
+Im zweiten Schritt wird definiert, welchen Inhalt die Variable haben soll. Hierzu kann das Menü \\
 **Dashboards -> Einstellungen -> Variablendefinition** \\
 gewählt werden. Durch den Button "Variable hinzufügen" erhält man einen neuen Eingabebereich in dem die Variable definiert werden kann. Folgende Felder stehen hierbei zur Verfügung:
@@ Zeile 83: / Zeile 86: @@
 Zum Testen der Variable sollte diese vor dem speichern ausgeführt werden und **5 Ergebnisse** zurückliefern. \\
 {{ :software:dashboard:widget_variable.jpg?direct |}}
-Danach kann in der Konfiguration des Widgets der Variablenwert definiert werden und mit **OK** bestätigt werden. Der neue Inhalt wird sich je nach System und Variableneinstellung nun anpassen. Wurde das Widget gespeichert, sieht die Auswahl wie folgt aus
+Anschließend kann in der Widget-Konfiguration der Variablenwert definiert und mit **OK** bestätigt werden. Der neue Inhalt passt sich je nach System- und Variableneinstellung. Das Widget gibt folgende Tabelle zurük.
 {{ :software:dashboard:gespeicherteswidget_variable.jpg?direct |}}
@@ Zeile 91: / Zeile 94: @@
 <note tip>Muss das gleiche Widget für z.B. mehrere Abteilungen angelegt werden, kann eine Variable eingesetzt werden, die pro Widget gesperrt werden kann. Somit kann der Endbenutzer die Variable nicht mehr ändern</note>
-{{ :software:dashboard:lock_variables.png?300|}}
+{{ :software:dashboard:lock_variables.png }}
-Wenn nun der Wert der Variable gelockt wird, können die User diesen Wert nicht mehr ändern. Im Beispiel des Screenshots wäre also immer der Wert "User" ausgewählt, dies kann nur vom Besitzer des Widgets geändert werden. Dadurch kann ein Widget auf verschiedenen Dashboards eingesetzt werden, ohne dass User unberechtigterweise Daten sehen.
+Eine gesperrte Variable kann nur vom Besitzer des Widgets geändert werden. So kann verhindert werden, dass Benutzer unberechtigterweise beliebige Daten einsehen können.
@@ Zeile 115: / Zeile 118: @@
 ==== Vordefinierte Dashboards freigeben ====
-{{ :software:dashboard:dashboard_konfiguration.jpg?600|}}
+Ist ein Dashboard mit allen nötigen Widgets und Einstellungen versehen, kann dies für TIM Gruppen freigegeben werden. Benutzer dieser Gruppen können sich danach ins Dashboard einloggen und sehen das entsprechende Dashboard mit den dazugehörigen Widgets und deren Einstellungen.
-Ist ein Dashboard mit allen nötigen Widgets und Einstellungen versehen, kann dies für TIM Gruppen freigegeben werden. Die Benutzer dieser Gruppe können sich danach ins Dashboard einloggen und sehen das entsprechende Dashboard mit den dazugehörigen Widgets und deren Einstellungen.
 Freigaben können unter folgenden Menüpunkt eingerichtet werden:
 **Dashboards -> Einstellungen -> Dashboards** \\
 Hier kann unter Konfiguration des entsprechenden Dashboards gewählt werden. Durch Auswahl der gewünschten TIM-Gruppen (Strg gedrückt halten) kann das Dashboard nun für die gewünschten Gruppen freigegeben werden.
-{{:software:dashboard:auswahl_freigabe.jpg?300|}}
+{{:software:dashboard:dashboard_konfiguration.jpg }}
+{{ :software:dashboard:auswahl_freigabe.jpg?300 }}
 -----
+==== Reports hochladen ====
+{{:software:dashboard:dashboard_report_upload.png?500|}}
+Das Dashboard kann bei Bedarf Widgets in einen Report exportieren und diese auch in regelmäßigen Abständen an bestimmte User/Gruppen versenden. Hierzu muss eine Worddatei mit einer Tabelle eingereichert werden, welche den Namen des zu exportierenden Widgets in der ersten Zelle beinhaltet. {{:software:dashboard:dashboard_report_layout.png?600|}}
+-----
+==== Reports konfigurieren ====
+{{ :software:dashboard:dashboard_report_configuration.png?800 |}}
+^ Element  ^  Erklärung  ^
+^1^ Gibt den Betreff der generierten Mail an. |
+^2^ Gibt den Inhalt der generierten Mail an. |
+^3^ Aktiviert bzw Deaktiviert den Report |
+^4^ Gibt das Datum an, an welchen der Erste Report versendet werden soll. |
+^5^ Gibt an, wie oft der Report versendet werden soll, wenn dieser aktiv ist. |
+^6^ Holt sich die Uhrzeit aus der Angabe in den Dashboard.properties (siehe "Automatische Reports generieren). |
+^7^ Hier können die Empfänger in Form von Benutzer und Gruppen gepflegt werden. |
+----
+==== Automatische Reports generieren =====
+Um die Reports automatisch versenden zu lassen, müssen die [[software:dashboard:dashboard_installation#installation|dashboard.properties (siehe Installation)]] angepasst werden. Hierzu müssen folgende Werte je nach Wunsch angepasst werden
+^ Name ^ Beschreibung ^
+^ timerInterval ^ Wie oft soll geprüft werden, ob ein Report nötig ist |
+^ timerIdentityName ^ [[software:tim:log_in|Benutzername]] der den entsprechend Eintrag in der [[software:tim:administration_client#email_queue|Mailqueue]] erzeugt (zB wiki/dashboard) |
+^ timerIdentityPassword ^ Das dazugehörige Passwort für den Benutzer |
+^ emailSender ^ Hier kann die Engine angegeben werden, mit der die Mails versendet werden. Sollte fast immer auf "tim" stehen. |
+^ morningReportHours ^ Gibt die Uhrzeit in Stunden an, an der der Report am Morgen versendet wird (Serverzeit wird als Grundlage genutzt). Der Wert 10 steht für 10:00Uhr |
+^ eveningReportHours ^ Gibt die Uhrzeit in Stunden an, an der der Report am Abend versendet wird (Serverzeit wird als Grundlage genutzt). |

TIM Wiki / NEW TIM 6 Documentation

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge