Dashboards

Prev Next

Mit Hilfe des Dashboard-Designers lassen sich benutzerspezifische Masken mit Auswertungsdiagrammen erstellen, die ihre Daten direkt aus dem Lobster Data Platform / Orchestration-System erhalten können.

Zentrales Werkzeug des Dashboard-Designers ist der Formulardesigner, der auch für die Erstellung von Geschäftsobjekt-Masken verwendet wird.

Folgende Bezeichnungen sind zu unterscheiden:

  • Dashboard - Ein Objekt, das in der Übersicht "Dashboards" erscheint.

  • Dashboard-Element - Ein Element, das mit dem Formular-Designer auf die Maske eines Dashboards gezogen werden kann.

 ACHTUNG  Beim Lobster_pro Dashboard handelt es sich um eine reine Visualisierungsschicht für statistische Daten. Die Anzahl an zu verarbeitenden Datensätzen hat daher natürliche Grenzen. Wo diese Grenze liegt ist von der Rechenleistung des Client-Systems abhängig und muss vor allem durch Testen herausgefunden werden. Das Laden und Verdichten der Daten in der Dashboardkonfiguration wird ausschließlich vom Client (Browser) durchgeführt, was die Performance der Anwendung, abhängig von der Datenmenge, signifikant beeinträchtigen kann. In solchen Fällen wird empfohlen die Daten extern vorzuverdichten (z.B. über ein Data-Mining Tool oder durch inkrementelles Exportieren der relevanten Daten in eine externe Datenbanktabelle) und diese dann z.B. via Profil aufrufen (Lobster_data) zur Verarbeitung in das Lobster_pro Dashboard zu laden.

Technisches Prinzip

Das Dashboard besteht aus einer Kette von drei Elementen:

images/download/attachments/58599741/image2018-6-11_8_30_41-version-1-modificationdate-1603101329162-api-v2.png

Über eine Datenquelle werden die Daten aus dem Lobster Data Platform / Orchestration-System gelesen und an das Dashboard-Element (das Formularelement "Dashboardkonfiguration") geliefert. Das Dashboard-Element bildet aus den Daten einen OLAP-Würfel (siehe Wiki: OLAP-Würfel), der dem Chart zur Visualisierung bereitgestellt wird.

In einem Dashboard muss es mindestens eine Datenquelle, ein Dashboard-Element und ein Chart-Element geben. Jede dieser Komponenten kann mehrfach vorkommen, z.B. können innerhalb eines Dashboards zwei Dashboard-Elemente auf eine Datenquelle zugreifen, oder zwei Chart-Elemente auf ein Dashboard-Element.

Bereitgestellt werden die Daten in einem Verhalten über die Aktion "Geteilten Datenprovider setzen", in der eine Datenprovider ID als eindeutiger Name dieses Datensatzes definiert wird.

Verbindung zwischen Quelle und Dashboards konfigurieren

images/download/attachments/58599741/image2018-6-11_13_34_53-version-1-modificationdate-1603101329139-api-v2.png

Eine Datenquelle stellt ihr Suchergebnis über die Aktion "Geteilten Datenprovider setzen" den vorhandenen Dashboard-Elementen zur Verfügung.

images/download/attachments/58599741/image2018-6-11_13_33_23-version-1-modificationdate-1603101329131-api-v2.png

Die Service Info des Dashboard-Elements ist so konfiguriert, dass der Service "SHARED_DATA_PROVIDER" und der "GenericDataProviderConverter" gewählt sind.

Im Funktionsnamen muss die Datenprovider ID der Datenquelle eingetragen werden, auf deren Daten zugegriffen werden soll.

Verbindung zwischen Dashboard und Charts konfigurieren

images/download/attachments/58599741/image2018-6-11_13_41_54-version-1-modificationdate-1603101329128-api-v2.png

