APEX 19.1 - Status Meter Gauge

-
Mit der Version 19.1 bietet APEX nun Zeiger-Elemente out-of-the-box. Ein zusätzliches Plug-In wird nicht mehr benötigt.
Alle Neuerungen siehe https://blogs.oracle.com/apex/announcing-oracle-apex-191
 bzw.
hier https://apex.oracle.com/en/platform/features/whats-new

Wie baut man sowas nun ein?

Es braucht eine eigene (Sub-)Region vom Type "Chart".
Diese bekommt unter Attribute den Type "Status Meter Gauge".
Dadurch werden diverse Deklarationselemente sichtbar, über die das Aussehen sehr weitreichend angepasst werden kann.
Für meinen Fall habe ich mich für folgende Einstellungen entschieden:

Zu jedem Zeiger/Diagramm gehört eine entsprechende Datenreihe (in APEX "Series" genannt). Für Zeiger hat diese Datenreihe nur eine Zeile, aber mehrere Spalten, mit denen das Aussehen gesteuert werden kann.
Das entsprechende Select-Fragment schaut z.B. so aus:

select LABEL
     , 0 VAL_MIN
     , VAL_SET
     , VAL_ACT
     , VAL_SET*2 VAL_MAX
     , case
         when VAL_ACT = VAL_SET
         then '#4CD964' -- gruen
         else '#FF3B30' -- rot
       end val_col    
     , LABEL||': '||VAL_ACT||' von '||VAL_SET TOOLTIP
  from (

Der Sinn der einzelnen Spalten erschießt sich aus der nachfolgenden Zuordnung (Column Mapping):

Im Beispiel soll dargestellt werden, ob eine vorgegebene (val_set) Anzahl Dateien bereits zugeordnet wurde (val_act).
Für den Fall, dass keine, zu wenig oder zu viel zugeordnet wurde, wird der Balken rot, wenns passt grün dargestellt (val_col per CASE-Statement).
Die dynamische Zuordnung (hier des Vorgabewertes und der Balkenfarbe) erfolgt deklarativ per &Val.-Notation:

Im Beispiel schaut das Ergebnis dann so aus:

Es gibt aber auch horizontale Balken, Teil- und Vollkreis-Varianten, verschiedene Grenzwertbereiche und viele, viele weiter Möglichkeiten. Beispiele dafür finden sich z.B. hier: https://apex.oracle.com/pls/apex/f?p=10800:5:0::NO:::


Fazit: Eine schöne Neuerung in Version 19.1, die die Arbeit nochmal deutlich erleichtert (und kein eigenes Plug-In (mehr) erfordert.

Kommentare

Kommentar veröffentlichen

Beliebte Posts aus diesem Blog

trunc(sysdate) - nette Spiele mit dem Datum

-
Über die trunc-date Funktion läßt sich ausgehend von einem Datumswert sehr einfach ein abgeleiteter Datumswert ermittelt: bspw. der Jahres-, Quartals-, Monats- oder Wochenanfang. Die 11g Doku erläutert dies an zwei Stellen: http://download.oracle.com/docs/cd/B28359_01/server.111/b28286/functions209.htm#SQLRF06151 bzw. http://download.oracle.com/docs/cd/B28359_01/server.111/b28286/functions242.htm#sthref2718 So liefert select trunc(to_date('06.02.2011'),'q') from dual; das DATUM des Quartalsersten (im Bsp. den 01.01.2011). Wichtig ist, dass trunc immer ein Datum zurückliefert, keinen String. Einige Beispiele anhand des 20.Feb 2011 (ein Sonntag in der 07 KW in 2011): select trunc(to_date('20.02.2011'),'d') from dual; select trunc(to_date('20.02.2011'),'dd') from dual; select trunc(to_date('20.02.2011'),'ddd') from dual; select trunc(to_date('20.02.2011'),'mm') from dual; select trunc(to_date('20.02.2011...
Mehr anzeigen

Zufallszahlen und -text generieren - DBMS_RANDOM

-
Um für Testzwecke etc. "zufällige" Zahlen / Strings zu erzeugen, gibt es in Oracle die Funktion dbms_random . In Verbindung mit connect by kann so sehr einfach eine beliebige Menge an Zeilen mit Zufallswerten erzeugt werden: SELECT dbms_random.value(1,1000) Z       , dbms_random.string('a',20) Txt   FROM DUAL CONNECT BY level < 101; * DBMS_RANDOM.VALUE(low, high)   + low -> untere Grenze   + high -> obere Grenze * DBMS_RANDOM.STRING(opt, len)   + opt -> Definiert, was für ein String erzeugt wird   + len -> Länge des String   + Details zu opt: 'u', 'U' - returning string in uppercase alpha characters 'l', 'L' - returning string in lowercase alpha characters 'a', 'A...
Mehr anzeigen

Laufzeiten umrechnen, Sekundenangaben lesbar darstellen

-
Hintergrund: Laufzeiten von diversen Prozessen werden (Tool-)intern in Sekunden gemessen und meist auch so dargestellt. Für Weiterberechnungen und Auswertungen ist das Ideal. Der Lesbarkeit für den geneigten Nutzer nur bedingt dienlich. Wer erkennt schon auf den ersten Blick, wie lange 14.738sec sind? Lang halt. Lösungsansätze: Für die Lesbarkeit, kann man diese Werte natürlich entsprechend umrechnen. Aber wie? 14.738sec vermutlich am Besten in Stunden: 14.738/60/60 = 4,0939 Stunden -> Aha. Aber was ist mit 249sec? 249/60/60 = 0,069 Stunden - Wie lang bitte sind 0,069Std? 249sec also besser in Minuten umrechnen: 249/60 = 4,15 Min -> schon besser Also per CASE-Statement die unterschiedliche großen Sekundenangaben passend umrechnen? Nicht schön und umständlich. Netterweise bietet Oracle mit der to_date()-Funktion auch den Formatstring 'sssss' (5x kleines 's'). Per to_char( to_date(14768,'sssss') ,'HH24:MI:SS') werden aus den Sekunden ...
Mehr anzeigen