Quelltext der Seite Roadmap:Handbuch:Erweiterung/KPIVisuals

{{DISPLAYTITLE:KPI Visualisierungen}}
{{BSVersion|bsvFrom=6|bsvFeature=KPIVisuals|info=(BlueSpice farm)  - Release ausstehend}}
'''KPIVisuals''' ermöglicht es Ihnen, aussagekräftige Dashboards zu erstellen, die bei der Bewertung des aktuellen Stands quantitativer Informationen helfen. Mit KPI-Visualisierungen können Sie zum Beispiel einen Maximalwert mit einem aktuellen Wert vergleichen und die Differenz visuell darstellen.

== Hinzufügen von KPI-Visualisierungen ==
Folgende KPI-Visualisierungen stehen zur Verfügung:

* KPI-Tachometer
* KPI-Fortschrittsbalken
* KPI-Kachel
* KPI-Trendindikator


'''So fügen Sie einer Seite eine KPI-Visualisierung hinzu:'''
{{ContentDropletSelect|KPI}}

Informationen zu den einzelnen KPI-Visualisierungstypen finden Sie in den Beispielen auf dieser Seite.
== Erstellen einer KPI-Tachometeranzeige ==
Verwenden Sie eine KPI-Tachometeranzeige (Gauge), wenn die Kennzahl einen aussagekräftigen Wertebereich mit drei Zonen aufweist. Benutzen Sie diese Darstellung, wenn Sie  sofort erkennen möchten, wo sich der aktuelle Wert innerhalb dieses Bereichs befindet („Liegt er in einem guten oder schlechten Bereich?“).[[File:Extension KPI Visuals - gauge.png|alt=KPI-Tachometeranzeige für „Sales Target Midmarket“ mit Anzeige von 32,7 % und rotem Zeiger|center|thumb|200x200px|KPI-Tachometeranzeige]]