Ein Dashboard-Element stellt die aufbereiteten Daten wiederum in einem Verhalten vom Typ "Statisch" über die Aktion "Geteilten Datenprovider setzen" den vorhandenen Charts zur Verfügung. Der Auslöser für das Verhalte ist "Dashboardabfrage Ausgeführt".

In der Aktion wird wieder eine eindeutige Datenprovider ID definiert, die eindeutig sein muss. Die ID muss jetzt eine andere sein, als die, welche von der Datenquelle verwendet wurde.

images/download/attachments/58599741/image2018-6-11_13_44_28-version-1-modificationdate-1603101329150-api-v2.png

Die Service Info der Charts ist so konfiguriert, dass der Service "SHARED_DATA_PROVIDER" und der "DashboardDataProviderConverter"  HINWEIS  Das ist nicht der gleiche Konverter wie beim Dashboard gewählt sind.

Im Funktionsnamen muss dann die Datenprovider ID des Dashboard-Elements eingetragen werden, auf dessen Daten man zugreifen will.

 WICHTIG  Das Unterkapitel Dashboardkonfiguration zeigt die Konfiguration eines Dashboards detailliert Schritt für Schritt.

Dashboard-Übersicht

Über den Menüpunkt "Dashboard" (Verwaltung - Konfiguration) gelangt man auf die Übersichtsseite der für den eingeloggten Benutzer sichtbaren Dashboards.

images/download/attachments/58599741/image2018-6-11_8_4_57-version-1-modificationdate-1603101329167-api-v2.png

Die Ribbon-Buttons der Übersichtsseite haben folgende Funktion:

Details

  • Neu - Die Dashboard-Erfassungsmaske für das Anlegen eines neuen Dashboards öffnen.

  • Löschen - Das ausgewählte Dashboard kann gelöscht werden. Der Button ist nur aktiviert, wenn ein Eintrag der Dashboard-Liste ausgewählt ist.

  • Bearbeiten - Die Dashboard-Erfassungsmaske öffnen und das ausgewählte Dashboard laden um es zu bearbeiten. Der Button ist nur aktiviert, wenn ein Eintrag der Dashboard-Liste ausgewählt ist.

  • Abbrechen - Die Auswahl in der Dashboard-Liste wird aufgehoben. Der Button ist nur aktiviert, wenn ein Eintrag der Dashboard-Liste ausgewählt ist.

Liste

Zuordnung

  • Zuweisen - Über die Anwendung bestehender Zuordnungskriterien kann ein Dashboard für bestimmte Benutzergruppen freigeschaltet werden. Der Button ist nur aktiviert, wenn ein Eintrag der Dashboard-Liste ausgewählt ist.

Änderungsverlauf

  • Liste - Es kann eine Liste aller jemals von einem Dashboard gespeicherten Versionen angezeigt werden. Eine beliebige Version kann reaktiviert werden. Das ist nützlich, falls man versehentlich etwas aus dem Dashboard gelöscht hat oder die letzten Änderungen in eine Sackgasse geführt haben und rückgängig gemacht werden sollen. Der Button ist nur aktiviert, wenn ein Eintrag der Dashboard-Liste ausgewählt ist.

Dashboard-Editor

Ein Dashboard-Editor ist ein Portale, welcher um die lizenzierten Dashboardkomponenten erweitert wurde. Über die Ribbonleiste werden die Funktionen gesteuert, welche in vier Kategorien aufgeteilt sind:

images/download/attachments/58599741/image2018-6-11_11_26_47-version-1-modificationdate-1603101329120-api-v2.png

