"Power Fx", le langage de formules

Introduction à Power Fx et aux formules

Power Fx est le nom donné au langage de formule utilisé dans Power Apps.

Ce langage permet de créer des logiques de calculs métier, d’ajouter de l’interactivité, d’afficher des notifications ainsi que d’exécuter certaines opérations comme envoyer un e-mail ; tout ceci avec un minimum de code (low code).

À l’instar d’Excel, les calculs sont effectués à l’aide de formule(s) contenue(s) non pas dans une cellule cette fois, mais dans les propriétés d’un contrôle.

Exemple avec un contrôle de type "Étiquette" (label) : dans sa propriété Text, on écrit la formule suivante pour calculer un montant TTC.

in_Montant_HT.Text * 1.2 

Le contrôle "in_Montant_HT" est de type "Entrée texte", il contient le montant HT saisi par l’utilisateur.

Voici une copie d’écran de la barre de formule :

Une formule représente une expression ou un ensemble d’expressions. Une expression est une opération de calcul (sur des dates, des nombres, du texte ou tout autre type). Une opération peut contenir une fonction (par exemple, Upper("ma société)), ou une valeur, comme la chaîne de texte seule : "Eni-Edition".

Exemple d’une formule qui permet de récupérer l’adresse de l’e-mail de l’utilisateur connecté grâce à la fonction User() et sa propriété .Email :

User().Email 

Power Fx ne ressemble pas à un langage classique de développement comme le C#, le VBA ou Java, mais est plutôt un langage de formule.

Il désigne la syntaxe et la grammaire du code que l’on peut utiliser dans Power Apps. L’ensemble du code...

Syntaxe Power Fx

Une "phrase" Power Fx est une formule. Cette formule peut être constituée d’une ou de plusieurs fonctions, d’une ou de plusieurs expressions.

Celle-ci peut contenir des opérateurs de comparaison comme "And", "Or" ou des opérateurs de concaténation comme "&".

Si l’on souhaite que plusieurs formules s’exécutent les unes à la suite des autres, il est nécessaire que chaque phrase se termine par la ponctuation de fin de formule suivante ";;" (double point-virgule), suivie éventuellement d’un commentaire ("//" ou "/*  */").

Étudions l’exemple suivant : on souhaite qu’un utilisateur, en cliquant sur une icône "Actualiser", puisse actualiser la base de données "RH_ListeDesFormations" et qu’il y ait une notification de confirmation qui dure 3 secondes.

Pour cela, on insère la formule suivante dans la propriété OnSelect de l’icône "Actualiser" :

Refresh( "RH_ListeDesFormations" );; 
Notify( User().FullName & " ,La base a été actualisée"; Success; 
3000 ) // 3000 = 3 secondes d'attente du bandeau 

Résultat - Affichage du bandeau :

Lorsque l’on renseigne les propriétés de type "Données" (Tooltip, Text, etc.) ou de "Conception" (Color, Visible, etc.), la formule Power Fx que l’on écrit est interprétée (calculée) et renvoie un résultat.

Le résultat de l’expression renvoie une valeur (par exemple un booléen...

Les fonctions

Power Apps dispose de nombreuses fonctions similaires à celles que l’on trouve dans Excel.

Upper("Bonjour " & User().FullName) 

2. Créer sa propre fonction

Il est possible de créer ses propres fonctions en activant le paramètre Propriétés du composant amélioré dans les paramètres de l’application, puis en utilisant les "composants" et "composants réutilisables" dans les bibliothèques de composants.

Exemple où l’on souhaite créer une fonction qui calcule le TTC depuis un montant HT.

 Activez l’option Propriétés du composant amélioré depuis les paramètres de l’App :

 Depuis l’arborescence de l’App, cliquez sur Composants, puis sur + Nouveau composant. Vous nommerez le composant ainsi créé...

Travailler avec des variables

Lorsque l’on commence à développer plus profondément une application et que l’on souhaite ajouter plus d’interactivité, l’usage des variables devient nécessaire. 

Une variable est un espace mémoire (comme un casier) dans lequel on vient stocker une valeur (du texte, un nombre, une formule qui retourne un résultat, etc.).

On lui choisit un nom pour la manipuler plus facilement.

Exemple : on souhaite stocker dans une variable le montant TTC d’un achat pour le récupérer plus tard lorsque le panier est validé :

Set( varMontantTTC; Value(in_MontantHT.Text) * 1,2 ) 

Cette formule utilise la fonction de comportement Set(), qui est une action de stockage. Cette formule stocke le résultat du calcul Value(in_MontantHT.Text) * 1,2) dans la variable nommée "varMontantTTC".

Plutôt que de refaire le calcul à chaque fois qu’on a besoin du TTC, il suffit de rappeler la variable qui est en mémoire. Cela peut servir par exemple pour faire une somme dans un panier, envoyer le total par e-mail ou le publier dans Teams.

Power Apps propose plusieurs types de variables avec des portées différentes :

UpdateContext( {NomVCar: "PC02"} ). 

Navigate( Ecran02; Cover; {NomVCar: NomVCar & " - suivant"}...

Les opérateurs logiques et de comparaison

Les opérateurs logiques (OR, NOT, AND, etc.) et de comparaison (>, <, =, etc.) sont communément utilisés dans Power Apps pour assurer les logiques d’application métier.

If( <Expression ou formule> ; <Si le résultat de la formule ou  
de l'expression précédente est vrai: exécute la formule écrite ici> ;  
<Sinon, exécute cette formule-là> ) 

If( <Expression1>; <Si Expression1 est vrai, ici execute> 
[; <Sinon Expression2>; <Si Expression2 est vrai, ici execute>; ... 
[;<Sinon execute par defaut>] ]) 

If( Value(Montant.Text) > 5000; FontWeight.Bold; FontWeight.Normal ) 

Les opérateurs ThisItem, As et ThisRecord

ThisItem

L’opérateur ThisItem, utilisé dans les galeries et dans les formulaires, fait référence à la source de données de son parent. La data source du parent se situe dans les propriétés Items/Item de la galerie ou du formulaire.

Syntaxe

ThisItem.<nomDeColonne>[.<nomSous-Colonne>] 

Exemple

Depuis une galerie connectée à la source de données "RH - Liste de Formation", on souhaite afficher l’e-mail du créateur.

ThisItem.'Créé par'.Email 

As

L’opérateur As permet de nommer une expression, une table ou une collection avec un nom plus explicite à la place de l’opérateur générique ThisItem.

Syntaxe

<Expression ou Table> As <Nom> 

Exemple

On souhaite nommer le résultat d’un filtre sur une source de données.

Filter( 'RH - Liste de Formation'; ThisRecord.Créé >= Today() ) As 
FormationsDuJour 

FormationsDuJour.'Créé par'.Email 

Le nom "FormationsDuJour", remplace l’opérateur générique ThisItem. Ce qui permet d’écrire, par exemple, ’FormationsDuJour.Title’ au lieu de ThisItem.Title.

ThisRecord

En utilisant le préfixe opérateur ThisRecord, on s’assure que seules les colonnes (ou champs) de la source de données seront énumérées (pas de nom d’objets Power Apps venant ajouter de l’ambiguïté). De plus, cela précise qu’il s’agit de la source de données citée en paramètre.

Syntaxe...

Les boucles ForAll, With et Sequence

La fonction ForAll() "balaye" un tableau qui lui est passé en paramètre. Pour chaque itération, du premier élément du tableau jusqu’au dernier élément, la fonction exécutera la formule transmise dans son second paramètre pour chacun des éléments.

Syntaxe

ForAll( <Table | Source de données>; <Formule à exécuter à chaque 
élément de la table> ) 

Exemple

Il s’agit d’envoyer un e-mail à chaque utilisateur d’une liste des personnes qui ont créé une formation ce jour.

La fonction ForAll() va, pour chaque élément (chaque ligne du tableau varStagiaires), exécuter la formule d’envoi du courrier via Outlook.

Résultat après que l’utilisateur a créé deux nouvelles formations ; il reçoit ses confirmations :

With

Pour évaluer un seul enregistrement...

Quelques bonnes pratiques

Voici quelques bonnes pratiques à respecter pour s’assurer de la qualité d’écriture des formules, ce qui aide à limiter les bugs et accroît la lisibilité des formules :

Exemple avec une formule par ligne avec indentation (alignement virgule, etc.) :

Set( varFilter       , "ALL"  );; // variable de sélection filtre 
Set( varSort         , false  );; // variable pour le sens du tri 
Set( varTimelineIndex, 0      );; // indicateur barre de temps 

Exemple sans mise en forme :

Résultat avec mise en forme automatique, en cliquant sur le bouton Mettre le texte en forme :