Zum Hauptinhalt springen

KPI-Widgets

KPI-Widgets werden im Typ kpiWidget oder einem seiner Unterelemente konfiguriert. Sie verwenden die Bibliothek jquery-kpiwidget.

Die folgende Abbildung zeigt ein KPI-Widget:

KpiWidget_DE.png

Sie können Attribute sowohl im Widget-Skript als auch in der Seitenanpassung setzen. Die im Skript gesetzten Werte überschreiben die Werte, die in der Seitenanpassung eingegeben werden.

Verfügbare Attribute:

  • Sichtbar (visible): Boolean. Definiert, ob das Widget angezeigt wird (True) oder nicht (False).
  • Farbe (color): String. Hintergrundfarbe für die rechteckige Widget-Fläche, zum Beispiel #A0B0C0.
  • Fußzeile (footer): String. Text, der im unteren Bereich des Widgets angezeigt wird, kann lokalisiert werden, siehe Lokalisieren von Widget-Text.
  • Höhe (height): String. Höhe des Widgets-Rechtecks in Pixeln (Integer-Wert).
  • Lokalisierungen (localization): String. Lokalisierte Werte für die Textattribute, siehe Lokalisieren von Widget-Text.
  • Max. Wert für Schriftgröße (maxValueForSize): String. Numerischer Widget-Wert ab dem die Schriftgröße verkleinert wird, damit der Wert in die Zeile des Rechtecks passt, Standardwert: 100000.
  • Präfix (symbol): String. Buchstabe, Symbol oder String als Präfix für den numerischen Wert.
  • Titel (title): String. Text, der als oberste Zeile im Widget angezeigt wird, kann lokalisiert werden, siehe Lokalisieren von Widget-Text.
  • Trend (trend): String. Bezeichnung für das Trend-Symbol, das nach dem numerischen Wert angezeigt wird, gültige Bezeichnungen sind up, down und flat.
  • Wert (value): String. Anzuzeigender numerischer Wert. Dieses Attribut sollte normalerweise vom Widget-Skript bestimmt werden. Ansonsten wird eine feste Zahl angezeigt.

Code-Beispiel

KPI-Widgets basieren auf der Bibliothek jquery-kpiwidget. Das Skript muss eine HashMap mit den Attributen, die die KPI-Darstellung definieren, zurückgeben.

Der folgende Code zeigt ein Beispiel für ein KPI-Widget-Skript, mit dem die Anzahl der in der letzten Woche geöffneten Vorgänge berechnet wird.

import com.consol.cmas.common.model.ticket.*
import java.util.*
import com.consol.cmas.common.model.DateRange

TicketCriteria crt = new TicketCriteria()
def to_date = new Date()
def from_date = to_date - 7
def range = new DateRange(from_date,to_date)
crt.setCreationDateRange(range)
// crt.setStatus(TicketCriteria.Status.OPEN)
ticketcount = ticketService.getByCriteria(crt).size()

switch (ticketcount) {
case 0..25:
trendline = 'down'
break
case 26..50:
trendline = 'flat'
break
default:
trendline = 'up'
}

return[value: ticketcount as String, trend: trendline, visible: 'true']