Details

  • Neu - Die Dashboard-Erfassungsmaske wird für das Anlegen eines neuen Dashboards vollständig geleert. Sofern im Moment des Klicks noch Änderungen an einem bereits geladenen Dashboard nicht gespeichert sind, erfolgt eine Sicherheits-Abfrage.

  • Löschen - Das gerade geöffnete Dashboard wird gelöscht. Es erfolgt eine Sicherheits-Abfrage. Der Button ist nur aktiviert, wenn das gerade in Bearbeitung befindliche Dashboard bereits gespeichert wurde.

  • Abbrechen - Die Bearbeitung des gerade geöffneten Dashboards wird abgebrochen und die Dashboard-Erfassungsmaske wird geleert. Sofern im Moment des Klicks noch Änderungen an einem bereits geladenen Dashboard nicht gespeichert sind, erfolgt eine Sicherheits-Abfrage.

  • Kopieren - Das gerade geöffnete Dashboard wird geschlossen. Es wird eine Kopie angelegt, die nicht automatisch gespeichert wird. Die Kopie wird also durch das erste manuelle Speichern des Benutzers wirklich angelegt.

  • Speichern - Das gerade geöffnete Dashboard wird gespeichert. Das Dashboard bleibt geöffnet und die Bearbeitung kann fortgesetzt werden.

Zuordnung

  • Zuweisen - Über die Anwendung bestehender Zuordnungskriterien kann das Dashboard für bestimmte Benutzergruppen freigeschaltet werden.

Editor

  • Sprache - Hier kann die Sprache der lokalisierbaren Beschriftungen und Texte umgeschaltet werden. Steht die Sprache beispielsweise auf Englisch und es wird ein solcher Text im Editor bearbeitet, dann passiert dies auch nur im Kontext dieser Sprache. Dies hat jedoch keinerlei Auswirkungen auf die Eintrage in der Sprachverwaltung des Systems. Die Änderungen gelten daher ausschließlich für diese Form.

  • Testmodus - Durch Klicken dieses Buttons schaltet die Maske in den Testmodus um. Der aktivierte Testmodus ist daran erkennbar, dass das Buttonsymbol von "Play" (ausgefüllter Pfeilkopf nach rechts) auf "Stop" wechselt (ausgefülltes Quadrat). Im Testmodus kann das Dashboard mit den aktuellen Änderungen ausprobiert werden, ohne es zuvor gespeichert zu haben.

     ACHTUNG  Es werden sämtliche konfigurierte Verhalten und Aktionen bedingungslos ausgeführt! Dies entspricht also keineswegs einem "geschützten" Testmodus.

  • Veröffentlichen - Um gespeicherte Änderungen für die Benutzer des Dashboards wirksam werden zu lassen, muss das Dashboard über diesen Button veröffentlicht werden. Eine grüne Erfolgsmeldung zeigt die erfolgte Veröffentlichung an. Sollte das Dashboard nach den letzten Änderungen zuvor nicht gespeichert worden sein, wird es automatisch vor der Veröffentlichung gespeichert. Dies ist an einer doppelten grünen Erfolgsmeldung zu erkennen.

Änderungsverlauf

  • Liste - Es kann eine Liste aller jemals von dem geöffneten Dashboard gespeicherten Versionen angezeigt werden. Eine beliebige Version kann reaktiviert werden. Das ist nützlich, falls man versehentlich etwas aus dem Dashboard gelöscht hat oder die letzten Änderungen in eine Sackgasse geführt haben und rückgängig gemacht werden sollen.

Hauptmenü

  • Neu laden - Soll ein Dashboard im Hauptmenü angezeigt oder über eine anderweitig konfigurierbare Aktion geöffnet werden, muss das Hauptmenü über diesen Button neu geladen werden, um in der aktuellen Session des Benutzers sichtbar zu werden. Bitte beachten: Damit das Neuladen wirkt, muss das Dashboard zuvor veröffentlicht worden sein und es muss ein Zuordnungskriterium vorhanden sein, das den aktuell angemeldeten Benutzer berechtigt, das erstellte Dashboard zu sehen.

Tab "Dashboard"

Auf dem Tab "Dashboard" werden folgende Parameter des Dashboards festgelegt:

