Zuordnungsausdruckssprache

Ausdruckssprache und Benachrichtigungsregeln

Die Zuordnungsausdruckssprache wurde zur Verwendung mit der Benachrichtigungsregelfunktion des Datenmanagements durch die Einführung von $state -und $instance -Variablen erweitert, die für die Verwendung in Ausdrücken definiert sind.

• Die Variable $state wird verwendet, um auf Eigenschaften im Einheitenstatus in einem Ausdruck zu verweisen, z. B. $state.temperature.
• Die Variable $instance wird verwendet, um Attribute und Metadaten in der Einheiteninstanz in einem Ausdruck zu referenzieren, z. B. $instance.metadata.tempThresholdMax.

Sie können diese Variablen verwenden, damit Sie in Ihren Bedingungsausdrücken von Benachrichtigungsregeln keine fest codierten Werte benötigen und für die einzelnen Geräteinstanzen einen anderen Schwellenwert festlegen können.

JSONata-Operatoren

Alle JSONata-Operatoren werden unterstützt, mit Ausnahme der im Folgenden aufgelisteten:

• Pfadoperatoren
  Nicht unterstützt:
  • ^(…) (Order-by)
• Numerische Operatoren
• Vergleichsoperatoren
• Boolesche Operatoren
• Andere Operatoren
  Nicht unterstützt:
  • ~> (Kette)
  • := (Variablenbindung)
  • ... ~> | ... | ... | (Transformieren)

• Verwenden Sie die Klammer ( ) für die Ausdrucksgruppierung und ändern Sie die Vorrangstellung für Operatoren.
• Verwenden Sie einzelne oder doppelte Anführungszeichen, um Zeichenfolgen und Eigenschaftsnamen zu umgeben, z. B. $event.object.'ab'.
• Verwenden Sie Backticks, um Eigenschaftsnamen zu umgeben, die Sonderzeichen (einschließlich Leerzeichen) enthalten. Beispiel:

  {"x y":22}.`x y`

• Verwenden Sie Backticks, um Eigenschaftsnamen einzuschließen, die mit einer Ziffer beginnen. Beispiel:

  `7emperature`

JSONata-Funktionen

• Alle Zeichenfolgefunktionen
• Alle numerischen Funktionen
• Alle numerischen Aggregationsfunktionen
• Alle booleschen Funktionen
• Die folgenden Array-Funktionen:
  • $count
  • $append

Zuordnungsausdruckssprache erweitern

Die Zuordnungsausdruckssprache wurde durch die Einführung der Variablen '$event', '$state' und '$instance' ergänzt und kann nun zusammen mit der Funktion für das Datenmanagement verwendet werden. JSON wird an diese Variablen gebunden, bevor der Ausdruck ausgewertet wird. In der folgenden Tabelle erhalten Sie einen Überblick über diese Variablen, die zur Verwendung in Ausdrücken definiert sind.

Im folgenden Beispiel wird das folgende Objekt als Eingabe für ein Ereignis verwendet:

{
    "temperature": 35,
    "humidity": 72,
    "pressure": 1024
}

Das Objekt wird unter Verwendung des folgenden Ausdrucks in ein Array konvertiert:

[$event.temperature, $event.humidity, $event.pressure]

Der Ausdruck führt zur folgenden Ausgabe:

 [
    35,
    72,
    1024
  ]

Sie können dieses Beispiel umkehren und ein Array von der Eingabe in ein Objekt konvertieren. Im folgenden Beispiel wird das folgende Array als Eingabe für ein Ereignis verwendet:

{
    "readings": [
      35,
      72,
      1024
    ]
  }

Das Array wird unter Verwendung des folgenden Ausdrucks in ein Objekt konvertiert:

 {"temperature": $event.readings[0], "humidity": $event.readings[1], "pressure": $event.readings[2]}

Der Ausdruck führt zur folgenden Ausgabe:

{
  "temperature": 35,
  "humidity": 72,
  "pressure": 1024
}

Sie können auch einen Ausdruck definieren, in dem diese Variablen gemeinsam verwendet werden. Im folgenden Beispiel wird eine Eigenschaft temp_adjustment in den Gerätemetadaten definiert und zum Kalibrieren der Ereignisablesung verwendet. Die Eigenschaft ist in einer Zuordnung definiert, kann jedoch auf viele Geräte angewendet werden.

"propertyMappings" : {
        "tevt" : {
           "temperature" : "$event.t + $instance.metadata.temp_adjustment"
        }
     },

