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".
{ "status": { "$eq": "active" } }Décortiquons cette expression :
"status"est le nom du champ que vous voulez tester$eqsignifie "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 :
{ "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 :
Syntaxe de base
Apprenez la structure JSON et les types primitifs de MEL.
Sources de données
Découvrez les préfixes $form, $object, $user et autres.
Opérateurs de comparaison
Maîtrisez $eq, $gt, $in, $regex et tous les opérateurs.
Opérateurs logiques
Combinez des conditions avec $and, $or et $not.
Expressions imbriquées
Créez des filtres complexes en combinant les opérateurs.
Contexte d'évaluation
Comprenez comment MEL résout les chemins de données.
Exemples pratiques
Des cas d'usage concrets pour vous inspirer.
Bonnes pratiques
Conseils pour des expressions performantes et lisibles.