images/download/attachments/58599741/image2018-6-11_11_32_58-version-1-modificationdate-1603101329124-api-v2.png

  • Name: Der Name des Dashboards kann frei gewählt werden. Er muss allerdings innerhalb des Systems eindeutig sein.

    Der Name kann später über die Sprachverwaltung lokalisiert werden. In der Sprachverwaltung muss dazu der Eintrag zum Resource Name "Dashboard$<NAME>" im Resource Bundle "scm.dashboard" bearbeitet werden.

  • Im Menü anzeigen: Das Häkchen muss aktiviert werden, sofern das Dashboard über das Hauptmenü aufgerufen werden soll.

  • Menüeintrag: Sofern das Menü-Häkchen gesetzt ist, kann hier der Ordner ausgewählt werden, in dem der Menüeintrag für das Dashboard erscheinen soll.

    • Über das Burger-Menü kann eine Auswahlliste vorhandener Menüeinträge geöffnet werden

    • Es kann ein neuer Menü-Ordner angelegt werden, indem eine ganz neue Bezeichnung in das Textfeld eingetragen wird, oder indem der durch Auswahl eines Menü-Ordners erzeugte Eintrag in dem Textfeld verändert wird. Dabei können Unterverzeichnisse durch einen Schrägstrich benannt werden (analog zu einem Datei-Pfad in den meisten Betriebssystemen).

Tab "Designer"

Dieses Tab zeigt einen Formulardesigner. Die Bedienung sowie die Schaltflächen und Komponenten des Editors werden auf der verlinkten Seite beschrieben.

Tab "Form XML"

Die hier ausgegebene XML-Struktur dient in erster Linie zur Analyse des erzeugten Form-XML Formates und kann ferner auch zum Kopieren des gesamten Dashboards in ein anderes Lobster Data Platform / Orchestration-System verwendet werden. Details dazu werden auf der Seite Formulardesigner beschrieben.

Tab "Renderer XML"

Die hier ausgegebene XML-Struktur entspricht der Struktur, welche veröffentlicht wurde und die ein Benutzer beim Verwenden der Maske lädt. Details dazu werden auf der Seite Formulardesigner beschrieben.

Siehe Unterkapitel für weitere Details

Anwendungsbeispiele für Dashboards

2 dimensionaler OLAP-Würfel mit Tuple Suche

Für dieses Beispiel wird davon ausgegangen, dass mehrere Sendungen mit unterschiedlichen Servicetypen vorhanden sind.

Ziel ist es, die Anzahl der Sendungen für jeden Servicetyp in einem Bar-Chart anzuzeigen.

Gewünschtes Ergebnis:

images/download/attachments/58599741/image2018-6-26_10_23_37-version-1-modificationdate-1603101329193-api-v2.png

1. Schritt: Datenquelle Tuple Suche einfügen und konfigurieren

images/download/attachments/58599741/image2018-6-26_8_41_16-version-1-modificationdate-1603101329241-api-v2.png

Die Datenquelle Tuple Suche wird per Drag & Drop in das Formular eingefügt.

images/download/attachments/58599741/image2018-6-26_8_46_28-version-1-modificationdate-1603101329251-api-v2.png

Zur Konfiguration das Element auswählen, in den Tab-Reiter Verhalten (1) wechseln und auf (2) klicken.

images/download/attachments/58599741/image2018-6-26_8_48_54-version-1-modificationdate-1603101329257-api-v2.png

Es öffnet sich der Dialog zur Konfiguration der Tuple-Suche (siehe auch Tupel Suche (Formulardesigner)). Als Suchtyp muss Tuple Suche (1) eingestellt werden. Die gesuchte Entität ist in diesem Fall eine Sendung (2). Für die ID der Sendung (3) und für den Servicetyp (4) werden jeweils eine Feld Projektion definiert. Da wir in dem einfachen Beispiel nach allen vorhandenen Sendungen suchen, müssen wir keine Bedingung (5) angeben.

images/download/attachments/58599741/image2018-6-26_8_57_16-version-1-modificationdate-1603101329263-api-v2.png

