Power Query – Automation and Parameters: Difference between revisions

From Training Material
Jump to navigation Jump to search
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 2: Line 2:


== Objective ==
== Objective ==
Use parameters to automate queries and build dynamic data loading processes.
Use parameters to automate queries and build dynamic, reusable data loading processes in Power Query.


== Files Used ==
== Files Used ==
Line 8: Line 8:


== Creating a Parameter ==
== Creating a Parameter ==
'''Goal:''' Create a user-defined value that can be reused throughout queries.
'''Steps:'''
'''Steps:'''
# In Power Query Editor → '''Home''' tab → '''Manage Parameters''' → '''New Parameter'''
# Open Power Query Editor
# Fill in:
# In the ribbon go to the '''Home''' tab → click '''Manage Parameters''' → select '''New Parameter'''
#* '''Name''': e.g. `TargetCurrency`
# In the New Parameter dialog:
#* '''Type''': Text
#* Name: `TargetCurrency`
#* '''Current Value''': e.g. `EUR`
#* Description: (optional)
#* Required: Checked
#* Type: '''Text'''
#* Suggested Values: Any value
#* Current Value: `EUR` (or any other currency from the dataset)
# Click '''OK'''
# Click '''OK'''


== Using a Parameter in Filtering ==
== Using a Parameter in Filtering ==
'''Goal:''' Allow the user to control the filtered currency by typing a value directly in an Excel cell.
'''Steps:'''
'''Steps:'''
# Load '''ExchangeRates.xlsx''' into Power Query
# In Excel:
# Select the column '''Currency'''
#* Type a value like `USD` in cell `A2`
# Go to '''Home''' tab → '''Keep Rows''' → '''Keep Rows Where...'''
#* In cell `A1`, enter the header name: `Currency`
# Set: ''Currency'' equals ''Parameter'' → choose `TargetCurrency`
#* Select cells `A1:A2` and press '''Ctrl+T''' to create a table
#* Name the table (e.g. `ParameterTable`) via the '''Table Design''' tab
# Go to the '''Data''' tab → click '''Get Data''' → '''From Table/Range'''
# In Power Query Editor:
#* Ensure the table has one column (e.g. `Currency`) and one row (e.g. `USD`)
#* Right-click on the `USD` value → select '''Drill Down'''
# This will create a query returning just the single value
# Click '''Home → Close & Load To...''' → choose '''Only Create Connection'''
# Rename the query to: `CurrencyParameter`
 
# Next, load the main dataset (e.g. ExchangeRates.xlsx)
# In Power Query Editor:
#* Select the `Currency` column
#* Click the filter icon select a sample value like `USD`
#* In the formula bar, replace the hardcoded value with your parameter query


== Using Parameters in M Code ==
'''Example:'''
You can reference parameters directly in formulas:
Replace:


<syntaxhighlight lang="m">
= Table.SelectRows(Source, each [Currency] = "USD")
= Table.SelectRows(Source, each [Currency] = TargetCurrency)
 
</syntaxhighlight>
 
With:
 
= Table.SelectRows(Source, each [Currency] = CurrencyParameter)
 
# Click '''Close & Load''' to return the filtered data to Excel
 
'''Result:'''
Whenever the value in the Excel cell is changed (e.g. from `USD` to `EUR`), clicking **Refresh All** will automatically update the result.


== Parameter for File Path ==
== Parameter for File Path ==
'''Scenario:''' Create a reusable query for loading Excel files.
'''Scenario:''' Allow the user to select the file path dynamically instead of hardcoding it.


'''Steps:'''
'''Steps:'''
# Create a parameter `FilePath` (Type: Text)
# In Power Query Editor → go to '''Home''' tab → click '''Manage Parameters''' → select '''New Parameter'''
# Go to '''Home''' tab → '''New Source''' → '''Excel Workbook'''
# In the New Parameter dialog:
# In file path dialog, paste the value from the parameter
#* Name: `FilePath`
# Or: go to Advanced Editor and replace path with `FilePath`
#* Type: Text
#* Current Value: Paste the full path to an Excel file (e.g. C:\\Data\\Sales_Q1.xlsx)
# Click '''OK'''
# Then, to load the file using this path:
# Go to '''Home''' tab → click '''New Source''' → choose '''Excel Workbook'''
# When prompted for the file path:
#* Instead of browsing, paste the value from the `FilePath` parameter directly
# OR: go to '''Advanced Editor''' and replace the hardcoded path:
 
= Excel.Workbook(File.Contents(FilePath), null, true)


== Automating Folder Imports ==
== Automating Folder Imports ==
'''Goal:''' Use folder-based queries to dynamically import and combine files.
'''Steps:'''
'''Steps:'''
# Go to '''Data''' tab → '''Get Data''' → '''From File''' → '''From Folder'''
# In Excel → go to the '''Data''' tab → click '''Get Data''' → '''From File''' → '''From Folder'''
# Select a folder (e.g. with sales data)
# In the folder selection dialog → paste or browse to a folder with multiple Excel/CSV files
# Click '''Transform Data'''
# Click '''OK''' and then '''Transform Data'''
# In Power Query Editor, click '''Combine''' → '''Combine & Transform Data'''
# In Power Query Editor → you’ll see a table with metadata for each file
# Use a parameter for folder path if needed
# Click the button in the '''Content''' column → select '''Combine''' → choose '''Combine & Transform Data'''
# Power Query creates a function and imports a sample file structure


