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:
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']