Utilisation des paramètres

Un paramètre sert de moyen de stocker et de gérer facilement une valeur qui peut être réutilisée.

Les paramètres vous donnent la possibilité de modifier dynamiquement la sortie de vos requêtes en fonction de leur valeur et peuvent être utilisés pour :

• Modification des valeurs d’argument pour des transformations et des fonctions de source de données particulières.
• Entrées dans les fonctions personnalisées.

Vous pouvez facilement gérer vos paramètres dans la fenêtre Gérer les paramètres . Pour accéder à la fenêtre Gérer les paramètres, sélectionnez l’option Gérer les paramètres dans l’onglet Accueil.

Création d’un paramètre

Power Query offre deux façons simples de créer des paramètres :

• À partir d’une requête existante : cliquez avec le bouton droit sur une requête dont la valeur est une constante non structurée simple, telle qu’une date, un texte ou un nombre, puis sélectionnez Convertir en paramètre.

  

  Vous pouvez également convertir un paramètre en requête en cliquant avec le bouton droit sur le paramètre, puis en sélectionnant Convertir en requête.

  

• À l’aide de la fenêtre Gérer les paramètres : sélectionnez l’option Nouveau paramètre dans le menu déroulant gérer les paramètres sous l’onglet Accueil . Vous pouvez également lancer la fenêtre Gérer les paramètres et sélectionner Nouveau en haut pour créer un paramètre. Renseignez ce formulaire, puis sélectionnez OK pour créer un paramètre.

  

Après avoir créé le paramètre, vous pouvez toujours revenir à la fenêtre Gérer les paramètres pour modifier l’un de vos paramètres à tout moment.

Propriétés du paramètre

Un paramètre stocke une valeur qui peut être utilisée pour les transformations dans Power Query. Outre le nom du paramètre et la valeur qu’il stocke, il possède également d’autres propriétés qui fournissent des métadonnées. Les propriétés d’un paramètre sont les suivantes :

• Nom : indiquez un nom pour ce paramètre qui vous permet de le reconnaître et de le différencier facilement des autres paramètres que vous pouvez créer.

• Description : la description s’affiche en regard du nom du paramètre lorsque des informations de paramètre sont affichées, ce qui permet aux utilisateurs qui spécifient la valeur du paramètre de comprendre son objectif et sa sémantique.

• Obligatoire : la case à cocher indique si les utilisateurs suivants peuvent spécifier si une valeur pour le paramètre doit être fournie.

• Type : spécifie le type de données du paramètre. Nous vous recommandons de toujours configurer le type de données de votre paramètre. Pour en savoir plus sur l’importance des types de données, accédez aux types de données.

• Valeurs suggérées : fournit à l’utilisateur des suggestions pour sélectionner une valeur pour la valeur actuelle dans les options disponibles :

  • N’importe quelle valeur : la valeur actuelle peut être n’importe quelle valeur entrée manuellement.

  • Liste des valeurs : fournit une expérience simple de type table afin de définir une liste de valeurs suggérées que vous pouvez sélectionner ultérieurement pour la valeur actuelle. Lorsque cette option est sélectionnée, une nouvelle option appelée Valeur par défaut est mise à disposition. À partir de là, vous pouvez sélectionner la valeur par défaut de ce paramètre, qui est la valeur par défaut affichée à l’utilisateur lors du référencement du paramètre. Cette valeur n’est pas la même que la valeur actuelle, qui est la valeur stockée à l’intérieur du paramètre et peut être passée en tant qu’argument dans les transformations. L’utilisation de la liste des valeurs fournit un menu déroulant affiché dans les champs Valeur par défaut et Valeur actuelle , où vous pouvez choisir l’une des valeurs dans la liste suggérée de valeurs.

    

    Note

    Vous pouvez toujours taper manuellement n’importe quelle valeur que vous souhaitez transmettre au paramètre. La liste des valeurs suggérées sert uniquement de suggestions simples.

  • Requête : utilise une requête de liste (requête dont la sortie est une liste) pour fournir la liste des valeurs suggérées que vous pouvez sélectionner ultérieurement pour la valeur actuelle.

    

• Valeur actuelle : valeur stockée dans ce paramètre.

Où utiliser des paramètres

Un paramètre peut être utilisé de plusieurs façons différentes, mais plus couramment utilisé dans deux scénarios :

• Argument d’étape : vous pouvez utiliser un paramètre comme argument de plusieurs transformations pilotées à partir de l’interface utilisateur (UI).
• Argument de fonction personnalisée : vous pouvez créer une fonction à partir d’une requête et de paramètres de référence en tant qu’arguments de votre fonction personnalisée.

Les sections suivantes contiennent des exemples pour ces deux scénarios.

Argument d’étape

Pour activer cette fonctionnalité, accédez d’abord à l’onglet Affichage dans l’éditeur Power Query et sélectionnez l’option Always Allow dans le groupe Paramètres .

Par exemple, le tableau Orders suivant contient les champs OrderID, Total Units et Margin .

Dans cet exemple, créez un paramètre avec le nom Minimum Margin avec un type nombre décimal et une valeur actuelle de 0,2.

Accédez à la requête Commandes, puis, dans le champ Marge, sélectionnez l’option de filtre 'Supérieur à'.

