在 Power BI 工作区集合中基于数据集创建新报表

现在，可以基于自有应用程序中的数据集创建 Power BI 工作区集合报表。

身份验证方法类似于嵌入报表时的身份验证方法。 该方法基于特定于数据集的访问令牌。 用于 PowerBI.com 的令牌是由 Azure Active Directory (AAD) 颁发的。 Power BI 工作区集合令牌是由你自己的应用程序颁发的。

创建嵌入报表时，颁发的令牌用于特定的数据集。 令牌应与同一元素上的嵌入 URL 相关联，确保每个元素都有一个的唯一令牌。 若要创建嵌入式报表，必须在访问令牌中提供 Dataset.Read 和 Workspace.Report.Create 作用域。

创建所需的访问令牌用于创建新报表

Power BI 工作区集合使用一个嵌入令牌，这是一个 HMAC 已签名 JSON Web 令牌。 已使用 Power BI 工作区集合中的访问密钥对令牌进行了签名。 默认情况下，嵌入令牌用于提供对要嵌入到应用程序的报表的只读访问权限。 嵌入令牌是针对特定报表颁发的，应该与嵌入 URL 相关联。

应在服务器上创建访问令牌，因为要使用访问密钥对令牌进行签名/加密。 有关如何创建访问令牌的信息，请参阅通过 Power BI 工作区集合进行身份验证和授权。 此外，还可以查看 CreateReportEmbedToken 方法。 以下示例演示了如何使用用于 Power BI 的 .NET SDK。

在此示例中，我们已有要基于其创建新报表的数据集 ID。 还需要添加 Dataset.Read 和 Workspace.Report.Create 的作用域。

PowerBIToken 类要求安装 Power BI Core NuGut 包。

安装 NuGet 包

Install-Package Microsoft.PowerBI.Core

C# 代码

using Microsoft.PowerBI.Security;

// rlsUsername and roles are optional
string scopes = "Dataset.Read Workspace.Report.Create";
PowerBIToken embedToken = PowerBIToken.CreateReportEmbedTokenForCreation(workspaceCollectionName, workspaceId, datasetId, null, null, scopes);

var token = embedToken.Generate("{access key}");

创建新的空白报表

若要创建新报表，应提供 create 配置。 此配置应包含访问令牌、embedURL，以及用于创建报表的 datasetID。 这就需要安装 Power BI JavaScript NuGet 包。 embedUrl 将只是 https://embedded.powerbi.cn/appTokenReportEmbed。

安装 NuGet 包

Install-Package Microsoft.PowerBI.JavaScript

JavaScript 代码

<div id="reportContainer"></div>

<script>  
var embedCreateConfiguration = {
        accessToken: 'eyJ0eXAiO...Qron7qYpY9MI',
        embedUrl: 'https://embedded.powerbi.cn/appTokenReportEmbed',
        datasetId: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
    };
    
    // Grab the reference to the div HTML element that will host the report
    var reportContainer = $('#reportContainer')[0];

    // Create report
    var report = powerbi.createReport(reportContainer, embedCreateConfiguration);
</script>    

调用 powerbi.createReport() 会在 div 元素中创建一个以编辑模式显示的空白画布。

保存新报表

在调用“另存为”操作之前，不会创建报表。 可以通过文件菜单或 JavaScript 完成此操作。

 // Get a reference to the embedded report.
    report = powerbi.get(reportContainer);
    
    var saveAsParameters = {
        name: "newReport"
    };

    // SaveAs report
    report.saveAs(saveAsParameters);

加载新报表

要与新报表交互，需要像应用程序嵌入常规报表一样来嵌入新报表，这意味着，必须专门针对新报表颁发新令牌，并调用 embed 方法。

<div id="reportContainer"></div>
<script>  
var embedConfiguration = {
        accessToken: 'eyJ0eXAiO...Qron7qYpY9MJ',
        embedUrl: 'https://embedded.powerbi.cn/appTokenReportEmbed',
        reportId: '5dac7a4a-4452-46b3-99f6-a25915e0fe54',
    };
    
    // Grab the reference to the div HTML element that will host the report
    var reportContainer = $('#reportContainer')[0];

    // Embed report
    var report = powerbi.embed(reportContainer, embedConfiguration);
</script>    

使用“saved”事件自动保存和加载新报表

要自动执行“另存为”过程，并加载新报表，可以使用“saved”事件。 当保存操作已完成并返回包含新 reportId、报表名称、旧 reportId（如果有）的 Json 对象，并且操作是 saveAs 或 save 时，将激发此事件。

{
  "reportObjectId": "5dac7a4a-4452-46b3-99f6-a25915e0fe54",
  "reportName": "newReport",
  "saveAs": true,
  "originalReportObjectId": null
}

要自动执行该过程，可以侦听“saved”事件，提取新的 reportId，创建新令牌，并使用新令牌嵌入新报表。

<div id="reportContainer"></div>
<script>    
var embedCreateConfiguration = {
        accessToken: 'eyJ0eXAiO...Qron7qYpY9MI',
        embedUrl: 'https://embedded.powerbi.cn/appTokenReportEmbed',
        datasetId: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
    };
    
    // Grab the reference to the div HTML element that will host the report
    var reportContainer = $('#reportContainer')[0];

    // Create report
    var report = powerbi.createReport(reportContainer, embedCreateConfiguration);


   var saveAsParameters = {
        name: "newReport"
    };

    // SaveAs report
    report.saveAs(saveAsParameters);

    // report.on will add an event handler which prints to Log window.
    report.on("saved", function(event) {
        
         // get new Token
         var newReportId =  event.detail.reportObjectId;

        // create new Token. This is a function that the application should provide
        var newToken = createAccessToken(newReportId,scopes /*provide the wanted scopes*/);
        
        
    var embedConfiguration = {
        accessToken: newToken ,
        embedUrl: 'https://embedded.powerbi.cn/appTokenReportEmbed',
        reportId: newReportId,
    };

    // Embed report
    var report = powerbi.embed(reportContainer, embedConfiguration);
       
   // report.off removes a given event handler if it exists.
   report.off("saved");
    });
</script>    

另请参阅

示例入门
保存报表
嵌入报表
在 Power BI 工作区集合中进行身份验证和授权
Power BI Desktop
JavaScript 嵌入示例
Power BI Core NuGut 包
Power BI JavaScript 包

更多问题？ 尝试参与 Power BI 社区