== Additional Exercise: Parameterized Currency Filter ==
'''Optional: Use parameter for folder path'''
'''Goal:''' Build a flexible report that shows exchange rates for one currency.
# Create a parameter named `FolderPath` (type: Text)
# In the source step → click the gear icon on '''Source''' in the Applied Steps
# Replace the folder path with `FolderPath`
# OR go to Advanced Editor and replace:


'''Steps:'''
= Folder.Files(FolderPath)
# Load '''ExchangeRates.xlsx'''
# Create a `TargetCurrency` parameter (e.g. "USD")
# Use it to filter the rows
# Load the result into a worksheet


== Extension: Combine Parameters and Folder Query ==
'''Goal:''' Allow the user to set a folder path dynamically.


'''Steps:'''
# Create parameter `FolderPath`
# Use it in '''From Folder''' source
# Refresh the query after changing parameter value
# Load combined data to Excel sheet


----
----

Latest revision as of 12:44, 22 June 2025

Module 4: Automation and Parameters

Objective

Use parameters to automate queries and build dynamic, reusable data loading processes in Power Query.

Files Used

Creating a Parameter

Goal: Create a user-defined value that can be reused throughout queries.

Steps:

  1. Open Power Query Editor
  2. In the ribbon → go to the Home tab → click Manage Parameters → select New Parameter
  3. In the New Parameter dialog:
    • Name: `TargetCurrency`
    • Description: (optional)
    • Required: Checked
    • Type: Text
    • Suggested Values: Any value
    • Current Value: `EUR` (or any other currency from the dataset)
  4. Click OK

Using a Parameter in Filtering

Goal: Allow the user to control the filtered currency by typing a value directly in an Excel cell.

Steps:

  1. In Excel:
    • Type a value like `USD` in cell `A2`
    • In cell `A1`, enter the header name: `Currency`
    • Select cells `A1:A2` and press Ctrl+T to create a table
    • Name the table (e.g. `ParameterTable`) via the Table Design tab
  2. Go to the Data tab → click Get DataFrom Table/Range
  3. In Power Query Editor:
    • Ensure the table has one column (e.g. `Currency`) and one row (e.g. `USD`)
    • Right-click on the `USD` value → select Drill Down
  4. This will create a query returning just the single value
  5. Click Home → Close & Load To... → choose Only Create Connection
  6. Rename the query to: `CurrencyParameter`
  1. Next, load the main dataset (e.g. ExchangeRates.xlsx)
  2. In Power Query Editor:
    • Select the `Currency` column
    • Click the filter icon → select a sample value like `USD`
    • In the formula bar, replace the hardcoded value with your parameter query

Example: Replace:

= Table.SelectRows(Source, each [Currency] = "USD")


With:

= Table.SelectRows(Source, each [Currency] = CurrencyParameter)
  1. Click Close & Load to return the filtered data to Excel

Result: Whenever the value in the Excel cell is changed (e.g. from `USD` to `EUR`), clicking **Refresh All** will automatically update the result.

Parameter for File Path

Scenario: Allow the user to select the file path dynamically instead of hardcoding it.

Steps:

  1. In Power Query Editor → go to Home tab → click Manage Parameters → select New Parameter
  2. In the New Parameter dialog:
    • Name: `FilePath`
    • Type: Text
    • Current Value: Paste the full path to an Excel file (e.g. C:\\Data\\Sales_Q1.xlsx)
  3. Click OK
  4. Then, to load the file using this path:
  5. Go to Home tab → click New Source → choose Excel Workbook
  6. When prompted for the file path:
    • Instead of browsing, paste the value from the `FilePath` parameter directly
  7. OR: go to Advanced Editor and replace the hardcoded path:
= Excel.Workbook(File.Contents(FilePath), null, true)

Automating Folder Imports

Goal: Use folder-based queries to dynamically import and combine files.

Steps:

  1. In Excel → go to the Data tab → click Get DataFrom FileFrom Folder
  2. In the folder selection dialog → paste or browse to a folder with multiple Excel/CSV files
  3. Click OK and then Transform Data
  4. In Power Query Editor → you’ll see a table with metadata for each file
  5. Click the button in the Content column → select Combine → choose Combine & Transform Data
  6. Power Query creates a function and imports a sample file structure

Optional: Use parameter for folder path

  1. Create a parameter named `FolderPath` (type: Text)
  2. In the source step → click the gear icon on Source in the Applied Steps
  3. Replace the folder path with `FolderPath`
  4. OR go to Advanced Editor and replace:
= Folder.Files(FolderPath)



→ Continue to Module 5: Power Pivot Overview

Return to Main Page