使用Power BI RESTAPI把报表嵌入应用程序

你的名字 2022-02-24 05:08 847阅读 0赞

Power BI本身已经提供了很好的互动报表操作，但是在很多情况下我们会需要把报表嵌入到网页或者app里，和公司现有的办公应用集成在一起并且互相交互，这时候我们就可以通过SDK或者RESTAPI的方式在App里调用操作报表了。

Power BI目前提供C\#的SDK已经封装好了可以直接调用。有兴趣的可以移步[https://docs.microsoft.com/zh-cn/power-bi/developer/embed-sample-for-your-organization][https_docs.microsoft.com_zh-cn_power-bi_developer_embed-sample-for-your-organization]参考

其他语言没有封装好的SDK也还是可以使用Power BI RESTAPI来进行调用，本文主要使用测试工具[Postman][]来进行RESTAPI的测试，一旦RESTAPI跑通了，后续的开发也就容易了。

## 在 Azure Active Directory (Azure AD) 中注册应用程序 ##

要使用SDK调用Power BI, 首先我们需要一个 Power BI Pro 帐户（作为主帐户）和 Microsoft Azure 订阅。

*  如果未注册 Power BI Pro，请在开始之前[注册以获得免费试用][Link 1]。
 *  如果没有 Azure 订阅，请在开始之前先创建一个[免费帐户][Link 2]。
 *  你需要具有自己的 [Azure Active Directory 租户][Azure Active Directory]。

首先我们需要在Azure AD里注册一个应用，并且赋上相应的权限。

1.登陆[http://portal.azure.com][http_portal.azure.com]，找到Azure Active Directory

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70][]

2.点击新应用程序注册

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 1][]

3.创建完成，依次如下图选择，设置，所需权限，添加

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 2][]

4.依次添加如下权限

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 3][]

5.新建一个密钥

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 4][]

这个时候我们的程序注册已经完成，接下来可以在Postman进行Rest API的调用了

## Power BI 用户OAuth2.0认证 ##

要用RESTAPI访问我们的Power BI报表资源，首先要通过前面我们注册的应用程序在Azure AD上进行用户认证。AAD使用的认证方式是OAuth2.0，我们可以使用Postman来进行

1.打开Postman， Authorization里面Type选择OAuth 2.0，点击Get New Access Token.

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 5][]

