Skip to content

Commit f6c9d26

Browse files
committed
Updated instructions
1 parent 8372f39 commit f6c9d26

File tree

4 files changed

+11
-10
lines changed

4 files changed

+11
-10
lines changed

README.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
# Power Query Custom Data Connector for Power BI REST APIs (Commercial)
22

3+
34
This Custom Data Connector wraps many of the "Get" endpoints in the Power BI API (with the exception of the /executeQueries endpoint), so that OAuth can be used to authenticate to the service. This connector serves as a way to have a library of Power Query functions to build datasets based on the Power BI APIs without the need for storing client secrets or passwords in the dataset.
45

56
Each function returns a JSON body and not a table of data. This decision was made to provide flexibility in converting the JSON body to tabular data when 1) the API responses are changed by Microsoft or 2) the API responses differ between commercial and sovereign clouds (e.g., GCC, DoD, etc.).
@@ -26,12 +27,12 @@ Each function returns a JSON body and not a table of data. This decision was ma
2627
Because this is a custom data connector you have to choose this option in order to use it in Power BI Desktop.
2728

2829
3. Close all Power BI Desktop instances on your local machine. You are often prompted to do so by Power BI Desktop.
29-
4. Copy the [.mez file](https://github.com/kerski/powerquery-connector-pbi-rest-api-commercial/blob/main/bin/AnyCPU/Debug/powerquery-connector-pbi-rest-api-commercial.mez?raw=true) to your folder "Documents\Power BI Desktop\Custom Connectors". If the folder does not exist create it first.
30-
5. Open Power BI Desktop
30+
4. Copy the [.mez file](https://github.com/kerski/powerquery-connector-pbi-rest-api-commercial/releases/download/v.1.0.0-beta/powerquery-connector-pbi-rest-api-commercial.mez) to your folder "Documents\Power BI Desktop\Custom Connectors". If the folder does not exist, create it first.
31+
5. Open Power BI Desktop.
3132
6. Select Get Data option.
32-
7. Navigate to the "Other" section and you should see the "PBIRESTAPIComm" connector.
33+
7. Navigate to the "Other" section and you should see the "Connect to Power BI REST API" connector.
3334

34-
![Other->PBIRESTAPIComm](./documentation/images/pbi-other-connect.png)
35+
![Other->PBIRESTAPIGCC](./documentation/images/pbi-other-connect.png)
3536

3637
8. Select the connector and press the "Connect" button.
3738
9. You may be prompted with the pop-up below. Choose "Continue".
@@ -46,7 +47,7 @@ Because this is a custom data connector you have to choose this option in order
4647

4748
![Navigator prompt](./documentation/images/navigator.png)
4849

49-
11. Choose the "GetApps" option and you should see a json response (see example below)
50+
11. Choose the "GetApps" option and you should see a json response (see example below).
5051

5152
![GetApps](./documentation/images/get-apps.png)
5253

@@ -58,7 +59,7 @@ Because this is a custom data connector you have to choose this option in order
5859

5960
![Remove Steps](./documentation/images/remove-steps.png)
6061

61-
14. You now will see a catalog of the Power BI REST APIs to leverage. I suggest you rename the Query "GetApps" to "Function Catalog"
62+
14. You now will see a catalog of the Power BI REST APIs to leverage. I suggest you rename the Query "GetApps" to "Function Catalog".
6263

6364
![Function Catalog](./documentation/images/function-catalog.png)
6465

@@ -110,15 +111,15 @@ The custom data connector will need to be installed in the a Power BI Gateway in
110111

111112
### Prerequisites
112113

113-
1. Install Visual Studio code: https://code.visualstudio.com/download
114+
1. Install Visual Studio code: https://code.visualstudio.com/download.
114115
1. Install Power Query SDK for Visual Studio Code: https://github.com/microsoft/vscode-powerquery-sdk
115116
1. Clone this repo to your local machine.
116117

117118
## Compile
118119

119120
In order to the compile the custom data connector to the .mez file, please follow these instructions:
120121

121-
1. Using your keyboard, use the shorcut Ctrl+Shift+B. Visual Studio will prompt you within the command palette to choose a build task. Select the "build: Build connector project using MakePQX"
122+
1. Using your keyboard, use the shorcut Ctrl+Shift+B. Visual Studio will prompt you within the command palette to choose a build task. Select the "build: Build connector project using MakePQX".
122123

123124
![Build](./documentation/images/build-mez.png)
124125

Binary file not shown.
19.1 KB
Loading

resources.resx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -118,9 +118,9 @@
118118
<value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
119119
</resheader>
120120
<data name="ButtonHelp" xml:space="preserve">
121-
<value>Connect to PBIRESTAPIComm</value>
121+
<value>Connect to PBI REST API</value>
122122
</data>
123123
<data name="ButtonTitle" xml:space="preserve">
124-
<value>PBIRESTAPIComm</value>
124+
<value>Connect to PBI REST API</value>
125125
</data>
126126
</root>

0 commit comments

Comments
 (0)