Skip to content

Commit 3be602c

Browse files
Merge pull request MicrosoftDocs#477 from MicrosoftDocs/doug-templates
Edited and updated Power Query dataflow templates articles
2 parents b1b7121 + df5bf97 commit 3be602c

31 files changed

+251
-242
lines changed

powerquery-docs/dataflows/dataflow-power-automate-connector-templates.md

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,43 @@
11
---
2-
title: Power Automate Templates for the Dataflows Connector
2+
title: Power Automate templates for the dataflows connector
33
description: Introduction to Power Automate templates for the dataflows connector.
44
author: miquelladeboer
55

66
ms.service: powerquery
77
ms.reviewer: kvivek
88
ms.topic: conceptual
9-
ms.date: 12/15/2020
9+
ms.date: 11/16/2021
1010
ms.author: mideboer
1111
ms.custom: intro-internal
1212
---
13-
# Power Automate Templates for the Dataflows Connector
13+
# Power Automate templates for the dataflows connector
1414

1515
The dataflows Power Automate connector can:
16-
* trigger a flow when a dataflow refresh completes, or
17-
* take action to initiate a dataflow refresh.
1816

19-
In this article, we discuss some use cases with provided tutorials to help you quickstart the use of this connector:
17+
* Trigger a flow when a dataflow refresh completes.
18+
* Take action to start a dataflow refresh.
19+
20+
This section discusses some use cases with provided tutorials to help you quickstart the use of this connector:
2021

2122
[Send notifications](send-notification-when-dataflow-refresh-completes.md):
23+
2224
* When a dataflow refresh status changes, send an email notification.
2325
* When a dataflow succeeds or fails, send an email notification.
2426
* When a dataflow refresh status changes, send a Teams notification.
2527

2628
[Open support tickets](open-support-ticket-when-dataflow-refresh-completes.md):
27-
* When a dataflow refresh fails, send a message to Azure Service Bus queue to open a support ticket.
29+
30+
* When a dataflow refresh fails, send a message to Azure Service Bus queue to open a support ticket.
2831

2932
[Refresh dataflows and datasets sequentially](trigger-dataflows-and-power-bi-dataset-sequentially.md):
30-
* When you click on a button, initiate a dataflow refresh.
31-
* When an analytical dataflow refresh succeeds, initiate a standard dataflow refresh.
32-
* When a dataflow refresh succeeds, initiate a Power BI dataset refresh.
33-
* When a file in SharePoint is updated, initiate a dataflow refresh.
33+
34+
* When you select a button, start a dataflow refresh.
35+
* When an analytical dataflow refresh succeeds, start a standard dataflow refresh.
36+
* When a dataflow refresh succeeds, start a Power BI dataset refresh.
37+
* When a file in SharePoint is updated, start a dataflow refresh.
3438

3539
Save dataflow refresh metadata and build a dataflows monitoring dashboard:
40+
3641
* [When a dataflow refresh completes, save metadata to a Dataverse table](load-dataflow-metadata-into-dataverse-table.md)
3742
* [When a dataflow refresh completes, save metadata to Excel online](load-dataflow-metadata-into-excel-online.md)
3843
* [When a dataflow refresh completes, save metadata to a Power BI streaming dataset](load-dataflow-metadata-into-power-bi-dataset.md)
39-
40-
![example of dataflow monitoring dashboard.](media/dashboard.PNG)
Lines changed: 53 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,33 @@
11
---
2-
title: Load data into a Dataverse table and build a dataflows monitoring report with Power BI
2+
title: Load data in a Dataverse table and build a dataflows monitoring report with Power BI
33
description: How to use the dataflows connector in Power Automate to create a dataflows monitoring report with Power BI
44
author: miquelladeboer
55

66
ms.service: powerquery
77
ms.reviewer: kvivek
88
ms.topic: conceptual
9-
ms.date: 12/15/2020
9+
ms.date: 11/12/2021
1010
ms.author: mideboer
1111
---
12-
# Load Data into a Dataverse table and Build a Dataflows Monitoring Report with Power BI
12+
# Load data in a Dataverse table and build a dataflows monitoring report with Power BI
1313

