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:
- color
String. Hintergrundfarbe für die rechteckige Widget-Fläche, zum Beispiel #A0B0C0. - footer
String. Text, der im unteren Bereich des Widgets angezeigt wird, kann lokalisiert werden, siehe Lokalisieren von Widget-Text. - height
String. Höhe des Widgets-Rechtecks in Pixeln (Integer-Wert). - localization
String. Lokalisierte Werte für die Textattribute, siehe Lokalisieren von Widget-Text. - maxValueForSize
String. Numerischer Widget-Wert ab dem die Schriftgröße verkleinert wird, damit der Wert in die Zeile des Rechtecks passt, Standardwert: 100000. - symbol
String. Buchstabe, Symbol oder String als Präfix für den numerischen Wert. - title
String. Text, der als oberste Zeile im Widget angezeigt wird, kann lokalisiert werden, siehe Lokalisieren von Widget-Text. - trend
String. Bezeichnung für das Trend-Symbol, das nach dem numerischen Wert angezeigt wird, gültige Bezeichnungen sind up, down und flat. - value
String. Anzuzeigender numerischer Wert. Dieses Attribut sollte normalerweise vom Widget-Skript bestimmt werden. Ansonsten wird eine feste Zahl angezeigt. - visible
Boolean. Definiert, ob das Widget angezeigt wird (true) oder nicht (false).
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:
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']
Code-Beispiel 44: Skript für ein KPI-Widget, mit dem die Anzahl der in der letzten Woche geöffneten Vorgänge berechnet wird