Anschließend muss der geteilte Dataprovider gesetzt werden, über den das Element "Dashboardkonfiguration" auf die Daten der Suche zugreifen kann.

 HINWEIS  Wird bei (1) nichts angegeben, dann wird automatisch die ID des Elements (die Tuple Suche) als Datenprovider ID verwendet. In unserem Beispiel geben wir hier SHIPMENTS ein.

2. Schritt: Leeres Dashboard einfügen und konfigurieren

images/download/attachments/58599741/image2018-6-26_9_24_56-version-1-modificationdate-1603101329273-api-v2.png

Das Element "Dashboardkonfiguration" wird per Drag & Drop in das Formular eingefügt.

images/download/attachments/58599741/image2018-6-26_9_26_14-version-1-modificationdate-1603101329282-api-v2.png

Im Tabreiter Eigenschaften (1) muss als Funktionsname (2) die Datenprovider ID der Datenquelle eingetragen werden. Hier SHIPMENTS.images/download/attachments/58599741/image2018-6-26_9_28_9-version-1-modificationdate-1603101329288-api-v2.png Im Tabreiter Verhalten (1) wird als Datenprovider ID ein beliebiger Name, hier "DASHBOARD_DATA" (2) eingetragen. Über diesen geteilten Datenprovider kann anschließend das Bar-Chart-Element auf die Daten des Dashboard-Elements zugreifen.

images/download/attachments/58599741/image2018-6-26_9_35_1-version-1-modificationdate-1603101329293-api-v2.png

Zur Konfiguration der Dashboard Werte kann man in den Testmodus (1) wechseln, dann die Tuple Suche (2) ausführen, den Testmodus wieder beenden und anschließend auf (3) klicken. Nun werden die verfügbaren Werte aus der Tuple Suche automatisch aufgelistet.

images/download/attachments/58599741/image2018-6-26_9_40_18-version-1-modificationdate-1603101329302-api-v2.png

Mit einem Klick auf (1) öffnet sich der Dialog zur Konfiguration des OLAP-Würfels, der erzeugt werden soll. Hier werden nun die verfügbaren Felder (2) angezeigt.

images/download/attachments/58599741/image2018-6-26_9_42_56-version-1-modificationdate-1603101329307-api-v2.png

Per Drag & Drop können die verfügbaren Felder als Messwerte (1) (Hier mit der Anzahlaggration der Id für die Anzahl der Sendungen) und als Kategorie Attribut (2) (serviceType) gesetzt werden.

3. Schritt: Bar chart einfügen und konfigurieren

images/download/attachments/58599741/image2018-6-26_9_54_17-version-1-modificationdate-1603101329311-api-v2.png

Das Element Bar chart wird per Drag & Drop in das Formular eingefügt.

images/download/attachments/58599741/image2018-6-26_9_56_0-version-1-modificationdate-1603101329316-api-v2.png

Im Tabreiter Eigenschaften (1) muss als Funktionsname (2) die Datenprovider Id des leeren Dashboards eingetragen werden. Hier DASHBOARD_DATA.

images/download/attachments/58599741/image2018-6-26_9_57_45-version-1-modificationdate-1603101329320-api-v2.png

Wechselt man nun in den Testmodus (1) wird das Ergebnis der Suche bereits im Bar chart Element angezeigt.

4. Schritt: Label Standard anpassen

images/download/attachments/58599741/image2018-6-26_10_1_47-version-1-modificationdate-1603101329185-api-v2.png

Da im OLAP Würfel des leeren Dashboards kein Cluster-Attribut definiert ist, wird bei (1) ein Standardwert angezeigt.

images/download/attachments/58599741/image2018-6-26_10_4_19-version-1-modificationdate-1603101329221-api-v2.png

