MXL - Meddle Expression Language

Übersicht

MXL (Meddle Expression Language) ist eine einfache Ausdruckssprache, die in Meddle-Konnektoren verwendet wird, um Bedingungen und Logik zu definieren.

Verwendet in:

• Trigger-Konnektor
• Alert-Konnektor

Syntax

MXL-Ausdrücke werden zu booleschen Werten (wahr/falsch) basierend auf Payload-Daten ausgewertet.

Grundstruktur

feldname operator wert

Beispiele

temperature > 80
pressure < 10
status == "active"
count != 0

Operatoren

Vergleichsoperatoren

Operator	Beschreibung	Beispiel
>	Größer als	temperature > 80
<	Kleiner als	pressure < 10
>=	Größer oder gleich	humidity >= 60
<=	Kleiner oder gleich	speed <= 100
==	Gleich	status == "active"
!=	Ungleich	count != 0

Logische Operatoren

Operator	Beschreibung	Beispiel
&&	UND (beide Bedingungen müssen wahr sein)	temp > 80 && press < 10
`		`

Datentypen

Zahlen

Numerische Werte vergleichen:

temperature > 25.5
pressure >= 101.3
count == 100
speed != 0

Zeichenketten

Zeichenkettenwerte vergleichen (verwenden Sie doppelte Anführungszeichen):

status == "active"
mode != "manual"
error_code == "E001"

Boolesche Werte

Boolesche Werte vergleichen:

enabled == true
fault != false

Komplexe Ausdrücke

Mehrere Bedingungen mit UND

Alle Bedingungen müssen wahr sein:

temperature > 20 && temperature < 30
pressure > 100 && humidity < 80 && status == "running"

Mehrere Bedingungen mit ODER

Mindestens eine Bedingung muss wahr sein:

temperature > 80 || pressure > 150
status == "error" || status == "fault" || status == "stopped"

Kombination von UND und ODER

Verwenden Sie Klammern zur Gruppierung (falls unterstützt):

(temperature > 80 || pressure > 150) && status == "active"

Häufige Muster

Bereichsprüfung

Prüfen, ob der Wert im Bereich liegt:

temperature >= 20 && temperature <= 30

Schwellenwert-Warnung

Warnung, wenn der Wert den Schwellenwert überschreitet:

temperature > 80
pressure > 150
vibration > 5.0

Statusüberwachung

Auf spezifische Statuswerte prüfen:

status == "error"
status != "running"
mode == "manual"

Multi-Parameter-Warnung

Warnung bei mehreren Bedingungen:

temperature > 100 || pressure > 150 || vibration > 5

Sicherheitsverriegelung

Sicherstellen, dass mehrere Bedingungen erfüllt sind:

temperature > 50 && pressure > 100 && flow > 10

Beispiele nach Anwendungsfall

Temperaturüberwachung

// Hohe Temperaturwarnung
temperature > 80

// Temperatur außerhalb des Bereichs
temperature < 15 || temperature > 35

// Kritische Temperatur mit Druck
temperature > 100 && pressure > 150

Gerätestatus

// Maschine unerwartet gestoppt
status == "stopped" && runtime > 0

// Fehlerzustand
status == "error" || status == "fault"

// Nicht im Automatikmodus
mode != "auto"

Qualitätskontrolle

// Fehler erkannt
defect_count > 0

// Außerhalb der Spezifikation
dimension < 9.9 || dimension > 10.1

// Mehrere Qualitätsparameter
hardness < 50 || surface_finish > 2.0 || weight < 100

Prozesskontrolle

// Prozess außer Kontrolle
temperature > 90 || pressure < 95 || flow < 50

// Stabiler Betrieb
temperature >= 80 && temperature <= 85 && pressure > 100

// Not-Stopp-Bedingung
temperature > 120 || pressure > 200 || vibration > 10

Vorausschauende Wartung

// Anomalie erkannt
is_anomaly == true

// Hoher Anomalie-Score
anomaly_score > 0.8

// Mehrere Indikatoren
vibration > 5 || temperature > 90 || anomaly_score > 0.7

Best Practices

1. Verwenden Sie klare Feldnamen

// Gut
temperature > 80
machine_status == "running"

// Vermeiden
t > 80
s == "r"

2. Verwenden Sie geeignete Operatoren

// Für Gleichheit verwenden Sie ==
status == "active"

// Für Ungleichheit verwenden Sie !=
count != 0

3. Gruppieren Sie verwandte Bedingungen

// Gut - verwandte Bedingungen zusammen
temperature > 80 && pressure > 150

// Gut - alternative Bedingungen
status == "error" || status == "fault"

4. Beachten Sie die Operator-Rangfolge

UND (&&) hat höhere Priorität als ODER (||):

// Dies prüft: (A && B) || C
temperature > 80 && pressure > 150 || humidity > 90

// Verwenden Sie Klammern zur Klarheit
(temperature > 80 && pressure > 150) || humidity > 90

5. Testen Sie Ihre Ausdrücke

Testen Sie Ausdrücke mit verschiedenen Eingabewerten, um sicherzustellen, dass sie wie erwartet funktionieren.

Einschränkungen

• Keine arithmetischen Operationen: Sie können nicht temperature + 10 > 90 machen
• Keine Funktionsaufrufe: Sie können nicht abs(temperature) > 80 machen
• Kein verschachtelter Feldzugriff: Sie können nicht sensor.temperature > 80 machen
• Nur Zeichenkettenvergleich: Kein Regex oder Pattern Matching

Fehlerbehebung

Ausdruck wird nicht ausgelöst

Prüfen Sie:

1. Feldnamen stimmen genau mit dem Payload überein (Groß-/Kleinschreibung beachten)
2. Datentypen stimmen überein (Zahl vs. Zeichenkette)
3. Operator ist korrekt (== nicht =)
4. Zeichenkettenwerte verwenden doppelte Anführungszeichen

Wird immer ausgelöst

Prüfen Sie:

1. Logik ist korrekt (UND vs. ODER)
2. Schwellenwerte sind angemessen
3. Feld existiert im Payload

Syntaxfehler

Häufige Fehler:

• Verwendung von = statt ==
• Fehlende Anführungszeichen um Zeichenketten
• Tippfehler in Feldnamen
• Falsche Operator-Rangfolge

Beispiele im Kontext

Trigger-Konnektor

{
  "type": "MeddleTrigger",
  "config": {
    "mode": "DirectDispatch",
    "condition": "temperature > 80 && status == \"active\"",
    "payload": {
      "alert": "high_temperature"
    }
  }
}

Alert-Konnektor

{
  "type": "MeddleAlert",
  "config": {
    "name": "Critical Alert",
    "condition": "temperature > 100 || pressure > 200",
    "minDuration": 10,
    "cooldown": 300,
    "notification": {
      "type": "Email",
      "toEmails": ["alerts@example.com"]
    }
  }
}

Verwandte Dokumentation

• Trigger-Konnektor - Verwendet MXL für bedingte Logik
• Alert-Konnektor - Verwendet MXL für Warnbedingungen
• Anomalieerkennung - Kombinieren Sie mit MXL für intelligente Warnungen