Bold BI Dashboards embedding in React with ASP.NET Core using Embedded SDK

We have created the React and ASP.NET Core application for achieving this embedding. Here, the React app acts as a client and the Core app acts as a server. Using this environment, we could be able to list the dashboards and render it.

NOTE: The best way to get started would be reading the Getting Started section of the documentation to start using first. The Getting Started guide gives you enough information that you need to know before working on the sample.

How to run the sample

1. Please download the React App with ASP.NET Core Application from here.

2. Here, the React application act as a client, and the ASP.NET Core application act as a server since we need to set the following properties in the DashboardListing.js file as follows.

   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 `onpremise`)
   apiHost	ASP.NET Core application would be run on http://localhost:61377/, which needs to be set as `apiHost`
   rootUrl	Dashboard Server BI URL (ex: http://localhost:5000/bi, http://demo.boldbi.com/bi)
   authorizationUrl	Url of the GetDetails action in ValuesController of the ASP.NET Core application
   UserEmail	UserEmail of the Admin in your Bold BI, which would be used to authorize the server
   UserPassword	Password of the Admin in Bold BI, which would be used to get the dashboards list

3. In EmbedProperties.cs of the ASP.NET Core application, you need to set the RootUrl, SiteIdentifier, UserEmail, and EmbedSecret properties.
   

4. You can get your Embed Secret key from the administrator setting section. Please refer to this link for more details.

5. Then, run your ASP.NET Core application and as well as the React App.

How this sample works

1. Based on the properties set on the DashboardListing.js file, we would call the GetDashboards Server API from the componentDidMount() function.
   

2. For contacting the GetDashboards Server API, we would generate a user token by using the user email and password and then get the dashboard list.

3. In the DashboardListing.js file, we have designed a page for listing dashboards on the left side and rendering dashboard. The retrieved dashboard list has been set to items using the setState() property.
   

4. By default, we have rendered the first dashboard from the list using the renderDashboard() method in the DashboardListing.js file. This render method is implemented with the Bold BI SDK component code.
   

5. Before rendering, we are calling the authorizationUrl, which redirects to the GetDetails action in HomeController, which generates the EmbedSignature using the embed secret provided in the EmbedProperties.cs of ASP.NET Core application.
   

6. These details will be sent to the Bold BI server and get validated there. Once the details are validated, the dashboard starts to render.