Analytics Builder 10.14.0 | Bedienungsanleitung für Analytics Builder for Cumulocity IoT | Blockreferenz | Werkzeug | Eigen­schaft extrahieren
 
Eigen­schaft extrahieren
apama.analyticskit.blocks.core.ExtractProperty
Extrahiert die angegebene Eigenschaft aus dem Eingabewert und konvertiert sie in den angegebenen Typ.
Der Wert im Wert-Port, der vom Parameter "Eigenschaftspfad" bestimmt wird, sollte eine Zeichenfolge, eine Zahl oder ein boolescher Wert sein.
Sie können einen Punkt (.) als Teil des Parameters "Eigenschaftspfad" angeben, um verschachtelte Werte aus einem Dictionary zu extrahieren.
Beispiel: Wenn die Eingabe { "location" : { "city" : "Cambridge" } } (in JSON-Form) ist, können Sie diesen Wert extrahieren, indem Sie location.city als Parameter "Eigenschaftspfad" angeben.
Der Parameter Eigenschaftspfad kann zudem eckige Klammern enthalten, um ein bestimmtes Element aus einer Sequenz zu extrahieren.
Wenn der Wert ein Objekt ist, werden die Eigenschaften dieses Objekts als Eigenschaften am Ausgabeport Extrahierter Wert ausgegeben.
Beispiel: Wenn die Eingabe{ "users" : [ { "age" : 40.375 } ] } (in JSON-Form) ist, können Sie diesen Wert extrahieren, indem Sie als Parameter "Eigenschaftspfad" users[0].age angeben.
Der Block unterstützt keine Extraktion von Einträgen aus einem Dictionary, dessen Schlüssel Sonderzeichen wie Punkt (.) oder eckige Klammern enthält. Außerdem wird das Extrahieren von Einträgen aus einer Sequenz ohne Verwendung eckiger Klammern nicht unterstützt. Beispielsweise muss users.0.id als users [0] .id geschrieben werden.
Bei der Umwandlung eines Strings in einen Float behandelt dieser Block einen leeren String als einen Wert von 0,0 statt als nicht analysierbar.
Parameter
Name
Beschreibung
Typ
Hinweise
Eigen­schafts­pfad
Der Name oder Pfad der Eigenschaft, die aus dem Eingabewert extrahiert werden soll. Wenn nicht gesetzt, werden alle Eigenschaften ausgegeben.
string
Optional
Eigen­schaftstyp
Der Typ, in den der Eigenschaftswert konvertiert werden soll. Wenn auf "Eigenschaften" gesetzt, wird ein Pulse mit Eigenschaften aus dem extrahierten Wert ausgegeben.
Option - eine von:
*String
*Boolean
*Float
*Eigenschaften
Standard: String
Beim Fehlen löschen
Wenn gewählt, wird der Standardwert des angegebenen Typs ausgegeben, wenn der Parameter "Eigenschaftspfad" nicht angegeben wurde oder wenn der Wert nicht in den angegebenen Typ umgewandelt werden kann.
boolean
Standard: false
Details zum Eingangsport
Name
Beschreibung
Typ
Wert
Der Eingabewert, aus dem die Eigenschaft extrahiert werden soll.
any
Details zum Ausgangsport
Name
Beschreibung
Typ
Extrahierter Wert
Der aus dem Eingabewert extrahierte Wert.
any