Documentation

Cookies

Nous utilisons les cookies afin de vous garantir la meilleure expérience sur notre site. Vous pouvez modifier vos préférences à tout moment en cliquant sur "Cookies" en pied de page.

Introduction à MEL

Bienvenue dans le guide de MEL (MIEL Expression Language). Vous allez découvrir comment filtrer, interroger et évaluer vos données de manière puissante et flexible.

Qu'est-ce que MEL ?

MEL est un langage d'expression dédié au filtrage et à l'interrogation de données dans Miel. Il utilise une syntaxe JSON lisible avec des opérateurs préfixés par $.

Pensez à MEL comme un système de requête visuel : vous décrivez les conditions que vos données doivent respecter, et Miel se charge de trouver les éléments correspondants.

Par exemple, vous pouvez utiliser MEL pour :

  • Afficher uniquement les factures avec le statut "validée"
  • Filtrer les commandes d'un client spécifique
  • Lister les tâches assignées à l'utilisateur connecté
  • Trouver les éléments créés dans les 30 derniers jours

Bon à savoir

MEL s'inspire de la syntaxe de requête de MongoDB, un standard reconnu dans l'industrie. Si vous connaissez déjà MongoDB, vous vous sentirez immédiatement à l'aise avec MEL.

Votre première expression

Commençons par un exemple simple. Imaginons que vous souhaitez afficher uniquement les éléments dont le statut est "active".

JSON
{ "status": { "$eq": "active" } }

Décortiquons cette expression :

  • "status" est le nom du champ que vous voulez tester
  • $eq signifie "est égal à" (equal)
  • "active" est la valeur recherchée

Cette expression se lit : "Garde uniquement les éléments où le champ status est égal à active".

Voici un autre exemple qui filtre les commandes avec un montant supérieur à 1000 :

JSON
{ "amount": { "$gt": 1000 } }

Ici, $gt signifie "est supérieur à" (greater than).

MEL vs Formules

Miel propose deux langages complémentaires : les Formules et MEL. Chacun a son rôle spécifique.

Formules

Servent à calculer des valeurs à partir de vos données.

  • Calculs mathématiques
  • Transformation de texte
  • Logique conditionnelle
  • Manipulation de dates

MEL

Sert à filtrer et sélectionner des données.

  • Filtrage de listes
  • Conditions d'affichage
  • Requêtes de données
  • Validation de critères

En résumé

Utilisez les Formules pour répondre à "Quelle est la valeur ?" et MEL pour répondre à "Quels éléments correspondent à ces critères ?".

Caractéristiques principales

Syntaxe JSON

MEL utilise le format JSON, un standard lisible et facile à valider. Pas besoin d'apprendre une nouvelle syntaxe complexe.

Opérateurs préfixés

Tous les opérateurs commencent par $, ce qui les rend immédiatement identifiables.

Résolution dynamique

Les valeurs peuvent référencer d'autres champs ou le contexte d'exécution, rendant vos filtres adaptatifs.

Compositions illimitées

Combinez autant de conditions que nécessaire avec les opérateurs logiques $and et $or.

Prochaines étapes

Maintenant que vous comprenez les bases de MEL, explorez les différentes sections pour maîtriser toutes ses fonctionnalités :