Analytics Builder 10.14.0 | Bedienungsanleitung für Analytics Builder for Cumulocity IoT | Blockreferenz | Berechnung | KPI
 
KPI
apama.analyticskit.blocks.cumulocity.KPI
Vergleicht einen Wert entweder mit einem KPI (Key Performance Indicator) oder dem Datenpunkt eines Geräts.
Dieser Block verwendet Daten aus dem Eingangsport "KPI" oder aus dem Gerät, das Datenpunkte enthält. Er extrahiert die Einheiten, die Bezeichnung sowie den roten und gelben Bereich. Die Ausgabe zeigt an, ob der Wert innerhalb des vom KPI oder Datenpunkt angegebenen roten oder gelben Bereichs liegt.
Die KPI-Eingabe kann Eigenschaften bereitstellen, üblicherweise von einem KPI-verwalteten Objekt, zu denen der rote und gelbe Bereich, die Einheit und die Beschriftung gehören. Wenn das Gerät einen Datenpunkt für das angegebene "Fragment und Serien" enthält, dann überschreiben die Werte aus dem Datenpunkt die aus dem KPI.
Parameter
Name
Beschreibung
Typ
Hinweise
Quellgerät oder Gerätegruppe
Das Gerät oder die Gerätegruppe, in denen sich ein Datenpunkt befindet. Wenn angegeben, wird dieses Gerät (üblicherweise das gleiche Gerät wie die Messquelle) daraufhin überprüft, ob es einen Datenpunkt für das angegebene Fragment und Serien enthält. Wenn es einen Datenpunkt enthält, werden die roten und gelben Bereichswerte aus dem Quellobjekt anstelle der KPI-Werte verwendet. Der Modelleditor verwendet den aktuellen Geräte- oder Assetnamen. Dieser ist intern der Inventar-ID zugeordnet.
string
Optional
Datenpunkt Fragment und Serien
Dieser Parameter muss angegeben werden, wenn der Parameter "Quellgerät oder Gerätegruppe" angegeben ist. Er gibt einen Datenpunkt aus dem Quellobjekt an. Dieser ist üblicherweise identisch mit "Fragment und Serien" der Messquelle.
"Datenpunkt Fragment und Serien" muss als fragment.series angegeben werden.
string
Optional
Oberes Ende des gelben Bereichs ausschließlich
Wenn gesetzt, wird das obere Ende des gelben Bereichs als exklusiv behandelt.
boolean
Standard: false
Oberes Ende des roten Bereichs exklusiv
Wenn festgelegt, wird das obere Ende des roten Bereichs als exklusiv behandelt.
boolean
Standard: false
Details zum Eingangsport
Name
Beschreibung
Typ
Wert
Numerischer Wert zum Vergleich mit den definierten Bereichen.
float
KPI
Objekt, das die Eigenschaft c8y_Kpi enthält.
pulse
Details zum Ausgangsport
Name
Beschreibung
Typ
Rot
Wird auf true gesetzt, wenn der Wert im roten Bereich liegt (falls ein roter Bereich definiert ist).
boolean
Gelb
Wird auf true gesetzt, wenn der Wert im gelben Bereich liegt (falls ein gelber Bereich definiert ist).
boolean
Einheit
Der Einheitsname des Datenpunkts.
string
Beschriftung
Der Beschriftungsname des Datenpunkts.
string