14-
## Introduction
14+
This tutorial demonstrates how to load data in a Dataverse table to create a dataflows monitoring report in Power BI.
1515

16-
In this step-by-step tutorial, we will show you how to set up your own monitoring dashboard for all of your dataflows:
16+
![Image of an example Power BI data monitoring dashboard.](media/dashboard.PNG)
1717

18-
![example of monitoring dashboard.](media/dashboard.PNG)
18+
You can use this dashboard to monitor your dataflows' refresh duration and failure count. With this dashboard, you can track any issues with your dataflows performance and share the data with others.
1919

20-
You can use this dashboard to monitor your dataflows' refresh duration and failure count. With this dashboard, you can track any issues with your dataflows performance and share the data with others.
20+
First, you'll create a new Dataverse table that stores all the metadata from the dataflow run. For every refresh of a dataflow, a record is added to this table. You can also store metadata for multiple dataflow runs in the same table. After the table is created, you'll connect the Power BI file to the Dataverse table.
2121

22-
First, you will create a new Dataverse table which stores all the metadata from the dataflow run. For every refresh of a dataflow, a record is added to this table. You can also store metadata for multiple dataflows runs in the same table. After the table is created, you will connect the Power BI file to the Dataverse table.
23-
24-
![dataverse tutorial overview.](media/dataverse.PNG)
22+
![Dataverse tutorial overview.](media/dataverse.PNG)
2523

