Bold BI Dashboards Embedding in ASP.NET MVC Sample with Embedded SDK

We have created an ASP.NET MVC sample with the Embedded SDK. Here, we can list the dashboards and render the dashboard based on your selection after passing the authorization.

NOTE: The best way to get started would be to read the Getting Started section of the documentation before using it for the first time. The Getting Started guide provides just enough information that you need to know before working on the sample.

How to run the sample

  1. Download the ASP.NET MVC sample.

  2. Within the ASP.NET MVC sample, you can locate the EmbedProperties class file in the Models folder.

Properties

  1. In EmbedProperties.cs, you need to set the following properties.
RootUrl Dashboard Server BI URL (ex: http://localhost:5000/bi, http://demo.boldbi.com/bi)
SiteIdentifier For Bold BI Enterprise edition, it should be like `site/site1`. For Bold BI Cloud, it should be empty string.
Environment Your Bold BI application environment. (If Cloud, you should use `cloud`, if Enterprise, you should use `enterprise`)
UserEmail UserEmail of the Admin in your Bold BI, which would be used to get the dashboards list
UserPassword Password of the Admin in Bold BI, which would be used to get the dashboards list
EmbedSecret You could get your EmbedSecret key from Embed tab by enabling `Enable embed authentication` in Administration page as mentioned in next step

  1. You can obtain your Embed Secret key from the administrator settings section. Please refer to the Embed Settings for further information.

  2. Then, run your ASP.NET MVC sample.

How this sample works

  1. Based on the values provided in the EmbedProperties.cs, we would retrieve the user token and validate it. After that, we could obtain the list of dashboards from the server.

  2. In HomeController.cs, we have added the GetToken() method and GetDashboards() action, which are called when initializing the DOM in Index.html.

Initializing the DOM in MVC

  1. When you are selecting the dashboard to render, we will authorize the server URL by calling the GetEmbedDetails action with the provided EmbedProperties values.

Server Authorization in MVC

  1. In the above authorization, we have generated a SignatureUrl using the provided EmbedSecret key and validated the embed details in Bold BI. Only after this, the dashboard will be rendered in the viewer-section of index.cshtml.