Lire en anglais

Partager via


Utiliser Power Fx dans Power Pages (version préliminaire)

[Cette rubrique fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Power Fx est le langage low code pour exprimer la logique dans Microsoft Power Platform. C’est un langage de programmation polyvalent, fortement typé, déclaratif et fonctionnel.

Power Fx est exprimé dans un texte convivial. C’est un langage low code avec lequel les créateurs peuvent travailler directement dans une barre de formule de type Excel. Le mot « low » dans low code décrit la nature concise et simple du langage, rendant les tâches de programmation courantes faciles pour les créateurs et les développeurs.

Notes

Vous trouverez peut-être que la syntaxe pour créer la formule Power Fx est différente de celle à laquelle vous êtes peut-être habitué dans Power Apps ou Power Automate. Pour lancer une expression Power Fx, elle doit commencer par « = » (signe égal) comme dans Excel. Pour plus d’informations, voir Considérations importantes.

Power Fx permet le spectre complet du développement, depuis les créateurs sans code sans aucune connaissance en programmation jusqu’au pro-code pour les développeurs professionnels. Il facilite la collaboration entre diverses équipes, en leur permettant d’économiser du temps et des efforts.

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.
  • La fonctionnalité est disponible avec Power Pages version 9.6.5.x.

Utiliser Power Fx dans Power Pages

Dans un site Web Power Pages, Power Fx est disponible en tant que langage d’expression à utiliser avec les composants suivants et leurs attributs. Cette fonctionnalité permet l’attribution dynamique de valeurs en fonction des résultats des expressions Power Fx.

Composant Propriétés
Texte Texte
Image URL de l’image, Texte de remplacement
Bouton URL du bouton, Texte du bouton
iFrame URL iFrame

Utiliser la barre de formule Power Fx

La barre d’outils inclut une nouvelle commande fx pour les composants qui prennent en charge Power Fx :

Capture d’écran de la commande Power Fx dans la barre de commande d’un contrôle de texte.

Sélectionnez fx pour accéder à la barre de formule Power Fx.

Composants de la barre de formule

La capture d’écran suivante met en évidence certains des composants importants de la barre de formule :

Capture d’écran de la barre de formule Power Fx dans Power Pages.

  1. Un menu déroulant vous permet de choisir parmi les propriétés des composants disponibles.

  2. Une zone de texte extensible multiligne permet de créer des formules Power Fx.

  3. Le bouton Réinitialiser définit une propriété de composant sur sa valeur par défaut.

  4. Le bouton Enregistrer permet de conserver la formule et les expressions pour la propriété du composant. Le canevas du studio est immédiatement mis à jour si la valeur obtenue est disponible et peut être affichée comme telle dans les propriétés du texte.

Expériences de la barre de formule

Voici quelques fonctionnalités centrées sur les développeurs pour une meilleure productivité :

  • Assistance pour la saisie semi-automatique : suggère des formules, paramètres, tables et objets. Sélectionnez Ctrl + espace pour accéder manuellement à cette fonctionnalité.

    Capture d’écran de l’expérience de saisie semi-automatique dans Power Fx.

  • Fonctionnalité d’affichage des problèmes : aide à la validation et au débogage initials des formules et des expressions.

    Capture d’écran de l’expérience lorsqu’un problème est détecté dans une formule Power Fx.

  • Boîte de dialogue des modifications non enregistrées : s’affiche si vous quittez la barre de formule alors que des modifications non enregistrées sont présentes dans une formule.

    Capture d’écran de la boîte de dialogue des modifications non enregistrées avec les options Retour ou Ignorer.

    Sélectionnez Retour pour continuer à modifier la formule ou Ignorer pour ignorer les modifications.

Remarques importantes

Tenez compte des instructions suivantes lorsque vous utilisez la barre de formule Power Fx dans Power Pages :

  • Commencer par un signe égal : le texte peut être saisi directement comme valeur. Pour lancer une expression Power Fx, elle doit commencer par « = » (signe égal), comme indiqué dans l’exemple suivant :

    =Concatenate("Hello, ", User.FullName)
    
  • Les tables sont accessibles en toute sécurité : les tables Dataverse sont accessibles en toute sécurité à l’aide de formules. Vérifiez d’abord que les autorisations de table sont correctement configurées. De plus, le contexte d’un utilisateur du site est disponible à l’aide de l’objet Utilisateur. Par exemple, l’expression suivante récupère la valeur DataverseUserId de l’utilisateur actuellement authentifié.

    =Concatenate("Hello, ", First(Filter(Contacts,Contact = User.DataverseUserId)).'First Name' & "!")
    

    Notes

    L’objet Utilisateur représente un utilisateur Power Pages et ne prend donc pas en charge le même ensemble de propriétés que la fonction Utilisateur.

  • Insérer une valeur dans le texte : pour insérer une valeur dans le texte, utilisez la syntaxe suivante.

    This text ${variable/ expression} includes a dynamic value.
    

    Par exemple :

    The total number is ${Sum(10, 20)}
    

Fonctions Power Fx disponibles

Pour la liste complète de toutes les fonctions disponibles dans Power Pages, accédez à Référence de formule - Power Pages.

Problèmes connus et limitations

  • Certaines fonctions Power Fx présentées via IntelliSense ne sont pas actuellement prises en charge dans Power Pages. Ces fonctions affichent l’erreur de conception suivante lorsqu’elles sont utilisées :

    Parameter 'Value': PowerFx type is not supported.

  • Le système n’initialise pas l’utilisateur pour les utilisateurs anonymes, ce qui génère l’erreur suivante lorsque vous l’utilisez dans n’importe quel formulaire, y compris une recherche d’espaces vides. Ce problème sera corrigé dans une future version.

    UserInfo object was not added to service

  • Certains utilisateurs peuvent voir des problèmes avec les propriétés Bouton et URL de l’image qui ne fonctionnent pas lorsque la valeur est définie avec des formules ou expressions Power Fx contenant des guillemets doubles. Ce problème ne se produit que si vous disposez de la version 9.6.3.x et est corrigé lorsque votre site Power Pages est mis à niveau sur la version 9.6.5.x.

Questions fréquentes

Dois-je utiliser Power Fx au lieu de Liquid ?

Power Fx répond à certains scénarios de données dynamiques de manière low-code qui pourraient également être réalisés via le code Liquid avec des outils pour développeurs. Power Fx, actuellement en phase de version préliminaire publique, est recommandé pour les évaluations de sites d’essai ou de développement. Vos commentaires sont les bienvenus durant cette phase. Liquid est une fonctionnalité généralement disponible (GA) et fournit comparativement plus de fonctionnalités. Utilisez Liquid pour vos sites Web de production, en particulier dans les scénarios critiques et complexes.

Voir aussi