填写相应信息，点击Request Token  
Callback URL: [http://localhost:15236][http_localhost_15236] (要和前面在AAD注册应用的callback url一致)  
Auth URL: [https://login.windows.net/common/oauth2/authorize?resource=https://analysis.windows.net/powerbi/api][https_login.windows.net_common_oauth2_authorize_resource_https_analysis.windows.net_powerbi_api]  
Access Token URL: [https://login.windows.net/common/oauth2/authorize?resource=https://analysis.windows.net/powerbi/api][https_login.windows.net_common_oauth2_authorize_resource_https_analysis.windows.net_powerbi_api]  
Client ID: 前面步骤3图中的应用程序ID  
Client Secret: 前面步骤5中创建的密钥

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 6][]

获得了Access Token之后就可以进行Power BI RESTAPI的调用了

## Power BI RESTAPI调用 ##

按照下图所示我们调用了[https://api.powerbi.com/v1.0/myorg/groups][https_api.powerbi.com_v1.0_myorg_groups] 获取该用户下所有的workspace

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 7][]

## 把Power BI报表嵌入现有网页应用 ##

首先需要获得报表的Group ID，登陆Power BI Pro，打开想嵌入的报表，下图URL里红圈内即为Group ID和Report ID(report id在后面有用).

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 8][]

使用 [https://api.powerbi.com/v1.0/myorg/groups/][https_api.powerbi.com_v1.0_myorg_groups 1]\{groupId\}/reports 获得report的具体信息，记下embedUrl。

接下来可以使用Power BI Javascript SDK来把报表嵌入html了。首先去[https://github.com/Microsoft/PowerBI-JavaScript/releases][https_github.com_Microsoft_PowerBI-JavaScript_releases]下载最新的release，在dist目录找到powerbi.js文件。按照下图建立文件把powerbi.js放到scripts目录，编辑pbiembed.html，修改对应的embedUrl和accessToken参数，用浏览器打开pbiembed.html即可看到报表成功嵌入了。

![20190403102729340.png][]

<!DOCTYPE html>
    <title>Power BI - Web sample</title>
    <html lang="en">
    <body>        
        <script type="text/javascript" src="scripts/powerbi.js"></script>
        <div id="reportContainer" style="width: 900px; height: 500px">
        </div>
        <script type="text/javascript">
        var embedUrl = "前面获得的EmbedURL" 
       
        // get the access token.
        accessToken = "前面获得的Access Token"
    
        var models = window['powerbi-client'].models;
        
        var permissions = models.Permissions.All;
        // Embed configuration used to describe the what and how to embed.
        // This object is used when calling powerbi.embed.
        // You can find more information at https://github.com/Microsoft/PowerBI-JavaScript/wiki/Embed-Configuration-Details.
        var config = {
            type: 'report',
            tokenType: models.TokenType.Embed,
            accessToken: accessToken,
            embedUrl: embedUrl,
            id: "03d9a889-c26c-4268-a2cc-91af00eb2ab8",
            permissions: permissions,
            settings: {
                filterPaneEnabled: true,
                navContentPaneEnabled: true
            }
        };
    
        // Grab the reference to the div HTML element that will host the report.
        var reportContainer = document.getElementById('reportContainer');
    
        // Embed the report and display it within the div container.
        var report = powerbi.embed(reportContainer, config);
        </script>
    </body>
    </html>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 9][]

## 参考资源 ##

[https://docs.microsoft.com/zh-cn/azure/active-directory/develop/v1-protocols-oauth-code][https_docs.microsoft.com_zh-cn_azure_active-directory_develop_v1-protocols-oauth-code]  
[https://docs.microsoft.com/en-us/rest/api/power-bi/][https_docs.microsoft.com_en-us_rest_api_power-bi]

--------------------

作者：Kele\_73b1  
链接：https://www.jianshu.com/p/9dd231221b26  
来源：简书  
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。

[https_docs.microsoft.com_zh-cn_power-bi_developer_embed-sample-for-your-organization]: https://docs.microsoft.com/zh-cn/power-bi/developer/embed-sample-for-your-organization
[Postman]: https://www.getpostman.com/
[Link 1]: https://powerbi.microsoft.com/en-us/pricing/
[Link 2]: https://azure.microsoft.com/free/?WT.mc_id=A261C142F
[Azure Active Directory]: https://docs.microsoft.com/zh-cn/power-bi/developer/create-an-azure-active-directory-tenant
[http_portal.azure.com]: http://portal.azure.com/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70]: /images/20220224/2260dd6b51044e3d8ff9bedeaeda24d6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 1]: /images/20220224/8c5c7244cf4d43e3a5362bdff0959bfa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 2]: /images/20220224/a3c1dc8094a845aba80c41ef36d82f88.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 3]: /images/20220224/6c5076d2e5f24cab92e4df14e6bd3b16.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 4]: /images/20220224/e0b2537e761d462eb850ab012f63e87d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 5]: /images/20220224/ebee704f418f411888fa513ed3b3ed5b.png
[http_localhost_15236]: http://localhost:15236
[https_login.windows.net_common_oauth2_authorize_resource_https_analysis.windows.net_powerbi_api]: https://login.windows.net/common/oauth2/authorize?resource=https://analysis.windows.net/powerbi/api
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 6]: /images/20220224/3f1b004c49714deb8c92ebd7d4d9eaaf.png
[https_api.powerbi.com_v1.0_myorg_groups]: https://api.powerbi.com/v1.0/myorg/groups
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 7]: /images/20220224/e62215d08ed64a978436b55c6af1583e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 8]: /images/20220224/9a7f4cdecd6a41b780ec776f7c75ae63.png
[https_api.powerbi.com_v1.0_myorg_groups 1]: https://api.powerbi.com/v1.0/myorg/groups/
[https_github.com_Microsoft_PowerBI-JavaScript_releases]: https://github.com/Microsoft/PowerBI-JavaScript/releases
[20190403102729340.png]: /images/20220224/029ac6aafee74f4baa4af3c93d6f2e07.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE2MzEzNTc1_size_16_color_FFFFFF_t_70 9]: /images/20220224/93d7ce0633c544339e93aae32d2273e5.png
[https_docs.microsoft.com_zh-cn_azure_active-directory_develop_v1-protocols-oauth-code]: https://docs.microsoft.com/zh-cn/azure/active-directory/develop/v1-protocols-oauth-code
[https_docs.microsoft.com_en-us_rest_api_power-bi]: https://docs.microsoft.com/en-us/rest/api/power-bi/