{| class="wikitable"
|+Beispiel: Status der Vertriebsziele anzeigen
!Tab
!Parameter
!Beschreibung
|-
|Allgemein
|Wert
|Geben Sie einen festen Wert ein (muss manuell geändert werden)
Oder beziehen Sie den Wert aus einer Tabelle oder einer SMW-Abfrage
(siehe [[#Verfügbare Parameter]])

Hinweis: Der Wert muss eine '''Ganzzahl''' (Integer) sein.
|-
|Allgemein
|Beschriftung
|zum Beispiel: <code>Vertriebsziel Mittelstand</code>
|-
|Erweitert
|Maximalwert
|Ihr Vertriebsziel, z. B. <code>100000</code>
Hinweis: Der Wert muss eine '''Ganzzahl''' (Integer) sein.
|-
|Erweitert
|Als Prozentsatz anzeigen
|''Aktivieren Sie das Kontrollkästchen''
|-
|Erweitert
|Schwellenwerte
|<code><nowiki>0.3:red|0.5:yellow|0.85:green</nowiki></code>
|-
|Erweitert
|Link
|(optional), z. B. <code>Vertriebsziele</code>  ''(Hinweis: Dieses Feld verfügt über keine Autovervollständigungsfunktion; Sie müssen daher den genauen, vollständigen Namen der Seite kennen (ggf. einschließlich Namensraum-Präfix).''
|}

== Erstellen eines KPI-Fortschrittsbalkens ==
Verwenden Sie dieses Element, wenn die Kennzahl den Fortschritt hin zu einem festen Ziel darstellt. Es gibt einen klaren Startpunkt (0) und einen klaren Endpunkt („Wie weit sind wir dem Ziel nähergekommen?“).

Der Zielwert kann in beide Richtungen verlaufen; je nach Betrachtungsweise streben Sie beispielsweise 100 % (geschlossene Tickets) oder 0 (offene Tickets) an.[[File:Extension KPIVisuals - Fortschrittsbalken.png|alt=Fortschrittsbalken, der 3 offene Tickets mit grüner Anzeige darstellt|center|thumb|300x300px|KPI-Fortschrittsbalken]]


{| class="wikitable"
|+Beispiel: Anzeige offener Tickets (= Seiten mit einer „Status“-Eigenschaft)
!Reiter
!Parameter
!Beschreibung
|-
|Allgemein
|Wert
|Beispiel: Wenn Ihr Wiki eine Eigenschaft „Status“ besitzt, zählen Sie die Seiten mit dem Wert „in progress“ (in Bearbeitung):<syntaxhighlight lang="text">
{{#ask:[[Status::in progress]] |format=count }}
</syntaxhighlight>
|-
|Allgemein
|Beschriftung
|<code>Open tickets</code>
|-
|Erweitert
|Maximalwert
|Anzeige aller Seiten, die einen Wert für die Eigenschaft „Status“ aufweisen:<syntaxhighlight lang="text">
{{#ask:[[Status::+]] |format=count }}
</syntaxhighlight>
|-
|Erweitert
|Schwellenwerte
|<code><nowiki>0.3:green|0.5:yellow|0.8:red</nowiki></code>
|}

== Erstellen einer KPI-Kachel ==
Bei der Verwendung von Kacheln liegt der Schwerpunkt direkt auf dem aktuellen Momentaufnahmewert, ohne den Vergleichswert visuell darzustellen („Wo stehen wir gerade?“).

Um mehrere Kacheln nebeneinander zu erstellen, fügen Sie die KPI-Kacheln einfach mehrfach auf einer Seite ein. Sie können die erste Kachel kopieren und einfügen und anschließend einfach die erforderlichen Parameter für die weiteren Kacheln anpassen.
[[File:Extension KPIVisuals - Kachel.png|alt=3 rote, grüne und gelbe Kacheln für insgesamt 6 offene Tickets|center|thumb|650x650px|KPI-Kacheln]]

{| class="wikitable"
|+Beispiel: Anzeige einer Kachel für Seiten, die die SMW-Eigenschaft „Status“ besitzen
!Tab
!Parameter
!Beschreibung
|-
|Allgemein
|Wert
|Beispiel: Wenn Sie in Ihrem Wiki eine Eigenschaft „Status“ haben, zählen Sie die Seiten mit dem Wert „in Bearbeitung“ (in progress):<syntaxhighlight lang="text">
{{#ask:[[Status::new]] |format=count }}
</syntaxhighlight>
|-
|Allgemein
|Beschriftung
|<code>Neue Tickets</code>
|-
|Erweitert
|Maximalwert
|Anzeige aller Seiten, die einen Wert für die Eigenschaft „Status“ haben:<syntaxhighlight lang="text">
{{#ask:[[Status::+]] |format=count }}
</syntaxhighlight>
|-
|Erweitert
|Schwellenwerte
|<code><nowiki>0.3:green|0.5:yellow|0.8:red</nowiki></code>
|}

== Erstellen eines KPI-Trendindikators ==
Mit einem Trendindikator lässt sich hervorheben, ob sich ein Wert verbessert oder verschlechtert.


[[File:Extension KPIVisuals - Trendindikator.png|center|thumb|111x111px|KPI-Trendindikator|alternativtext=Grüner Aufwärtspfeil mit Bezeichnung "Verkaufsrend" und Wert 50%]]


{| class="wikitable"
|+Beispiel: Anzeige des Trends für den B2B-Umsatz
!Registerkarte
!Parameter
!Beschreibung
|-
|Allgemein
|Wert
|Aktueller Wert, z. B. 50.000
|-
|Allgemein
|Ausgangswert
|Referenzwert, z. B. 85.000
|-
|Allgemein
|Bezeichnung
|<code>Verkaufstrend</code>
|-
|Erweitert
|Differenz anzeigen
|''Kontrollkästchen aktivieren''
|-
|Erweitert
|Als Prozentsatz anzeigen
|''Kontrollkästchen aktivieren''
|}

== Verfügbare Parameter ==
Jede KPI-Visualisierung benötigt mindestens einen Wert, einen Maximalwert, Schwellenwerte für den Farbwechsel der Anzeige sowie eine Bezeichnung zur Identifizierung der Anzeige.
{| class="wikitable"
|+
!
!Parameter
!Visualisierung
!Beispiel
!Beschreibung
|-
|Allgemein
|Wert
|Tachometer, Fortschrittsbalken, Kachel, Trend
|Kann aus einer SMW-Eigenschaft berechnet werden:<syntaxhighlight lang="text">
{{#ask:[[Status::open]]|format=count}}
</syntaxhighlight>Oder aus einer [[Seitenentwurf:Handbuch:Erweiterung/Spreadsheets|Tabellenzelle]]:<syntaxhighlight lang="text">
{{#sheetCell:Sales_data|E3}}
</syntaxhighlight>{{Textbox|boxtype=note|header=Hinweis:|text=Der Wert muss eine Ganzzahl sein.|icon=no}}
Auch [[mediawikiwiki:Help:Extension:ParserFunctions|Parser-Funktionen]], die eine Ganzzahl ergeben (z. B. <code><nowiki>{{#expr:4+5}}</nowiki></code>), werden unterstützt.
|aktueller numerischer Anzeigewert (erforderlich)
|-
|Allgemein
|Bezeichnung
|Tachometer, Fortschrittsbalken, Kachel, Trend
|Eine beliebige kurze Bezeichnung, die die KPI-Visualisierung beschreibt.
|Textbezeichnung, die unterhalb der Anzeige erscheint (optional)
|-
|Allgemein
|Beschreibung
|Kachel, Trend
|Ein beliebiger Text, der die KPI-Visualisierung beschreibt. |Textbeschreibung, die unter dem Wert angezeigt wird
|-
|Erweitert
|Maximalwert
|Tachometer, Fortschrittsbalken, Kachel
|Kann aus einer SMW-Eigenschaft berechnet werden:<syntaxhighlight lang="text">{{#ask:[[Status::+]]|format=count}}</syntaxhighlight>{{Textbox|boxtype=note|header=Hinweis:|text=Der Wert muss eine Ganzzahl sein.|icon=no}}
|Wert, der 100 % Fertigstellung entspricht (Standard: 100)
|-
|Erweitert
|Einheit
|Tachometer, Fortschrittsbalken, Kachel
|<code>%</code>, <code>pages</code>, <code>users</code> oder ein beliebiger anderer Text
|textbasierte Maßeinheit, die an den angezeigten Wert angehängt wird (optional)
|-
|Erweitert
|Als Prozentzahl anzeigen
|Tachometer, Fortschrittsbalken, Kachel, Trend
|true, false
|gibt einen berechneten Prozentsatz von <code>Wert/Max %</code> anstelle von <code>Wert Einheit</code> aus; überschreibt jeglichen Text im Parameter „Einheit“
|-
|Erweitert
|Skala anzeigen
|Tachometer, Fortschrittsbalken, Kachel
|true, false
|zeigt den Bereich vom Minimum (0) bis zum Maximalwert als Referenzpunkt unter dem Wert an
|-
|Erweitert
|Symbol-CSS-Klasse
|Kachel
|<code>bi bi-house</code>, <code>bi bi-arrow-right-circle</code>
|zeigt ein [https://icons.getbootstrap.com/#icons Bootstrap-Symbol] vor der Beschriftung an
|-
|Erweitert
|Schwellenwerte
|Tachometer, Fortschrittsbalken, Kachel
|Standarddefinition:
<code>0:red | 0.3:yellow | 0.8:green</code><br />Beachten Sie, dass nur drei Zonen möglich sind (rot, gelb, grün).
|<nowiki>definiert Farbzonen als Paare aus Verhältnis und Farbe, getrennt durch „|“ . Die Werte liegen im Bereich von 0 bis 1.</nowiki>
|-
|Erweitert
|Link
|Tachometer, Fortschrittsbalken, Kachel, Trend
|Wiki-Link: <code>Sales Targets</code><br /><br />Interwiki-Link: <code>sales:Sales Targets</code><br /><br />Externer Link: <code><nowiki>https://bluespice.com</nowiki></code>
|verknüpft die KPI-Visualisierung mit einer Wiki-Seite oder einer externen Seite
|-
|Erweitert
|Toleranz
|Trend
|
|definiert den neutralen Bereich
Beispiel: 0,05 bedeutet, dass eine Abweichung von ±5 % gegenüber dem Referenzwert keinen Trend anzeigt.
|-
|Erweitert
|Größe
|Trend
|<code>Medium</code>, <code>Small</code>
|Größe der visuellen Anzeige
|-
|Erweitert
|Differenz anzeigen
|Trend
|fügt eine Beschriftung unter dem Grafikpfeil hinzu (empfohlen aus Gründen der Barrierefreiheit)
|zeigt die Differenz zwischen dem aktuellen Wert und dem Referenzwert an
|}

== Quellen für Werte ==
Obwohl Werte und Maximalwerte manuell gepflegt werden können, ist es sinnvoll, die Daten automatisch zu aktualisieren. Hier ist eine Liste möglicher Quellen für Werte des Typs <code>integer</code> (Ganzzahl).
{| class="wikitable"
|+Quellen für KPI-Werte
!Quelle
!Beispiel
|-
|Manuelle Eingabe
|<code>100</code>, <code>1000</code>, <code>234567</code>
|-
|[[SMW-Abfragen|Semantic-MediaWiki-Abfrage]]
|<code><nowiki>{{#ask:[[Status::+]]|format=count}}</nowiki></code><br /><code><nowiki>{{#show:[[Statistics]]|?Population}}</nowiki></code>
|-
|[[Seitenentwurf:Handbuch/Erweiterung/SpreadsheetFileReader|Spreadsheet-Seite]]
|<code><nowiki>{{#sheetCell:Sales_data|E3}}</nowiki></code>
|-
|[[Seitenentwurf:Handbuch:Erweiterung/SpreadsheetFileReader|Hochgeladene Tabellenkalkulationsdatei]]
|<code><nowiki>{{#spreadsheetfilecell:MyFile.xlsx|A7}}</nowiki></code>, <code><nowiki>{{#spreadsheetfilecell:MyFile.ods|A7}}</nowiki></code>
|-
|[[Handbuch:Erweiterung/External Data|Abfrage externer Daten]]<!-- nicht verfügbar in Galaxy -->
|<code><nowiki>{{#external_value:Population|source=https://discoursedb.org/GermanyCSV.txt}}</nowiki></code>
(Hinweis: Kann für Cloud-Wikis nicht konfiguriert werden, wenn die Quelle nicht öffentlich zugänglich ist)
|-
|Transkludierte CSV-Datei
|<code><nowiki>{{:Meine CSV Seite}}</nowiki></code>
|-
|[[mediawikiwiki:Help:Magic_words#Statistics|Magische Wörter]]
|<code><nowiki>{{NUMBEROFPAGES}}</nowiki></code>, <code><nowiki>{{NUMBEROFACTIVEUSERS}}</nowiki></code>,  <code><nowiki>{{PAGESINCATEGORY:categoryname}}</nowiki></code>
|-
|[[mediawikiwiki:Help:Extension:ParserFunctions##expr|Parser-Funktion #expr]]
|<code><nowiki>{{#expr:20+50}}</nowiki></code>
|}

== Barrierefreiheit ==

* '''Verwendung von Farben:''' Achten Sie darauf, Beschriftungstexte zu verwenden, die die Zahl eindeutig erklären. Verlassen Sie sich nicht allein auf die Farbe, um die Bedeutung zu vermitteln. Negative Zahlen sollten beispielsweise mit einem Kennzeichen (<code>-</code>) versehen werden, anstatt sie lediglich mit einem roten Hintergrund zu formatieren. {{WCAGref|use-of-color}}
* '''Screenreader''' lesen das Badge als Kombination aus aktuellem Wert und Maximalwert über ein <code>aria-label</code> vor (zum Beispiel: „Eine Anzeige, die 32.670 von 100.000 anzeigt, mit der Bezeichnung  'Vertriebsziel Mittelstand‘ “). {{WCAGref|text-alternatives}}
{{DEFAULTSORT:KPI Visuals}}