Search results

Bold BI Dashboards embedding in Java Servlet using Embedded SDK

A GitHub link has been provided to get the sample application, which demonstrates the rendering of the dashboard available on your Bold BI server. This is followed by steps to create a new embedding application in Java Servlet on your own.

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

How to run the sample

  1. Please get the Java Servlet project from this link.

  2. You need to set the embed property details in the index.jsp and BoldBI.java. Embed Properties in Index Embed Properties in API

    SiteIdentifier For Bold BI Enterprise edition, it should be like site/site1. For Bold BI Cloud, it should be empty string.
    RootUrl Dashboard Server BI URL (ex: http://localhost:5000/bi, http://demo.boldbi.com/bi)
    Environment Your Bold BI application environment. (If Cloud, you should use cloud, if Enterprise, you should use onpremise)
    DashboardId Set the item id of the dashboard to embed from BI server.
    UserEmail UserEmail of the Admin in your Bold BI, which would be used to get the dashboard details from the BI server
    EmbedSecret You could get your EmbedSecret key from Embed tab by enabling Enable embed authentication in Administration page as shown below
  3. You can obtain your Embed Secret key from the administrator settings section. Please refer to this link for more details.

  4. Execute your Java Servlet project.

How this sample works

  1. To authorize the server, call the doPost function using the AuthorizeURL(http://localhost:8080/BoldBIEmbed/BoldBI.do) with the provided EmbedProperties values, based on the dashboardId provided in the index.jsp. Get Embed Details

  2. In the previous authorization, generate the SignatureURL using the provided EmbedSecret key and embed details. This SignatureURL can be validated in the Bold BI Server API and will return a token. Based on the returned token, the dashboard will begin rendering in the index.jsp.

  3. In the index.jsp, change the dashboard ID of the respective dashboard according to your requirement. Set Dashboard Id