Um diesen Label zu ändern, kann man das "Dashboardkonfiguration" Element im Formular auswählen und im Tabreiter Eigenschaften auf (1) klicken. Nun wird automatisch ein neuer Dashboard Wert hinzugefügt. Mit Doppelklick auf (2) werden anschließend die Eigenschaften des Dashboard Wertes angezeigt.

images/download/attachments/58599741/image2018-6-26_10_7_43-version-1-modificationdate-1603101329231-api-v2.png

Das Datenfeld (1) muss eingegeben werden. Da es hierfür in der Datenquelle keine entsprechende Spalte gibt, spielt der Wert keine Rolle, daher kann man auch Dummy eingeben.

Die Beschriftung (2) wird nur zur Anzeige in den Konfigurationen des leeren Dashboards verwendet.

images/download/attachments/58599741/image2018-6-26_10_12_24-version-1-modificationdate-1603101329172-api-v2.png

In unserem Beispiel soll ein Eintrag aus der Sprachverwaltung zur Anzeige verwendet werden. Dazu wird der Dashboardwert (Standard Label) als Berechnungsfeld (1) markiert. Klickt man auf (2) kann man die Funktion RB (Resource-Bundle) einfügen.

Hier wird das Resource bundle de.lobster.scm.shipment.bto.Shipment und der Resource name $menu (3) verwendet um auf den bereits vorhandenen Eintrag in der Sprachverwaltung zu verweisen.

images/download/attachments/58599741/image2018-6-26_10_18_34-version-1-modificationdate-1603101329175-api-v2.png

Öffnet man nun die Konfiguration des leeren Dashboard Elements (1) kann per Drag & Drop der neue Dashboardwert als Cluster-Attribut gesetzt werden.

images/download/attachments/58599741/image2018-6-26_10_20_31-version-1-modificationdate-1603101329189-api-v2.png

Im Testmodus wird nun anstatt des Standard Labels der lokalisierte Wert angezeigt.

3 dimensionaler OLAP Würfel mit Tuple Suche

Für dieses Beispiel wird davon ausgegangen, dass mehrere Sendungen mit unterschiedlichen Servicetypen und Arbeitsstatus vorhanden sind.

Ziel ist es, die Anzahl der Sendungen für jeden Servicetyp pro Arbeitsstatus in einem Bar-Chart anzuzeigen.

Gewünschtes Ergebnis:

images/download/attachments/58599741/image2018-6-26_10_50_3-version-1-modificationdate-1603101329226-api-v2.png

Einfachheitshalber kann das vorherige Beispiel: 2 Dimensionaler OLAP Würfel mit Tuple Suche erweitert werden.

1. Schritt: Tuple Suche erweitern

images/download/attachments/58599741/image2018-6-26_10_36_2-version-1-modificationdate-1603101329196-api-v2.png

Um den Arbeitsstatus der Sendungen auszulösen, wird eine neue Feldprojektion (1) mit dem Namen workingState hinzugefügt.

2. Schritt: Dashboard Konfiguration erweitern

images/download/attachments/58599741/image2018-6-26_10_42_45-version-1-modificationdate-1603101329208-api-v2.png

Wechselt man in den Testmodus (1) und führt die Suche aus, dann wird die Liste der verfügbaren Dashboard Werte mit einem Klick auf (2) automatisch aktualisiert. Eventuell bereits aus dem obigen Beispiel vorhandene selbstdefinierte Werte können mit Klick auf (3) entfernt werden.

images/download/attachments/58599741/image2018-6-26_10_46_15-version-1-modificationdate-1603101329216-api-v2.png

Mit einem Klick auf (1) kann die Konfiguration des OLAP-Würfels im Element "Dashboardkonfiguration" angepasst werden. Hier soll nun als Cluster-Attribut der Wert workingState (2) verwendet werden.

Wechselt man anschließend in den Testmodus wird das gewünschte Ergebnis angezeigt.

Das Bar chart Element muss nicht angepasst werden, da es automatisch über das Cluster-Attribut mehrere Charts (pro Arbeitsstatus) anzeigt.