WebApps:Dashboard: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(100 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
__TOC__
__TOC__
Verfügbar ab 9.5 HF 3.6


=Systemvoraussetzungen=
=Systemvoraussetzungen=


==Unterstütze Browser==
Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].
* Internet Explorer 11 oder höher
* Edge
* Firefox
* Chrome
 
==CoPlanner Server==
In der [[Technik:CoPlanner-Server#SvrConfig.xml|svrconfig.xml]] muss die WebAppUrl angegeben sein und die notwendigen Schritte für das Einrichten für REST durchgeführt worden sein (siehe [[Technik:CoPlanner-Server#Zusätzliche_Voraussetzungen_für_die_Verwendung_der_REST-Funktionalitäten]])
 
 
 
=Aufruf Dashboard=
=Aufruf Dashboard=
@Session_WebAppUrl@/dashboard/?dashboard=<Dashboard Name>&SessionID=@Session_ID@
@Session_WebAppUrl@/dashboard/?dashboard=<Dashboard Name>


Beispiel:
Beispiel:


<nowiki>https://servername:4444/coplanner/dashboard/?dashboard=Mein erstes Dashboard</nowiki>
<nowiki>https://servername:4444/coplanner/dashboard/?dashboard=Mein erstes Dashboard</nowiki>
===Erweiterter Aufruf===
* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.
* contextFilters: Definiert die Filterwerte, mit der das Dashboard geöffnet wird


Beispiel:


===Erweiterter Aufruf===
Übergabe auf Filter Zeit, Filteroperator =, Element mit der COPSYS_ID 2 und Unternehmen, Filteroperator me+under, Element mit der COPSYS_ID 1


:* hideSessionHeader: Definiert, ob der Session-Header angezeigt werden soll oder nicht (true blendet Session-Header aus). Der Default beim Öffnen ist false.
&contextFilters=Zeit eq 2 and Unternehmen mu 1


=Aufruf für das Erstellen eines Dashboards=
Bei Verwendung von " and " im Filternamen bzw. übergebenen Wert oder Leerzeichen muss wie folgt vorgegangen werden:
Über die [[WebApps:Tiles|Tiles]] können über folgenden Aufruf neue Diagramme erstellt werden.


@Session_WebAppUrl@/Dashboard/Dashboard=[new]&SessionID=@Session_ID@
&contextFilters="Mein Filter" eq "Text mit Leerzeichen"


{| {{Bausteindesign1}}
Operatoren:
{| class="wikitable"
! Filteroperator
! Aufruf im Kontext
! Beschreibung
|-
|-
| <span style="color: darkblue;">'''Hinweis'''</span> &nbsp;Funktioniert nur im PowerUser Modus
| [[Image:Filter_Operand_Alle.jpg]]
| mu
| Ausgewähltes Element und alle Ebenen darunter werden dargestellt.
|-
| [[Image:Filter_Operand_ParentChild.jpg]]
| mf
| Ausgewähltes Element und eine Ebenen darunter werden dargestellt.
|-
| [[Image:Filter_Operand_OhneParent.jpg]]
| un
| Alle Ebenen unter dem ausgewähltem Element werden dargestellt.
|-
| [[Image:Filter_Nur_Ebene_darunter.jpg]]
| fu
| Eine Ebene unter dem ausgewähltem Element wird dargestellt.
|-
| =
| eq
| Nur Werte dieses Dimensionselement werden dargestellt.
|-
| <>
| ne
| Alle Werte werden dargestellt, nur die des ausgewählten Filterelements nicht.
|}
|}


=Menü=
=Menü=
 
{| class="wikitable"
{| class="wikitable" width="857"
|+
|- {{Tabellentitel}}
! Schaltfläche
| Schaltfläche
! Aktion
| Aktion
|-
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| [[Image:CoPlannerLogoHeader.png]]
| Zurück zur letzten davor aufgerufenen Seite.
| Navigation zur in der SvrConfig hinterlegten Startseite. (Parameter: [[Technik:CoPlanner-Server#WebConfig|StartUrl]]) ''<small>(Ab CoPlanner 11 Release 1 2025)</small>''<br> Zurück zur letzten davor aufgerufenen Seite. ''<small>(Bis CoPlanner 11 Release 1 2025)</small>''
|-
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| [[Image:WebVerticalMenueOpen.png]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
| Öffnen/Schließen des seitlichen Menüs.
|-
|-
| [[Image:Dahboard_Ansichtsmodus.PNG]]
| [[Image:Dahboard_Ansichtsmodus.PNG]]
| In den Ansichtsmodus wechseln
| In den Ansichtsmodus wechseln (nur als PowerUser möglich)
|-
|-
| [[Image:Dashboad_Bearbeiten.PNG]]
| [[Image:Dashboad_Bearbeiten.PNG]]
| In den Bearbeitungsmodus wechseln
| In den [[WebApps:Dashboarddesigner|Bearbeitungsmodus/Dashboarddesigner]] wechseln (nur als PowerUser möglich)
|-
|-
| [[Image:Web_Speichern.PNG]]
| [[Image:Web_Speichern.PNG]]
Zeile 67: Zeile 83:
| Aktivieren/Deaktivieren der Nullwertunterdrückung.
| Aktivieren/Deaktivieren der Nullwertunterdrückung.
|-
|-
| [[Image:ReportViewer_Filterbereich.JPG]]
| [[Image:DB_Outfilter_aktiv.JPG]]
| Out-Filter aktiv
| Out-Filter aktiv
|-
| [[Image:Pivotform_ExcelExport.PNG]]
| Excel Export des Dashboard
|-
|[[Datei:WebVerticalMenueCoPlannerAgent.png]]
|Aufruf des [[WebApps:CoPlanner Agent|CoPlanner Agents]]
|}
|}


=Arbeiten mit dem Dashboard=
Im Dashboard kann sehr ähnlich zu den anderen WebApps gearbeitet werden. Wie bei den bestehenden Masken kann über das Menü links die Nullwertunterdrückung (de-)aktiviert werden und die Filter ein-/ausgeblendet werden. Im Dashboard kann man nun mit den Elementen arbeiten und Daten erfassen.
Für das aktive Dashboard Element erscheint oben rechts eine kleine Symbolleiste. Diese enthält verschiedene Optionen für das jeweilige Element, unter anderem
* Zurücksetzen der Ansicht dieses Dashboardelements.<small>''(Ab CoPlanner 11 Release 3 2024)''</small> : Hierdurch wird ein Reset ausgeführt und z. B. Filtereinstellungen, Achsenverschiebungen auf dem Element zurückgesetzt (diese Aktion war bisher STRG-Klick auf den aktualisieren Button verfügbar). Es werden die Dashboard spezifischen Parameter, wie z. B. globaler Dashboardfilter (falls konfiguriert für dieses Element), Url-Kontext, auf Element angewandt.
* Detailsatzsprung des ausgewählten Datensatzes innerhalb einer Maske
* Datensatz löschen
* Element bearbeiten (nur für PowerUser)
* Hinweis anzeigen (''<small>Ab CoPlanner 11 Release 1 2025</small>'')
* Excel Export dieses Dashboardelements
* Suche innerhalb dieses Dashboardelements
* Achsen drehen (nur bei Matrixmasken)
* Element maximieren innerhalb des Dashboardfensters
* Dashboardelement in neuem Tab öffnen
* ggf. für dieses Element hinterlegte Makros können aufgerufen werden
''<small>Ab CoPlanner 11 Release 3 2023</small>''
Berichte, Matrixmasken, Einzelsatzmasken und Zeilensicht können - ähnlich zur Maximieren Funktion - in einem neuen Browserfenster geöffnet werden um mehr Informationen auf einmal anzeigen lassen zu können. Diese Funktion kann durch klicken auf dieses Symbol [[Datei:DashboardElementInNeuemFensteroeffnenOpenOutside.png|12x12px]] erreicht werden. Folgende Informationen können in den neuen Tab mitgegeben werden
* Matrixmaske: Filter, ausgewählte Elemente auf den Achsen, Zellkontext (über Filter), Durch Nullwertunterdrückung eingeschränkte Daten (Nullwertunterdrückung selbst wird nicht weitergegeben)
* Zeilensicht: Filter, Zellkontext (über Filter)
* Einzelsatz: Filter, teils ausgewählte Elemente (über Filter)
Alle nicht genannten Parameter können nicht in das neue Fenster übergeben werden (z. B. eine ReadOnly Einstellung der Daten etc.).
Die generelle Dimensionssecurity (Nutzerberechtigungen) ziehen natürlich trotzdem.
== Im Dashboard auf Berechnungen warten ==
In Dashboards ist es auch möglich, auf Berechnungen zu warten (ähnlich wie dies bereits in einzelnen Masken funktioniert). Das funktioniert dabei wie folgt:
* in der Maske, in der die Daten eingegeben werden, muss [[WaitForCalc|WaitForCalc]] aktiv sein ([[WaitForCalc|WaitForCalc]] wird immer nur beim Schreiben von Daten berücksichtigt und hat in Masken, in denen Daten nur gelesen werden, keine Auswirkungen)
* es schlägt dabei der Modus für Waitforcalc durch der in der Maske definiert ist.
Das Dashboard funktioniert so, dass zuerst auf das Refresh der Maske, in der Daten eingegeben wurden, gewartet wird, und dann im Anschluss alle weiteren Teile des Dashboards refresht werden.


=Bearbeiten-Modus=
= Tabs im Dashboard =
{{CopneoHinweis}}


Im Bearbeiten-Modus kann man das Dashboard als Power-User erstellen und bearbeiten.
''<small>Für Kunden ohne CoPlanner NEO Lizenz ist weiterhin die Benutzung des Dashboards mit nur einem Tab pro Dashboard möglich.</small>''
Die Oberfläche ist grundlegend in zwei Teile unterteilt. Im linken Bereich ist ein Objektkatalog verfügbar, mit welchem man bestehende Diagramme, Dimensionen, Pivotmasken, Tabellen und IFrames per Drag & Drop in das Dashboard ziehen kann. Zusätzlich besteht die Möglichkeit mit den "neu"-Buttons neue Diagramme, Dimensionen oder Pivotmasken zu erstellen. Der Hauptbereich ist das Dashboard, welches mit den unterschiedlichen Elementen des Objektkatalogs erstellt und erweitert werden kann.  


Sobald man ein Element in das Dashboard integriert hat, kann man in der linken oberen Ecke einen alternativen Titel für das Element vergeben.
''Verfügbar ab CoPlanner 11 Release 1 2026''


[[Image:Objektkatalog.JPG]]
Es ist nun möglich im Dashboard Tabs zu definieren.


Sobald man nun ein Element in das Dashboard gezogen hat, stehen im rechten oberen folgende Optionen zur Verfügung:
Jeder Tab verhält sich bei der Erstellung und Handhabung der Elemente wie ein "eigenes" Dashboard (Hinzufügen von Elementen, Filterdefinition etc), es kann jedoch über eine Tableiste oben im in den Dashboards umgeschaltet werden wenn mehrer Tabs definiert sind.


{| class="wikitable" width="857"
Die globalen DB-Filter ziehen dann im jeden Dashboard Tab(, abhängig natürlich davon wie sie in den Elementen definiert sind, so wie in Dashboards ohne Tabs auch.) Die Filterweitergabe funktioniert auch zwischen mehreren Tabs (nur über den globalen Filter).
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:filter.JPG]]
| Setzen der Filterverknüpfungen
|-
| [[Image:maximieren.JPG]]
| Maximieren des ausgewählten Elements
|-
| [[Image:verschieben.JPG]]
| Verschieben des aktuellen Elements innerhalb des Dashboards
|-
| [[Image:loeschen.JPG]]
| Löschen des Elements
|}


Tabnamen können mehrsprachig sein und die Reihenfolge der Tabs kann in der Definition beliebig angepasst werden.


Allgemeine Hinweise


=Ansichtsmodus=
* Wenn nur ein einziger Tab im Dashboard definiert ist, sieht im Ansichtsmodus alles aus wie bisher, es wird keine Tableiste mit nur einem Tab eingeblendet.
* Die Tableiste wird zwischen der globalen Filterleiste und den Dashboard Elementen oben angezeigt
* Die Daten für jedes Tab werden erst bei Klick auf das Tab geladen


Die Tabs können im [[WebApps:Dashboarddesigner#Tabs im Dashboard|Dashboarddesigner]] definiert und angepasst werden
__NOEDITSECTION__
__NOEDITSECTION__


[[Category:WebApps|Dashboard]]
[[Category:WebApps|Dashboard]]
[[Category:CopNeo|Dashboard]]
[[en:WebApps:Dashboard]]
[[en:WebApps:Dashboard]]

Aktuelle Version vom 1. Oktober 2026, 10:32 Uhr

Systemvoraussetzungen

Die Voraussetzungen finden Sie hier.

Aufruf Dashboard

@Session_WebAppUrl@/dashboard/?dashboard=<Dashboard Name>

Beispiel:

https://servername:4444/coplanner/dashboard/?dashboard=Mein erstes Dashboard

Erweiterter Aufruf

  • hideSessionHeader: Definiert, ob der Header angezeigt werden soll oder nicht (true blendet Header aus). Der Default beim Öffnen ist false.
  • contextFilters: Definiert die Filterwerte, mit der das Dashboard geöffnet wird

Beispiel:

Übergabe auf Filter Zeit, Filteroperator =, Element mit der COPSYS_ID 2 und Unternehmen, Filteroperator me+under, Element mit der COPSYS_ID 1

&contextFilters=Zeit eq 2 and Unternehmen mu 1

Bei Verwendung von " and " im Filternamen bzw. übergebenen Wert oder Leerzeichen muss wie folgt vorgegangen werden:

&contextFilters="Mein Filter" eq "Text mit Leerzeichen"

Operatoren:

Filteroperator Aufruf im Kontext Beschreibung
mu Ausgewähltes Element und alle Ebenen darunter werden dargestellt.
mf Ausgewähltes Element und eine Ebenen darunter werden dargestellt.
un Alle Ebenen unter dem ausgewähltem Element werden dargestellt.
fu Eine Ebene unter dem ausgewähltem Element wird dargestellt.
= eq Nur Werte dieses Dimensionselement werden dargestellt.
<> ne Alle Werte werden dargestellt, nur die des ausgewählten Filterelements nicht.

Menü

Schaltfläche Aktion
Navigation zur in der SvrConfig hinterlegten Startseite. (Parameter: StartUrl) (Ab CoPlanner 11 Release 1 2025)
Zurück zur letzten davor aufgerufenen Seite. (Bis CoPlanner 11 Release 1 2025)
Öffnen/Schließen des seitlichen Menüs.
In den Ansichtsmodus wechseln (nur als PowerUser möglich)
In den Bearbeitungsmodus/Dashboarddesigner wechseln (nur als PowerUser möglich)
Speichert alle Änderungen
Aktualisieren der Daten.
Aktivieren/Deaktivieren der Nullwertunterdrückung.
Out-Filter aktiv
Excel Export des Dashboard
Aufruf des CoPlanner Agents

Arbeiten mit dem Dashboard

Im Dashboard kann sehr ähnlich zu den anderen WebApps gearbeitet werden. Wie bei den bestehenden Masken kann über das Menü links die Nullwertunterdrückung (de-)aktiviert werden und die Filter ein-/ausgeblendet werden. Im Dashboard kann man nun mit den Elementen arbeiten und Daten erfassen.

Für das aktive Dashboard Element erscheint oben rechts eine kleine Symbolleiste. Diese enthält verschiedene Optionen für das jeweilige Element, unter anderem

  • Zurücksetzen der Ansicht dieses Dashboardelements.(Ab CoPlanner 11 Release 3 2024) : Hierdurch wird ein Reset ausgeführt und z. B. Filtereinstellungen, Achsenverschiebungen auf dem Element zurückgesetzt (diese Aktion war bisher STRG-Klick auf den aktualisieren Button verfügbar). Es werden die Dashboard spezifischen Parameter, wie z. B. globaler Dashboardfilter (falls konfiguriert für dieses Element), Url-Kontext, auf Element angewandt.
  • Detailsatzsprung des ausgewählten Datensatzes innerhalb einer Maske
  • Datensatz löschen
  • Element bearbeiten (nur für PowerUser)
  • Hinweis anzeigen (Ab CoPlanner 11 Release 1 2025)
  • Excel Export dieses Dashboardelements
  • Suche innerhalb dieses Dashboardelements
  • Achsen drehen (nur bei Matrixmasken)
  • Element maximieren innerhalb des Dashboardfensters
  • Dashboardelement in neuem Tab öffnen
  • ggf. für dieses Element hinterlegte Makros können aufgerufen werden

Ab CoPlanner 11 Release 3 2023

Berichte, Matrixmasken, Einzelsatzmasken und Zeilensicht können - ähnlich zur Maximieren Funktion - in einem neuen Browserfenster geöffnet werden um mehr Informationen auf einmal anzeigen lassen zu können. Diese Funktion kann durch klicken auf dieses Symbol erreicht werden. Folgende Informationen können in den neuen Tab mitgegeben werden

  • Matrixmaske: Filter, ausgewählte Elemente auf den Achsen, Zellkontext (über Filter), Durch Nullwertunterdrückung eingeschränkte Daten (Nullwertunterdrückung selbst wird nicht weitergegeben)
  • Zeilensicht: Filter, Zellkontext (über Filter)
  • Einzelsatz: Filter, teils ausgewählte Elemente (über Filter)

Alle nicht genannten Parameter können nicht in das neue Fenster übergeben werden (z. B. eine ReadOnly Einstellung der Daten etc.).

Die generelle Dimensionssecurity (Nutzerberechtigungen) ziehen natürlich trotzdem.

Im Dashboard auf Berechnungen warten

In Dashboards ist es auch möglich, auf Berechnungen zu warten (ähnlich wie dies bereits in einzelnen Masken funktioniert). Das funktioniert dabei wie folgt:

  • in der Maske, in der die Daten eingegeben werden, muss WaitForCalc aktiv sein (WaitForCalc wird immer nur beim Schreiben von Daten berücksichtigt und hat in Masken, in denen Daten nur gelesen werden, keine Auswirkungen)
  • es schlägt dabei der Modus für Waitforcalc durch der in der Maske definiert ist.

Das Dashboard funktioniert so, dass zuerst auf das Refresh der Maske, in der Daten eingegeben wurden, gewartet wird, und dann im Anschluss alle weiteren Teile des Dashboards refresht werden.

Tabs im Dashboard

inline Diese Funktion ist nur in CoPlanner NEO verfügbar

Für Kunden ohne CoPlanner NEO Lizenz ist weiterhin die Benutzung des Dashboards mit nur einem Tab pro Dashboard möglich.

Verfügbar ab CoPlanner 11 Release 1 2026

Es ist nun möglich im Dashboard Tabs zu definieren.

Jeder Tab verhält sich bei der Erstellung und Handhabung der Elemente wie ein "eigenes" Dashboard (Hinzufügen von Elementen, Filterdefinition etc), es kann jedoch über eine Tableiste oben im in den Dashboards umgeschaltet werden wenn mehrer Tabs definiert sind.

Die globalen DB-Filter ziehen dann im jeden Dashboard Tab(, abhängig natürlich davon wie sie in den Elementen definiert sind, so wie in Dashboards ohne Tabs auch.) Die Filterweitergabe funktioniert auch zwischen mehreren Tabs (nur über den globalen Filter).

Tabnamen können mehrsprachig sein und die Reihenfolge der Tabs kann in der Definition beliebig angepasst werden.

Allgemeine Hinweise

  • Wenn nur ein einziger Tab im Dashboard definiert ist, sieht im Ansichtsmodus alles aus wie bisher, es wird keine Tableiste mit nur einem Tab eingeblendet.
  • Die Tableiste wird zwischen der globalen Filterleiste und den Dashboard Elementen oben angezeigt
  • Die Daten für jedes Tab werden erst bei Klick auf das Tab geladen

Die Tabs können im Dashboarddesigner definiert und angepasst werden