Dans la fenêtre Filtrer les lignes , il existe un bouton avec un type de données pour le champ sélectionné. Sélectionnez l’option Paramètre dans le menu déroulant de ce bouton. Dans la sélection du champ en regard du bouton de type de données, sélectionnez le paramètre que vous souhaitez transmettre à cet argument. Dans ce cas, il s’agit du paramètre Marge minimale .

Une fois que vous avez sélectionné OK, votre table est filtrée à l’aide de la valeur actuelle pour votre paramètre.

Si vous modifiez la valeur actuelle de votre paramètre Marge minimale à 0.3, votre requête commandes est mise à jour immédiatement et affiche uniquement les lignes où la marge est supérieure à 30%.

Conseil / Astuce

De nombreuses transformations dans Power Query vous permettent de sélectionner votre paramètre dans une liste déroulante. Nous vous recommandons de toujours rechercher ces opportunités et de tirer parti de ce que les paramètres peuvent vous offrir.

Argument de fonction personnalisé

Avec Power Query, vous pouvez créer une fonction personnalisée à partir d’une requête existante avec une sélection simple. Après l’exemple précédent, cliquez avec le bouton droit sur la requête Commandes et sélectionnez Créer une fonction. Cette action lance une nouvelle fenêtre Créer une fonction . Dans cette fenêtre, nommez votre nouvelle fonction et indique les paramètres référencés dans votre requête. Ces paramètres sont utilisés comme paramètres pour la fonction personnalisée.

Vous pouvez nommer cette nouvelle fonction comme vous le souhaitez. À des fins de démonstration, le nom de cette nouvelle fonction est MyFunction. Une fois que vous avez sélectionné OK, un nouveau groupe est créé dans le volet Requêtes à l’aide du nom de votre nouvelle fonction. Dans ce groupe, vous trouvez les paramètres utilisés pour la fonction, la requête utilisée pour créer la fonction et la fonction elle-même.

Pour tester cette nouvelle fonction, entrez une valeur, telle que 0.4, dans le champ sous l’étiquette Marge minimale . Sélectionnez ensuite le bouton Appeler . Cette action crée une requête portant le nom Fonction invoquée, en passant la valeur 0,4 comme argument de la fonction et en vous donnant uniquement les lignes où la marge est supérieure à 40%.

Pour en savoir plus sur la création de fonctions personnalisées, accédez à Création d’une fonction personnalisée.

Paramètres de liste ou de valeurs multiples

Un nouveau type de paramètre disponible uniquement dans Power Query Online est des paramètres à valeurs multiples ou de liste. Cette section explique comment créer un paramètre de liste et comment l’utiliser dans vos requêtes.

À la suite de l’exemple précédent, modifiez la valeur actuelle de la marge minimale de 0,3 à 0.1. Le nouvel objectif est de créer un paramètre de liste qui peut contenir les numéros de commande des commandes qui vous intéressent à l’analyse. Pour créer le nouveau paramètre, accédez à la boîte de dialogue Gérer les paramètres et sélectionnez Nouveau pour créer un paramètre. Renseignez ce nouveau paramètre avec les informations suivantes :

• Nom: Commandes intéressantes
• Description: Ensemble de numéros de commande intéressants pour une analyse spécifique
• Obligatoire: Vrai
• Type: Liste

Après avoir défini ces champs, une nouvelle grille s’affiche où vous pouvez entrer les valeurs que vous souhaitez stocker pour votre paramètre. Dans ce cas, ces valeurs sont 125, 777 et 999.

Note

Bien que cet exemple utilise des nombres, vous pouvez également stocker d’autres types de données dans votre liste, tels que du texte, des dates, des date-heure et plus encore. Plus d’informations : Types de données dans Power Query

Conseil / Astuce

Si vous souhaitez avoir plus de contrôle sur les valeurs utilisées dans votre paramètre de liste, vous pouvez toujours créer une liste avec des valeurs constantes. Ensuite, convertissez votre requête de liste en paramètre comme indiqué précédemment dans cet article.

Avec les nouveaux paramètres de liste Commandes intéressantes en place, revenez à la requête Commandes . Sélectionnez le menu filtre automatique du champ OrderID . Sélectionnez Filtres de nombre>dans.

Conseil / Astuce

Pour certains des autres types de données, le filtre In peut ne pas apparaître dans le menu de filtre principal. Sélectionnez une autre option de filtre, puis modifiez le filtre sous Paramètres de requête. Ensuite, dans la liste déroulante de filtre dans l’éditeur, sélectionnez In.

Une fois cette option sélectionnée, une nouvelle boîte de dialogue Filtrer les lignes s’affiche. À partir de là, vous pouvez sélectionner le paramètre de liste dans un menu déroulant.

Note

Les paramètres de liste peuvent fonctionner avec les options In ou Not in . In vous permet de filtrer uniquement par les valeurs de votre liste. Pas dans fait exactement l'inverse, et tente d'exclure votre colonne pour obtenir toutes les valeurs différentes de celles stockées dans votre paramètre.

Après avoir sélectionné OK, vous revenez à votre requête. Là, votre requête est filtrée à l’aide du paramètre de liste que vous avez créé, avec le résultat que seules les lignes où orderID était égal à 125, 777 ou 999 ont été conservées.