Créer et appeler une fonction personnalisée

Une fonction personnalisée utilise le langage de formule M, utilise un ensemble de valeurs d’entrée, puis renvoie une valeur de sortie unique. Si vous avez une logique que vous souhaitez réutiliser de nombreuses fois ou appliquer le même ensemble de transformations à une autre requête ou valeur, envisagez de créer une fonction personnalisée, puis d’invoquer la fonction où et quand vous en avez besoin. Il existe plusieurs façons de créer une fonction personnalisée :

Utilisez l’Éditeur avancé pour ajouter votre propre instruction let et démarrer à partir de rien.
Utilisez la commande Fonction personnalisée Invoke.
Il existe d’autres façons de créer des fonctions non abordées dans cette rubrique d’aide, notamment les commandes Créer une fonction et Ajouter en tant que requête. Pour une discussion approfondie, voir Présentation des fonctions M de Power Query (docs.com)et Utilisation de fonctions personnalisées (docs.com).

L’exemple suivant est un exemple simple d’une fonction personnalisée qui suit une programmation de longue date.

Pour créer une requête vide : sélectionnez Excel données> obtenir des données > d’autres sources > requête vide.Power Query Cliquez avec le bouton droit sur un emplacement vide dans le volet Requêtes à gauche, puis sélectionnez Nouvelle requête > autres sources > requête vide.
Dans le volet Requêtes à gauche, double-cliquez sur le nom, puis renommez la nouvelle requête vierge « HelloWorld ».
Sélectionnez la nouvelle requête, puis sélectionnez Accueil> Éditeur avancé.
Remplacez le code de démarrage du modèle par le code suivant :

let HelloWorld = () => ("Hello World") in HelloWorld
Sélectionnez Terminé.
Vous avez changé la requête « HelloWorld » en fonction d’une fonction personnalisée. Notez l’icône fonction à gauche.
Pour appeler la fonction, sélectionnez-la, puis sélectionnez Invoke dans Aperçu des données.
Les résultats de la fonction sont affichés dans Aperçu des données et ajoutés au volet Requêtes en tant que requête avec le nom par défaut, Fonction Invoked. Vous souhaitez peut-être le renommer en un nom plus significatif, tel que « HelloWorldResult ».
Sélectionnez cette requête, puis sélectionnez Accueil> fermer & chargement pour voir les résultats dans une feuille de calcul.

Résultats

Résultats de HelloWorld dans une feuille de calcul

L’exemple suivant montre comment transmettre un paramètre à une fonction personnalisée pour convertir un nombre décimal en nombre hexadécimal.

Pour créer une requête vide : sélectionnez Excel données> obtenir des données > d’autres sources > requête vide.Power Query Cliquez avec le bouton droit sur un emplacement vide dans le volet Requêtes à gauche, puis sélectionnez Nouvelle requête > autres sources > requête vide.
Dans le volet Requêtes à gauche, renommer la nouvelle requête vide « MyHex ».
Sélectionnez la nouvelle requête, puis sélectionnez Accueil> Éditeur avancé.
Remplacez le code de démarrage du modèle par le code suivant :

let MyHex = (parameter1) => Number.ToText(parameter1,"X") in MyHex
Sélectionnez Terminé.
Vous avez changé la requête « MyHex » en fonction d’une fonction personnalisée. Notez l’icône fonction à gauche.
Pour appeler la fonction, sélectionnez-la, puis dans Aperçu des données, entrez un nombre dans la zone paramètre1, puis sélectionnez Appeler.
Les résultats de la fonction sont affichés dans Aperçu des données et ajoutés au volet Requêtes en tant que requête avec le nom par défaut, Fonction Invoked. Vous souhaitez peut-être le renommer en un nom plus significatif, tel que « MyHexResult ».
Sélectionnez cette requête, puis sélectionnez Accueil> fermer & chargement pour voir les résultats dans une feuille de calcul.

Résultats

Résultat de la fonction MyHex dans une feuille de calcul

Si vous avez créé une fonction avec au moins un paramètre, vous pouvez l’appeler comme fonction personnalisée pour créer une colonne et une nouvelle valeur pour chaque ligne d’une table.

Pour ouvrir une requête, recherchez-en une précédemment chargée à partir de l’Éditeur Power Query, sélectionnez une cellule dans les données, puis sélectionnez Requête >Modifier. Pour plus d’informations, voir Créer, modifier et charger une requête dans Excel (Power Query).Remarque Pour cet exemple, votre requête a besoin d’au moins une colonne d’un type de données Nombre entier.
Créez la fonction personnalisée « MyHex », comme expliqué dans la section, créez et appellez une fonction personnalisée avec un paramètre avec l’Éditeur avancé.
Dans la requête, sélectionnez Ajouter une colonne > fonction personnalisée Invoke. La boîte de dialogue Fonction personnalisée Invoke s’affiche.
Entrez le nom de la nouvelle colonne, par exemple« HexConvert », dans la zone Nouveau nom de colonne.
Sélectionnez le nom d’une fonction personnalisée prédéfinie dans la partie finale de la requête Fonction. Dans cet exemple, sélectionnez « MyHex ».
Étant donné que la fonction personnalisée fait référence à un paramètre, il s’affiche désormais.
Sélectionnez une colonne d’un type de données Nombre entier en tant que paramètre de la fonction.
Sélectionnez OK.