Der Punktoperator "." wird für den Objektzugriff mit einem Literalschlüssel verwendet, z. B. '$event.object.hh'. Der erste Ausdruck, im Beispiel $event.t, ist auf eine bestimmte Eigenschaft beschränkt, entweder im Ereignis ($event) oder im Status ($state) oder in den Metadaten ($instance). Der zweite Ausdruck, im Beispiel $instance.metadata.temp_adjustment, enthält die Informationen, auf die Sie möglicherweise zugreifen möchten.

Sprachenhandbuch

• Alle einfachen Abfragen werden unterstützt.
• Mit Ausnahme von Platzhalterzeichen werden Prädikatabfragen unterstützt.
• Klammerausdrücke werden unterstützt, mit Ausnahme von Codeblöcken.
• Die folgenden Bedingungsausdrücke werden unterstützt:
  • Bedingungslogik
  • Variablen
    Variablen werden durch die Verwendung der Variablen $instance, $stateund $event als Teil der erweiterten Zuordnungssprache unterstützt, die für diese Datenmanagementfunktion spezifisch ist.
    Hinweis: Die Variablen $ und $$ , die in JSONata verwendet werden, werden derzeit nicht unterstützt.
  • Aufruf der meisten vordefinierten Funktionen.
    
    Hinweis: Sie können keine eigenen Funktionen definieren.

Ausgabe wird erstellt

Sie können angeben, wie verarbeitete Daten in der Ausgabe mithilfe von Array-Konstruktoren oder Objektkonstruktoren dargestellt werden.

Unterstützte Array-Konstruktoren

Arrays können erstellt werden, indem eine durch Kommas getrennte Liste von Literalen oder Ausdrücken in eckige Klammern eingeschlossen wird. Kommas werden verwendet, um mehrere Ausdrücke innerhalb des Array-Konstruktors zu trennen, z. B. [1, 3-1] = [1,2], [1..3] -> [1,2,3] und [1..3, 7..9] -> [1,2,3,7,8,9].

Unterstützte Objektkonstruktoren

Sie können JSON-Objekte in Ihrer Ausgabe erstellen, indem Sie ein Paar geschweifter Klammern {} verwenden, die Schlüsselwerte oder Paare enthalten, die durch Kommas getrennt sind, wobei jeder Schlüssel und jeder Wert durch einen Doppelpunkt getrennt sind, z. B. {key1 : value1, key2:value2} oder {"hello" : "world"}. Der Objektschlüssel muss eine Zeichenfolge sein.

Behandlung von Fehlübereinstimmungen zwischen Zuordnungsausdruck und Eingabedaten

Eine Statusaktualisierung kann fehlschlagen, wenn einer der Zuordnungsausdrücke einen Verweis auf Eingabedaten enthält, die in dem veröffentlichten Ereignis nicht angegeben sind.

Sie können zum Beispiel die folgenden Ausdrücke konfigurieren:

temperature = $event.t
humidity = $event.hum

Dabei ist t eine optionale Eigenschaft für das Ereignis.

Wenn ein Ereignis empfangen wird, das nur Feuchtigkeitsdaten enthält, z. B. {"humidity":22}, schlägt die Auswertung des Ausdrucks temperature = $event.t fehl, da die optionale Eigenschaft T im publizierten Geräteereignis nicht angegeben ist.

Die Statusaktualisierung schlägt fehl. Die Eigenschaft für den Feuchtigkeitsstatus wird nicht aktualisiert und im MQTT-Fehlertopic für das Gerät wird eine Fehlernachricht publiziert:

iot-2/type/${typeId}/id/${deviceId}/err/data

Um zu verhindern, dass Statusaktualisierungsfehler aufgrund von nicht angegebenen optionalen Daten auftreten, können Sie die Funktion '$exists' in Kombination mit einem ternären Zustand verwenden, um einen Standardwert für optionale Eigenschaften anzugeben. Im folgenden Beispiel wird der Standardwert 0 für die Eigenschaft t definiert:

"tempEvent:
    {
      "temperature": "$exists($event.t)?$event.t:0",
      "humidity": "$event.hum"
    }

Wenn Sie auf diese Weise einen Standardwert für die optionale Eigenschaft definieren, wird der Ausdruck erfolgreich ausgewertet, auch wenn die Eigenschaft t im publizierten Geräteereignis nicht angegeben ist.

Wenn das Ereignis {"humidity":22} empfangen wird, wird die Statusaktualisierung erfolgreich abgeschlossen und der Gerätestatus auf {"humidity":22, "temperature":0}gesetzt.