Créer et appeler une fonction personnalisée

Une fonction personnalisée utilise le langage de formule M, prend un ensemble de valeurs d’entrée, puis renvoie une valeur de sortie unique. Si vous avez la logique que vous souhaitez réutiliser plusieurs fois ou appliquer le même jeu de transformations à une autre requête ou valeur, envisagez de créer une fonction personnalisée, puis d’appeler 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 commencer à zéro.
• Utilisez la commande Appeler une fonction personnalisée .
• Il existe d’autres façons de créer des fonctions qui ne sont pas abordées dans cette rubrique d’aide, notamment les commandes Créer une fonction et Ajouter comme requête . Pour plus d’informations, voir Présentation des fonctions Power Query M (docs.com) et Utilisation des fonctions personnalisées (docs.com).

Créer et appeler une fonction personnalisée simple avec l’Éditeur avancé

L’exemple suivant illustre une fonction personnalisée qui s’inscrit dans une tradition de programmation de longue date.

1. Pour créer une requête vide :

   Excel Sélectionner des données>Obtenir des données>à partir 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.

2. Dans le volet Requêtes à gauche, double-cliquez sur le nom, puis renommez la nouvelle requête vide en « HelloWorld ».

3. Sélectionnez la nouvelle requête, puis sélectionnez Accueil> :Éditeur avancé.

4. Remplacez le code de démarrage du modèle par le code suivant :
   let
     HelloWorld = () => ("Hello World")
in
     HelloWorld

5. Sélectionnez Terminé.

6. Vous avez remplacé la requête « HelloWorld » par une fonction personnalisée. Notez l’icône de fonction à gauche de celle-ci.

7. Pour appeler la fonction, sélectionnez-la, puis sélectionnez Appeler dans l’aperçu des données.

   

8. 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 dont le nom par défaut est Invoked Function. Vous souhaiterez peut-être le renommer en quelque chose de plus significatif, tel que « HelloWorldResult ».

9. Sélectionnez cette requête, puis sélectionnez Accueil>Fermer & charger pour afficher les résultats dans une feuille de calcul.

Résultats

Créer et appeler une fonction personnalisée avec un paramètre avec l’Éditeur avancé

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

1. Pour créer une requête vide :

   Excel Sélectionner des données>Obtenir des données>à partir 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.

2. Dans le volet Requêtes à gauche, renommez la nouvelle requête vide en « MyHex ».

3. Sélectionnez la nouvelle requête, puis sélectionnez Accueil> :Éditeur avancé.

4. Remplacez le code de démarrage du modèle par le code suivant :
   let
     MyHex = (parameter1) => Number.ToText(parameter1,"X")
in
     MyHex

5. Sélectionnez Terminé.

6. Vous avez remplacé la requête « MyHex » par une fonction personnalisée. Notez l’icône de fonction à gauche de celle-ci.

7. 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.
   

8. 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 invoquée. Vous souhaiterez peut-être le renommer en quelque chose de plus significatif, tel que « MyHexResult ».

9. Sélectionnez cette requête, puis sélectionnez Accueil>Fermer & charger pour afficher les résultats dans une feuille de calcul.

Résultats

Ajouter une colonne en appelant une fonction personnalisée

Si vous avez créé une fonction avec au moins un paramètre, vous pouvez l’invoquer en tant que fonction personnalisée pour créer une colonne et une nouvelle valeur pour chaque ligne d’un tableau.

1. Pour ouvrir une requête, localisez-en une précédemment chargée à partir de l’Éditeur Power Query, sélectionnez une cellule dans les données, puis sélectionnezModification de la requête>. Pour plus d’informations, voir Créer, modifier et charger une requête dans Excel (Power Query).

   Remarque Pour cet exemple, votre requête nécessite au moins une colonne de type Nombre entier .

2. Créez la fonction personnalisée « MyHex » comme expliqué dans la section, Créer et appeler une fonction personnalisée qui a un paramètre avec l’Éditeur avancé.

3. Dans la requête, sélectionnez Ajouter une colonne>Appeler une fonction personnalisée. La boîte de dialogue Appeler une fonction personnalisée s’affiche.

4. Entrez le nom de la nouvelle colonne, par exemple « HexConvert », dans la zone Nom de la nouvelle colonne .

5. Sélectionnez le nom d’une fonction personnalisée prédéfinie dans la liste déroulante de la requête Fonction. Dans cet exemple, sélectionnez « MyHex ».

6. Étant donné que la fonction personnalisée référence un paramètre, le paramètre est maintenant affiché.

7. Sélectionnez une colonne de type de données Nombre entier en tant que paramètre de la fonction.

   

8. Sélectionnez OK.

Résultat

Une nouvelle colonne est créée pour afficher la valeur hexadécimale de la colonne Nombre entier que vous avez entrée en tant que paramètre.

Voir aussi

Aide Power Query pour Excel

Créer des formules Power Query dans Excel

Créer une requête Paramètre

Gérer les requêtes

Présentation des fonctions Power Query M (docs.com)

Utilisation des fonctions personnalisées (docs.com)