MXL - Lenguaje de Expresiones de Meddle

Descripción General

MXL (Meddle Expression Language) es un lenguaje de expresiones simple usado en conectores de Meddle para definir condiciones y lógica.

Usado en:

• Conector Trigger
• Conector Alert

Sintaxis

Las expresiones MXL se evalúan a valores booleanos (verdadero/falso) basados en datos de carga.

Estructura Básica

nombre_campo operador valor

Ejemplos

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

Operadores

Operadores de Comparación

Operador	Descripción	Ejemplo
>	Mayor que	temperature > 80
<	Menor que	pressure < 10
>=	Mayor o igual que	humidity >= 60
<=	Menor o igual que	speed <= 100
==	Igual a	status == "active"
!=	No igual a	count != 0

Operadores Lógicos

Operador	Descripción	Ejemplo
&&	AND (ambas condiciones deben ser verdaderas)	temp > 80 && press < 10
`		`

Tipos de Datos

Números

Comparar valores numéricos:

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

Cadenas

Comparar valores de cadena (usar comillas dobles):

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

Booleanos

Comparar valores booleanos:

enabled == true
fault != false

Expresiones Complejas

Múltiples Condiciones con AND

Todas las condiciones deben ser verdaderas:

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

Múltiples Condiciones con OR

Al menos una condición debe ser verdadera:

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

Combinando AND y OR

Usa paréntesis para agrupar (si está soportado):

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

Patrones Comunes

Verificación de Rango

Verificar si el valor está dentro del rango:

temperature >= 20 && temperature <= 30

Alerta de Umbral

Alertar cuando el valor excede el umbral:

temperature > 80
pressure > 150
vibration > 5.0

Monitoreo de Estado

Verificar valores de estado específicos:

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

Alerta Multi-Parámetro

Alertar sobre múltiples condiciones:

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

Interbloqueo de Seguridad

Asegurar que se cumplan múltiples condiciones:

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

Ejemplos por Caso de Uso

Monitoreo de Temperatura

// Advertencia de temperatura alta
temperature > 80

// Temperatura fuera de rango
temperature < 15 || temperature > 35

// Temperatura crítica con presión
temperature > 100 && pressure > 150

Estado de Equipo

// Máquina detenida inesperadamente
status == "stopped" && runtime > 0

// Condición de error
status == "error" || status == "fault"

// No en modo automático
mode != "auto"

Control de Calidad

// Defecto detectado
defect_count > 0

// Fuera de especificación
dimension < 9.9 || dimension > 10.1

// Múltiples parámetros de calidad
hardness < 50 || surface_finish > 2.0 || weight < 100

Control de Proceso

// Proceso fuera de control
temperature > 90 || pressure < 95 || flow < 50

// Operación estable
temperature >= 80 && temperature <= 85 && pressure > 100

// Condición de apagado de emergencia
temperature > 120 || pressure > 200 || vibration > 10

Mantenimiento Predictivo

// Anomalía detectada
is_anomaly == true

// Puntuación de anomalía alta
anomaly_score > 0.8

// Múltiples indicadores
vibration > 5 || temperature > 90 || anomaly_score > 0.7

Mejores Prácticas

1. Usa Nombres de Campo Claros

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

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

2. Usa Operadores Apropiados

// Para igualdad, usa ==
status == "active"

// Para desigualdad, usa !=
count != 0

3. Agrupa Condiciones Relacionadas

// Bueno - condiciones relacionadas juntas
temperature > 80 && pressure > 150

// Bueno - condiciones alternativas
status == "error" || status == "fault"

4. Considera la Precedencia de Operadores

AND (&&) tiene mayor precedencia que OR (||):

// Esto verifica: (A && B) || C
temperature > 80 && pressure > 150 || humidity > 90

// Usa paréntesis para claridad
(temperature > 80 && pressure > 150) || humidity > 90

5. Prueba Tus Expresiones

Prueba expresiones con varios valores de entrada para asegurar que funcionen como se espera.

Limitaciones

• Sin operaciones aritméticas: No se puede hacer temperature + 10 > 90
• Sin llamadas a funciones: No se puede hacer abs(temperature) > 80
• Sin acceso a campos anidados: No se puede hacer sensor.temperature > 80
• Solo comparación de cadenas: Sin regex o coincidencia de patrones

Solución de Problemas

La Expresión No se Activa

Verificar:

1. Los nombres de campos coinciden exactamente con la carga (sensible a mayúsculas/minúsculas)
2. Los tipos de datos coinciden (número vs cadena)
3. El operador es correcto (== no =)
4. Los valores de cadena usan comillas dobles

Siempre se Activa

Verificar:

1. La lógica es correcta (AND vs OR)
2. Los valores de umbral son apropiados
3. El campo existe en la carga

Errores de Sintaxis

Errores comunes:

• Usar = en lugar de ==
• Faltan comillas alrededor de cadenas
• Errores tipográficos en nombres de campos
• Precedencia de operadores incorrecta

Ejemplos en Contexto

Conector Trigger

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

Conector Alert

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

Documentación Relacionada

• Conector Trigger - Usar MXL para lógica condicional
• Conector Alert - Usar MXL para condiciones de alerta
• Detección de Anomalías - Combinar con MXL para alertas inteligentes