Interpolation

Qu'est-ce que l'interpolation ?

L'interpolation permet d'insérer dynamiquement des valeurs provenant de vos objets dans une formule. La syntaxe utilise des doubles accolades : {{...}}.

Par exemple, si vous avez un objet "Commande" avec un champ "total", vous pouvez y accéder ainsi :

{{commande.total}}

Quand la formule s'exécute, {{commande.total}} sera remplacé par la valeur réelle du champ (par exemple, 1500).

Accès aux champs

La syntaxe de base pour accéder à un champ est {{typeObjet.nomChamp}}.

{{commande.total}}              // Le total de la commande
{{client.nom}}                  // Le nom du client
{{produit.prixUnitaire}}        // Le prix unitaire du produit
{{facture.dateEcheance}}        // La date d'échéance de la facture

Contexte de la formule

Le type d'objet que vous pouvez utiliser dépend du contexte où la formule est définie. Par exemple :

• Dans une formule sur un objet "Commande", vous avez accès aux champs de la commande
• Si la commande a un lien vers un "Client", vous pouvez naviguer vers ses champs
• Si la commande contient des "Produits", vous pouvez accéder à leurs propriétés

Navigation imbriquée

Vous pouvez naviguer à travers plusieurs niveaux de relations en enchaînant les noms de champs avec des points.

// Accéder au nom du client d'une commande
{{commande.client.nom}}

// Accéder à l'email du responsable d'un projet
{{projet.responsable.email}}

// Accéder à la ville de l'adresse du fournisseur
{{fournisseur.adresse.ville}}

Accès aux champs de tableaux

Quand vous accédez à un champ sur un tableau d'objets, vous obtenez un tableau de ces valeurs :

// Si commande.produits est un tableau de produits
{{commande.produits.prixHT}}        // [100, 50, 75] - tableau des prix

// Vous pouvez ensuite calculer dessus
SOMME({{commande.produits.prixHT}}) // 225 - somme des prix

Références spéciales

Outre les champs classiques, Miel propose plusieurs références spéciales pour des cas d'usage courants.

// Afficher le nom de l'utilisateur connecté
{{selfUser.fullname}}

// Filtrer les tâches assignées à l'utilisateur actuel
FILTRER({{taches}}, {{$.assigneA}} == {{selfUser}})

// Filtrer les nombres supérieurs à 10
FILTRER([5, 15, 8, 20], {{$}} > 10)        // [15, 20]

// Doubler chaque nombre
TRANSFORMER([1, 2, 3], {{$}} * 2)          // [2, 4, 6]

// Accéder aux champs de l'élément courant
FILTRER({{produits}}, {{$.stock}} > 0)

// Exemple avec double itération
TRANSFORMER(
  UNIQUE({{commande.produits.tva}}),    // Pour chaque taux de TVA
  SOMME(
    TRANSFORMER(
      FILTRER({{commande.produits}}, {{$.tva}} == {{$1}}),
      {{$.prixHT}}
    )
  )
)

Combiner avec des calculs

L'interpolation devient vraiment puissante quand vous la combinez avec des opérateurs et des fonctions.

// Calcul simple
{{produit.prixHT}} * 1.20                           // Prix TTC

// Calcul avec plusieurs champs
{{produit.prixUnitaire}} * {{produit.quantite}}     // Sous-total

// Concaténation de texte
CONCAT("Bonjour ", {{client.prenom}}, " !")         // "Bonjour Constance !"

// Condition basée sur une valeur
SI {{commande.total}} > 1000
ALORS "Livraison gratuite"
SINON "Frais de port : 5€"
FINSI

Prochaine étape

Maintenant que vous savez accéder à vos données, apprenez à les manipuler avec les opérateurs de calcul et de comparaison.