ThisRecord |
Cet enregistrement |
| Power Fx |
Syntaxe
Paramètres
| Nom |
Description |
| operator |
Ce paramètre permet de faire référence à l'enregistrement actuel lorsqu'on est dans un contexte d'évaluation de table, par exemple dans une formule AddColumns, Filter ou ForAll. |
Description
Cette fonction permet de retourner une référence à l'enregistrement actuel dans une table.
Remarques
- La fonction ThisRecord est essentielle dans les expressions contextuelles : Elle permet d'accéder à l'enregistrement en cours lors d'une opération sur une
table, comme avec AddColumns ou Filter. Cela évite d'avoir à nommer explicitement une variable
temporaire pour accéder aux champs.
- Elle favorise une meilleure lisibilité dans les fonctions imbriquées : Quand on utilise plusieurs niveaux de traitement sur des tables, ThisRecord
simplifie la compréhension en indiquant clairement à quel enregistrement on fait référence, surtout dans des boucles comme
ForAll ou des transformations de colonnes.
- ThisRecord remplace parfois les noms implicites des colonnes : Dans certains contextes, Power Fx permet d'utiliser les noms des champs
directement. Cependant, ThisRecord devient nécessaire lorsque les champs sont masqués par d'autres variables ou quand on veut clarifier leur origine.
- Elle est très utile pour créer de nouvelles colonnes personnalisées : Par exemple, dans AddColumns, on peut écrire
une formule qui s'appuie sur les champs de ThisRecord pour générer une valeur calculée à partir des données de chaque ligne de la table source.
- Elle permet d'éviter les conflits de noms dans des expressions complexes : Lorsque plusieurs tables ou enregistrements sont manipulés simultanément,
ThisRecord offre une façon explicite d'indiquer qu'on travaille sur l'enregistrement courant, réduisant ainsi les risques d'ambiguïté dans la formule.
- ThisRecord est très utile dans les formules dynamiques sans noms définis : Dans des contextes anonymes, par exemple lors de l'utilisation de
With, ThisRecord donne un accès clair aux données sans avoir besoin d'attribuer un nom de variable, ce qui allège la syntaxe.
- Elle est indispensable dans les tables générées à la volée : Lorsqu'on manipule des structures non typées ou des tables
JSON transformées, ThisRecord permet d'extraire des valeurs de champs même si les noms ou la structure
ne sont pas connus à l'avance.
- Son utilisation est cohérente avec la logique orientée objet : Le mot clef ThisRecord fonctionne un peu comme le mot clef this dans d'autres
langages de programmation, ce qui renforce la logique intuitive pour les développeurs venant d'autres environnements comme
C#, Java ou JavaScript.
Dernière mise à jour : Jeudi, le 1 Mai 2025