2624
## Prerequisites
25+
2726
* [Power BI Desktop](https://www.microsoft.com/download/details.aspx?id=58494).
2827

2928
* A [Dataverse environment](/powerapps/maker/common-data-service/data-platform-intro) with permissions to create new custom tables.
3029

31-
* A [Premium Power Automate Licence](/power-platform/admin/pricing-billing-skus).
30+
* A [Premium Power Automate License](/power-platform/admin/pricing-billing-skus).
3231

3332
* A [Power BI dataflow](/power-bi/transform-model/dataflows/dataflows-introduction-self-service) or [Power Platform dataflow](/powerapps/maker/common-data-service/create-and-use-dataflows).
3433

@@ -38,67 +37,68 @@ First, download the Dataverse [.pbit file](https://download.microsoft.com/downlo
3837

3938
## Create a new table in Dataverse
4039

41-
* Navigate to the [Power Apps portal](https://powerapps.microsoft.com/).
40+
1. Navigate to the [Power Apps portal](https://powerapps.microsoft.com/).
41+
42+
2. On the left navigation pane expand **Data**, select **Tables**, and then select **New table**.
4243

43-
* Follow these [instructions](/powerapps/maker/common-data-service/create-custom-entity) to create a new table.
44+
[![Image with the new table dialog opened.](media/new-table-dialog.png)](media/new-table-dialog.png#lightbox)
4445

45-
* In the right pane, enter the following values, and then select `Create`
46-
* **Display name**: "Dataflow Name"
47-
* **Data type**: Text
48-
* **Required**: Checked
46+
3. In the **New table** pane:
47+
1. Enter **Dataflows Monitoring** in **Display name**.
48+
1. Under **Primary Name Column**, enter **Dataflow name** in **Display name**.
49+
1. Select **Create**.
4950

50-
* Repeat adding column for the following values
51-
* **Display name**: "Refresh Status", **Data type**: Text, **Required**: Checked.
52-
* **Display name**: "Refresh Type", **Data type**: Text, **Required**: Checked.
53-
* **Display name**: "Start Time", **Data type**: Date and Time, **Required**: Checked.
54-
* **Display name**: "End Time", **Data type**: Date and Time, **Required**: Checked.
51+
4. Select **Add column** to repeat adding columns for the following values:
52+
53+
* **Display name**: "Refresh Status", **Data type**: Text, **Required**: Required.
54+
* **Display name**: "Refresh Type", **Data type**: Text, **Required**: Required.
55+
* **Display name**: "Start Time", **Data type**: Date and Time, **Required**: Required.
56+
* **Display name**: "End Time", **Data type**: Date and Time, **Required**: Required.
57+
58+
[![Image with the new column dialog opened.](media/new-column-dialog.png)](media/new-column-dialog.png#lightbox)
5559

5660
## Create a dataflow
5761

58-
If you do not already have one, create a dataflow. This can be done in either [Power BI dataflows](/power-bi/transform-model/dataflows/dataflows-introduction-self-service) or [Power Apps dataflows](/powerapps/maker/common-data-service/create-and-use-dataflows).
62+
If you don't already have one, create a dataflow. You can create a dataflow in either [Power BI dataflows](/power-bi/transform-model/dataflows/dataflows-introduction-self-service) or [Power Apps dataflows](/powerapps/maker/common-data-service/create-and-use-dataflows).
5963

60-
## Create a Power Automate Flow
64+
## Create a Power Automate flow
6165

62-
* Navigate to [Power Automate](https://flow.microsoft.com).
63-
* Create a new **automated cloud flow**
66+
1. Navigate to [Power Automate](https://flow.microsoft.com).
67+
2. Select **Create** > **Automated cloud flow**.
68+
3. Enter a flow name, and then search for the "When a dataflow refresh completes" connector. Select this connector from the list, and then select **Create**.
69+
4. Customize the connector. Enter the following information on your dataflow:
6470

65-
* Search for the connector "When a dataflow refresh completes (preview)". If you encounter difficulty, see these [instructions](/power-automate/get-started-logic-flow).
66-
* Customize the connector. You need to enter information on your dataflow:
67-
* **Group Type**: Select *Environment* when connecting to Power Apps and *Workspace* when connecting to Power BI.
68-
* **Group**: Select the Power Apps environment or the Power BI workspace your dataflow is in.
69-
* **Dataflow**: Select your dataflow by name.
71+
* **Group Type**: Select *Environment* when connecting to Power Apps and *Workspace* when connecting to Power BI.
72+
* **Group**: Select the Power Apps environment or the Power BI workspace your dataflow is in.
73+
* **Dataflow**: Select your dataflow by name.
7074

71-
* Click on **new step** to add an action to your flow.
72-
* Search for the connector "Create a new record" form Dataverse.
73-
* Customize the connector. You need to enter information:
74-
* **Environment**: Select your Dataverse environment.
75-
* **Entity Name**: Select the entity named "Dataflows Monitoring" which you previously created.
75+
5. Select **New step** to add an action to your flow.
76+
6. Search for the "Add a new row" connector from Dataverse, and then select it.
77+
7. In **Add a new row**, select **Choose a table** and then choose **Dataflows Monitoring** from the list.
7678

79+
![Image with the dataflows monitoring fields in the add a new row dialog box.](media/table-choice.png)
7780

78-
![example of template.](media/connector.PNG)
81+
8. For every required field, you need to add a dynamic value. This value is the output of the metadata of the dataflow that's run.
82+
1. Select the field next to **Dataflow Name** and then select **Dataflow Name** from the dynamic content.
7983

80-
* Add dynamic values to the required fields.
84+
[![Image with the dataflow name dynamic content added to the dataflow name field.](media/dynamic.png)](media/dynamic.png#lightbox)
8185

82-
For every required field, you need to add a dynamic value. This value is the output of the metadata of the dataflow run.
83-
* Select the field next to **Dataflow ID** and then select the lightning button.
84-
85-
![example of lightning button.](media/dynamic.png)
86+
2. Repeat this process for all required fields.
8687

87-
* Repeat this process for all required fields.
88-
89-
![example of required fields.](media/final.PNG)
88+
![Image of the Add a new row connector with all the fields filled in with dynamic content.](media/final.PNG)
9089

91-
* Save the flow.
90+
9. Save the flow.
9291

9392
## Create a Power BI Report
9493

95-
* Open the `.pbit` file.
94+
1. Open the `.pbit` file.
95+
96+
2. Connect to your Dataverse entity **Dataflows Monitoring**.
9697

97-
* Connect to your Dataverse entity **Dataflow Monitoring**.
98+
In this dashboard, for every dataflow in your specified time interval, you can monitor:
9899

99-
In this dashboard, you can monitor, for every dataflow in your specified time interval:
100-
* the dataflow duration
101-
* the dataflow count
102-
* the dataflow failure count
100+
* The dataflow duration
101+
* The dataflow count
102+
* The dataflow failure count
103103

104-
The uniqueID for every dataflow is generated by a merge between the dataflow name and the dataflow start time.
104+
The unique ID for every dataflow is generated by a merge between the dataflow name and the dataflow start time.
Lines changed: 45 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,29 @@
11
---
2-
title: Load Data into Excel Online and build a Dataflows Monitoring Report with Power BI
3-
description: How to use and Excel file and the dataflows connector in Power Automate to create a dataflows monitoring report in Power BI
2+
title: Load data in Excel Online and build a dataflows monitoring report with Power BI
3+
description: How to use an Excel file and the dataflows connector in Power Automate to create a dataflows monitoring report in Power BI
44
author: miquelladeboer
55

66
ms.service: powerquery
77
ms.reviewer: kvivek
88
ms.topic: conceptual
9-
ms.date: 12/15/2020
9+
ms.date: 11/16/2021
1010
ms.author: mideboer
1111
---
1212

13-
# Load Data into Excel Online and Build a Dataflows Monitoring Report with Power BI
13+
# Load data in Excel Online and build a dataflows monitoring report with Power BI
1414

15-
## Introduction
15+
This tutorial demonstrates how to use an Excel file and the dataflows connector in Power Automate to create a dataflows monitoring report in Power BI.
1616

17-
In this step-by-step tutorial, we will show you how to set up your own monitoring dashboard for all of your dataflows:
17+
![Image of an example Power BI monitoring dashboard.](media/dashboard.PNG)
1818

19-
![example of monitoring dashboard.](media/dashboard.PNG)
19+
First, you'll download the Excel file and save it in OneDrive for Business or SharePoint. Next, you'll create a Power Automate connector that loads metadata from your dataflow to the Excel file in OneDrive for Business or SharePoint. Lastly, you'll connect a Power BI file to the Excel file to visualize the metadata and start monitoring the dataflows.
2020

21-
First, you will download the Excel file and save it in OneDrive for Business or SharePoint. Next, you will create a Power Automate connector which will load metadata from your dataflow into the Excel file in OneDrive for Business or SharePoint. Lastly, you will connect a Power BI file to the Excel file to visualize the metadata and start monitoring the dataflows.
22-
23-
You can use this dashboard to monitor your dataflows' refresh duration and failure count. With this dashboard, you can track any issues with your dataflows performance and share the data with others.
24-
25-
![overview of loading data through Excel.](media/excel.PNG)
21+
You can use this dashboard to monitor your dataflows' refresh duration and failure count. With this dashboard, you can track any issues with your dataflows performance and share the data with others.
2622

23+
![Image of an overview of loading data through Excel.](media/excel.PNG)
2724

2825
## Prerequisites
26+
2927
* [Microsoft Excel](https://www.microsoft.com/en/microsoft-365/excel)
3028

3129
* [Power BI Desktop](https://www.microsoft.com/download/details.aspx?id=58494).
@@ -40,59 +38,61 @@ You can use this dashboard to monitor your dataflows' refresh duration and failu
4038

4139
First, download the [.pbit file](https://download.microsoft.com/download/1/4/E/14EDED28-6C58-4055-A65C-23B4DA81C4DE/excel-template.pbit).
4240

43-
## Download the Excel file and Save to OneDrive
41+
## Download the Excel file and save to OneDrive
4442

4543
Next, download the [.xlsx file](https://download.microsoft.com/download/1/4/E/14EDED28-6C58-4055-A65C-23B4DA81C4DE/dataflow_monitoring.xlsx) and save the file to a location on OneDrive for Business or SharePoint
4644

4745
## Create a dataflow
4846

49-
If you do not already have one, create a dataflow. This can be done in either [Power BI dataflows](/power-bi/transform-model/dataflows/dataflows-introduction-self-service) or [Power Apps dataflows](/powerapps/maker/common-data-service/create-and-use-dataflows).
47+
If you don't already have one, create a dataflow. You can create a dataflow in either [Power BI dataflows](/power-bi/transform-model/dataflows/dataflows-introduction-self-service) or [Power Apps dataflows](/powerapps/maker/common-data-service/create-and-use-dataflows).
5048

51-
## Create a flow in Power Automate
49+
## Create a flow in Power Automate
5250

53-
* Navigate to [Power Automate](https://flow.microsoft.com).
51+
1. Navigate to [Power Automate](https://flow.microsoft.com).
52+
2. Select **Create** > **Automated cloud flow**.
53+
3. Enter a flow name, and then search for the "When a dataflow refresh completes" connector. Select this connector from the list, and then select **Create**.
5454

55-
* Search for the template "When a dataflow refresh completes, output status into Excel". If you encounter difficulty, see these [instructions](/power-automate/get-started-logic-template).
55+
4. Customize the connector. Enter the following information on your dataflow:
5656

57-
![example of excel template.](media/templateexcel.PNG)
57+
* **Group Type**: Select *Environment* when connecting to Power Apps and *Workspace* when connecting to Power BI.
58+
* **Group**: Select the Power Apps environment or the Power BI workspace your dataflow is in.
59+
* **Dataflow**: Select your dataflow by name.
60+
61+
5. Select **New step** to add an action to your flow.
62+
6. Search for the "Add a row into a table" connector from Excel Online (Business), and then select it.
5863

59-
* Customize the flow. Actions that require input from you will automatically be expanded.
64+
7. Customize the connector. Enter the *Location* of the Excel file and the specific *Table* the data loads to.
65+
* **Location**: Select the location of the Excel file on OneDrive for Business or SharePoint.
66+
* **Document Library**: Select the library of the Excel file.
67+
* **File**: Select the file path to the Excel file.
68+
* **Table**: Select "Dataflow_monitoring".
6069

61-
The **Dataflow Refresh** trigger is expanded because you need to enter information on your dataflow:
62-
* **Group Type**: Select *Environment* when connecting to Power Apps and *Workspace* when connecting to Power BI.
63-
* **Group**: Select the Power Apps environment or the Power BI workspace your dataflow is in.
64-
* **Dataflow**: Select your dataflow by name.
65-
66-
The **Add a row into a table** action is expanded because you need to enter the *Location* of the Excel file and the specific *Table* the data loads to.
67-
* **Location**: Select the location of the Excel file on OneDrive for Business or SharePoint.
68-
* **Document Library**: Select the library of the Excel file.
69-
* **File**: Select the file path to the Excel file.
70-
* **Table**: Select "Dataflow_monitoring".
70+
![Image of the Excel Add a row into a table connection, with the fields ready to be filled in.](media/templateexcel.png)
71+
72+
8. Add dynamic values to the required fields.
7173

72-
* Add dynamic values to the required fields.
74+
For every required field, you need to add a dynamic value. This value is the output of the metadata of the dataflow run.
7375

74-
For every required field, you need to add a dynamic value. This value is the output of the metadata of the dataflow run.
75-
* Select the field next to **Dataflow ID** and then select the lightning button.
76-
77-
![example of lightning button in Excel.](media/dynamicexcel.png)
76+
1. Select the field next to **dataflowname_name**.
7877

79-
* Select the Dataflow ID as the dynamic content.
80-
![An example of folder structure.](media/dynamicexcel1.png)
78+
2. Select **Dataflow Name** from the **Dynamic content** context box.
8179

82-
* Repeat this process for all required fields.
80+
[![Image of the Excel Add a row into a table connector, with the dynamic contents selection dialog box.](media/dynamicexcel1.png)](media/dynamicexcel1.png#lightbox)
8381

84-
* Save the flow.
82+
3. Repeat this process for all required fields.
8583

84+
9. Save the flow.
8685

8786
## Create a Power BI Report
8887

89-
* Open the `.pbit` file.
88+
1. Open the `.pbit` file.
89+
90+
2. Connect to your Excel file.
9091

91-
* Connect to your Excel file.
92+
In this dashboard, for every dataflow in your specified time interval, you can monitor:
9293

93-
In this dashboard, you can monitor, for every dataflow in your specified time interval:
94-
* the dataflow duration
95-
* the dataflow count
96-
* the dataflow failure count
94+
* The dataflow duration
95+
* The dataflow count
96+
* The dataflow failure count
9797

98-
The uniqueID for every dataflow is generated by a merge between the dataflow name and the dataflow start time.
98+
The uniqueID for every dataflow is generated by a merge between the dataflow name and the dataflow start time.

0 commit comments

Comments
 (0)