Power BI Tag Helper: Part 2 - Power BI Embedded

Power BI Tag Helper: Part 2 - Power BI Embedded

Jan 22, 2017     Viewed 3332 times 0 Comments
Posted in #TagHelpers  #Power BI 

In the last blog post I talked about the Power BI Tag Helper: Part 1 - Power BI Publish to Web which I explored the publish to web feature in the Power BI portal. Today I will continute with the second part which I will explain what is the Power BI Embedded? How we can use it? An what the informations needed in case of authoring a TagHelper to embed a Power BI report into our ASP.NET Core application.

What is Power BI Embedded?

Power BI Embedded is an Azure service that let you host Power BI reports and dashboards into your web or mobile applications. Your users don't need Power BI account and they access Power BI reports and dashboards via your application.

I would like to mention two of the greatest resources about the Power BI Embedded that I found in Channel 9 (Azure Friday Show), Scott Hanselman talks to Josh Caplan about:

Azure Friday: Introducing Microsoft Power BI Embedded

Azure Friday: PowerBI Embedded GA

How to use Power BI Embedded

Resources for Microsoft Power BI Embedded are provisioned through the Azure ARM APIs. In this case, the resource you provision is a Power BI Workspace Collection.

A Workspace Collection is the top-level Azure resource and a container for the content that will be embedded in your application. A Workspace Collection can be created in two ways:

  • Manually using the Azure Portal
  • Programmatically using the Azure Resource Manager(ARM) APIs

The following steps describe how to build a Workspace Collection using the Azure Portal :

  1. Open and sign into Azure Portal: http://portal.azure.com.
  2. Click + New on the top panel.
  3. Under Data + Analytics click Power BI Embedded.

  4. On the Workspace Collection Blade, enter the required information.

  5. Click Create.

The Workspace Collection will take a few moments to provision. When completed, you'll be taken to the Workspace Collection Blade.

At this point you need to provision a new workspace in the workspace collection that we created above, also you need to import your .PBIX file, for that please refer to this link it will guide you for all the steps that you need to achieve this.

Now let us dig into the PowerBITagHelper which is very straightforward, it basically construct the script required by Power BI JavaScript.

[HtmlTargetElement("power-bi", TagStructure = TagStructure.NormalOrSelfClosing)]
public class PowerBITagHelper : TagHelper
     public string AccessKey { get; set; }

    public int Height { get; set; } = 600;

    public string ReportId { get; set; }

    public int Width { get; set; } = 800;

    public string WorkspaceCollectionName { get; set; }

    public string WorkspaceId { get; set; }

    private string AccessToken
            // For more information refer to this link https://docs.microsoft.com/en-us/azure/power-bi-embedded/power-bi-embedded-iframe
            var token1 = "{" +
                "\"typ\":\"JWT\"," +
                "\"alg\":\"HS256\"" +
            var token2 = "{" +
                $"\"wid\":\"{WorkspaceId}\"," +
                $"\"rid\":\"{ReportId}\"," +
                $"\"wcn\":\"{WorkspaceCollectionName}\"," +
               "\"iss\":\"PowerBISDK\"," +
               "\"ver\":\"0.2.0\"," +
               "\"aud\":\"https://analysis.windows.net/powerbi/api\"," +
               "\"nbf\":" + DateTime.UtcNow.ToUnixTimestamp() + "," +
               "\"exp\":" + DateTime.UtcNow.AddHours(1).ToUnixTimestamp() +

            var inputValue = $"{UrlEncode(token1)}.{UrlEncode(token2)}";
            var hash = new HMACSHA256(Encoding.UTF8.GetBytes(AccessKey))
            var signature = UrlEncode(hash);

            return $"{inputValue}.{signature}";

    public override void Process(TagHelperContext context, TagHelperOutput output)
        output.TagName = null;
        if (WorkspaceCollectionName != null && WorkspaceId != null && AccessKey != null & ReportId != null)
            string style = $"width:{Width}px;height:{Height}px";
            if(context.AllAttributes.TryGetAttribute("style", out var styleAttribute))
                style = $"{styleAttribute.Value};{style}";

            var content = $@"<div id=""reportContainer"" style=""{style}""></div>

                $(function() {{
                    var embedConfiguration = {{
                        type: 'report',
                        accessToken: '{AccessToken}',
                        id: '{ReportId}',
                        embedUrl: 'https://embedded.powerbi.com/appTokenReportEmbed?reportId={ReportId}'
                var $reportContainer = $('#reportContainer');
                var report = powerbi.embed($reportContainer.get(0), embedConfiguration);

Now we can simply use it in our view like this:

<power-bi workspaceCollectionName="DemoWorkspaceCollection"
          reportId="1f7004ba-d989-4dfa-b101-eba56c68f70b" /> 

Last thing you need to provide: workspace collection name, workspace id, access key and report id, you can get all the information except that last one from the Azure portal, so please refer to the figure above, after you run the page you should see your report rendered in the browser.

On more thing I want to clarify don't worry about the information that you provide to the TagHelper especially the "Access Key" I know it's sensitive information but all are required to generate the Access Token for the application at the server side and they will not sent or rendered in the html source.

You can download the source code for this post from my PowerBI-TagHelper repository on GitHub.

Leave a Comment