Introduction aux Formules
Bienvenue dans le guide du langage de formules Miel. Vous allez découvrir comment créer des calculs dynamiques, transformer vos données et automatiser votre logique métier.
Qu'est-ce qu'une formule ?
Une formule est une expression qui calcule automatiquement une valeur à partir de vos données. Pensez-y comme une cellule Excel, mais en beaucoup plus puissant.
Par exemple, vous pouvez utiliser une formule pour :
- Calculer le total d'une commande à partir des lignes de produits
- Afficher automatiquement le nom du client sur un bon de livraison
- Déterminer si une facture est en retard
- Générer un numéro de dossier unique
Bon à savoir
Le langage de formules Miel utilise une syntaxe en français. Toutes les fonctions comme SOMME, FILTRER ou SI sont en français pour être plus intuitives.
Votre première formule
Commençons par un exemple simple. Imaginons que vous souhaitez calculer le prix TTC d'un produit à partir de son prix HT avec une TVA de 20%.
{{produit.prixHT}} * 1.20Dans cette formule :
{{produit.prixHT}}récupère le prix HT du produit* 1.20multiplie par 1.20 pour ajouter 20% de TVA
Si le prix HT est de 100€, la formule calculera automatiquement 120€.
Voici un autre exemple qui affiche un message différent selon le montant d'une commande :
SI {{commande.total}} > 1000
ALORS "Client Premium"
SINON "Client Standard"
FINSICette formule affichera "Client Premium" si le total dépasse 1000€, sinon "Client Standard".
Caractéristiques principales
Syntaxe française
Toutes les fonctions sont en français : SOMME, FILTRER, TRANSFORMER, SI... C'est plus naturel et intuitif à utiliser.
Typage dynamique
Pas besoin de déclarer les types. Miel comprend automatiquement si vous travaillez avec des nombres, du texte ou des dates.
Précision des calculs
Les calculs utilisent une précision arbitraire (Decimal) pour éviter les erreurs d'arrondi courantes avec les nombres à virgule.
Accès aux données
Accédez facilement aux champs de vos objets avec la notation {{objet.champ}}.
Prochaines étapes
Maintenant que vous comprenez les bases, explorez les différentes sections pour maîtriser les formules Miel :
Syntaxe de base
Apprenez les fondamentaux : nombres, textes, booléens et tableaux.
Interpolation
Accédez aux données de vos objets avec la syntaxe {{...}}.
Opérateurs
Effectuez des calculs et des comparaisons.
Conditions
Créez des logiques conditionnelles avec SI...ALORS...SINON.
Variables
Stockez des valeurs intermédiaires pour des formules plus lisibles.
Fonctions de tableaux
Manipulez des listes avec SOMME, FILTRER, TRANSFORMER...
Fonctions de dates
Travaillez avec les dates : AUJOURDHUI, DATE, JOURS.OUVRES...
Fonctions numériques
Formatez et manipulez les nombres.
Fonctions de texte
Transformez et manipulez du texte.
Fonctions booléennes
Vérifiez des conditions avec EXISTE, TOUT.EGAL.A...
Accès aux données
Recherchez des objets dans votre base avec CHERCHER.OBJET.
Gestion des erreurs
Gérez les cas d'erreur gracieusement.
Exemples pratiques
Des cas d'usage concrets pour vous inspirer.
Bonnes pratiques
Conseils pour des formules performantes et maintenables.