string
Defines the ID of the dashboard to be embedded from your Bold BI application.
"" (empty)Example
var dashboard = BoldBI.create({
dashboardId: "5cb065f7-dabb-4b0c-9b45-c60a5730e963"
});
dashboard.loadDashboard(); string
Stores the dashboard path in the format of category name followed by dashboard name.
/{category-name}/{dashboard-name}"" (empty)Example
var dashboard = BoldBI.create({
dashboardPath: "/Samples/Sample Dashboard"
});
dashboard.loadDashboard(); string
The ID of a div element in which the dashboard will be initialized and rendered.
"" (empty)Example
<div id="container"></div>
<script>
var dashboard = BoldBI.create({
embedContainerId: "container",
});
dashboard.loadDashboard();
</script> object
There are two types of embedding available: component and iframe. In the component type, you will use the embedding SDK to render the dashboard. In the iframe type, you will load the dashboard URL in the iframe and the dashboard will be rendered.
BoldBI.EmbedType.ComponentBoldBI.EmbedType.IFrameBoldBI.EmbedType.ComponentExample
var dashboard = BoldBI.create({
embedType: BoldBI.EmbedType.Component,
});
dashboard.loadDashboard(); string
Stores the Embed Authorization API access token to reduce redundant API calls and improve performance.
"" (empty)Example
var dashboard = BoldBI.create({
embedToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6ImRldm9wc0Bib2xkYmkuY29tIiwidXBuIjouYm9sZGJpZGVtby5jb20vYmkvc2l0ZS9zaXRlMSIsImF1ZCI6Imh0dHBzOi8vaG90Zml4LXdpbmRvd3MuYm9sZGJpZGVtby5jb20vYmkvc2l0ZS9zaXRlMSJ9.JzbqVr6Brv1mAEvnbHnE-FuShos"
});
dashboard.loadDashboard(); object
Specifies the type of Bold BI application, either Cloud or Enterprise edition.
BoldBI.Environment.CloudBoldBI.Environment.EnterpriseBoldBI.Environment.EnterpriseExample
var dashboard = BoldBI.create({
environment: BoldBI.Environment.Enterprise
});
dashboard.loadDashboard(); number
Specifies the access token expiration time of the dashboard in seconds.
86400 (24 hours)Example
var dashboard = BoldBI.create({
expirationTime: 100000
});
dashboard.loadDashboard(); string
Supports filtering of the dashboard using URL or dashboard parameters.
{column_name}={value1},{value2},{value3}{parameter_name}={parameter_value} or IN({value1},{value2}){column_name1}={value1}&{column_name2}={value2}{parameter_name}={parameter_value}&&{parameter_name1}={parameter_value1}{column_name}={value1},{value2}&&{parameter_name}={parameter_value} or vice versa"" (empty)Examples URL Parameter
var dashboard = BoldBI.create({
filterParameters: "Continent=Asia,Africa,Europe"
});
dashboard.loadDashboard();Dashboard Parameter (Literal)
var dashboard = BoldBI.create({
filterParameters: "Department_DP=Sales"
});
dashboard.loadDashboard();Dashboard Parameter (List)
var dashboard = BoldBI.create({
filterParameters: "Department_DP=IN(Sales,Marketing)"
});
dashboard.loadDashboard();Multiple URL Parameters
var dashboard = BoldBI.create({
filterParameters: "Continent=Asia&Direction=East"
});
dashboard.loadDashboard();Multiple Dashboard Parameters
var dashboard = BoldBI.create({
filterParameters: "Department_DP=Sales&&Feedback=Good"
});
dashboard.loadDashboard();Combination of URL and Dashboard Parameters
var dashboard = BoldBI.create({
filterParameters: "Continent=Asia,Africa,Europe&&Department_DP=Sales"
});
dashboard.loadDashboard(); string
Defines the height of the embedding module in percentages or pixels.
Example
var dashboard = BoldBI.create({
height: "800px"
});
dashboard.loadDashboard(); boolean
Enables or disables the display of error messages inside the dashboard container.
falsetrue to suppress embedded error UI and handle errors via a custom callback.Example
var dashboard = BoldBI.create({
hideErrorMessage: true,
onError: function (args) {
var dashboardContainer = document.getElementById("dashboard");
dashboardContainer.innerHTML = "Authorization is failed. Please provide valid authorization url.";
}
});
dashboard.loadDashboard(); boolean
Specifies whether Bing Map-related files need to be downloaded.
falsetrue if the dashboard contains a Bing Map widget.Example
var dashboard = BoldBI.create({
isBingMapRequired: false,
});
dashboard.loadDashboard(); object
Defines the dashboard rendering mode.
BoldBI.Mode.ViewBoldBI.Mode.DesignBoldBI.Mode.ConnectionBoldBI.Mode.DataSourceBoldBI.Mode.ViewExample
var dashboard = BoldBI.create({
mode: BoldBI.Mode.View,
});
dashboard.loadDashboard(); string
Bypasses or loads dependencies from the Bold BI server when Content Security Policy (CSP) is enabled.
"" (empty)nonce member and the meta tag.Example
<meta http-equiv="Content-Security-Policy" content="script-src 'self' 'nonce-8beb50ac-fc1d-4106-ba6b-798835ac0c1b'">
var dashboard = BoldBI.create({
nonce = "8beb50ac-fc1d-4106-ba6b-798835ac0c1b"
});
dashboard.loadDashboard(); boolean
Restricts the mobile view on desktop when the browser width reaches a specified threshold.
falseExample
var dashboard = BoldBI.create({
restrictMobileView: true,
});
dashboard.loadDashboard(); string
The URL of the Bold BI application.
"" (empty)Example
var dashboard = BoldBI.create({
serverUrl: "https://mydashboard.com/bi/site/site1",
});
dashboard.loadDashboard(); string
Authenticates the dashboard without implementing the AuthorizeAPI endpoint.
"" (empty)Example
var dashboard = BoldBI.create({
token: "NjQ2ZDgwZjgtN2Q3MS00ZDQwLWFkNTItYTdkNDRhOGE2NmVi", // Use the generated API key
});
dashboard.loadDashboard();To learn about the available limited supporting methods in embedding.
string
Defines the width of the embedding module in percentages or pixels.
Example
var dashboard = BoldBI.create({
width:"1200px", //The dashboard is now rendered with a width of 1200px.
});
dashboard.loadDashboard(); object
Transmits custom data or header values to the embedding application’s Authorization Server. As a result, you may find this value in the headers of the Authorization Server API.
{} (empty object)Example
var dashboard = BoldBI.create({
authorizationServer:{
headers: {
"Authorization": "Bearer eDIHDIJAdjakdnajdbaidhoasjasajnsJNININfsbfskdnskdnskdn"
}
}
});
dashboard.loadDashboard(); string
Any application that embeds a Bold BI dashboard and widget needs to authenticate with the Bold BI server. This authentication flow requires sending confidential information such as user email, group details, and embed signature to the Bold BI server. Therefore, you must implement this authentication flow in your server application and provide the URL for connecting to your server in the Bold BI embed instance.
"" (empty)Example
var dashboard = BoldBI.create({
authorizationServer: {
url:"https://serversample.com/embed-details/get",
}
});
dashboard.loadDashboard();The auto refresh feature allows you to configure the scheduled refreshing process of the dashboard. It is used to refresh the data based on the specified time.
boolean
Enables or disables the auto-refresh feature for the dashboard.
falseExample
var dashboard = BoldBI.create({
autoRefreshSettings:{
enabled: false,
}
});
dashboard.loadDashboard(); number
Specifies the hourly time interval for auto-refreshing data.
0Example
var dashboard = BoldBI.create({
autoRefreshSettings:{
enabled: true,
hourlySchedule: {
hours: 1,
}
}
});
dashboard.loadDashboard(); number
Specifies the minute-by-minute time interval for auto-refreshing data.
0Example
var dashboard = BoldBI.create({
autoRefreshSettings:{
enabled: true,
hourlySchedule: {
minutes: 10,
}
}
});
dashboard.loadDashboard(); number
Specifies the second-by-second time interval for auto-refreshing data.
0Example
var dashboard = BoldBI.create({
autoRefreshSettings:{
enabled: true,
hourlySchedule: {
seconds: 30
}
}
});
dashboard.loadDashboard();Specifies whether or not to update the Dashboards name in the header section for a Single Tab Dashboard. For Multi Tab Dashboard, it specifies the unique ID of the dashboard and the name in which it should be rendered.
"" (empty)[] (empty array)dashboardId and dashboardName pairs.Example (Single Tab Dashboard)
var dashboard = BoldBI.create({
dashboardSettings: {
dashboardName: "name",
}
});
dashboard.loadDashboard();Example (Multi Tab Dashboard)
var dashboard = BoldBI.create({
dashboardSettings: {
dashboardName: [
{ dashboardId: "fb63ae99-83b6-4752-97b7-890182a3729f", dashboardName: "value 1" },
{ dashboardId: "77fd95ce-ec8b-4f68-817c-f41cabfabd3a", dashboardName: "value 2" }
]
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Filter Overview icon in the dashboard banner.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
enableFilterOverview: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Full Screen icon in dashboard banner.
falseExample
var dashboard = BoldBI.create({
dashboardSettings: {
enableFullScreen: true,
}
});
dashboard.loadDashboard(); string
The fontFamily member allows you to customize the font of the Bold BI embedded modules such as the viewer, designer, data source, and pinboard embedding.
"" (empty)Example
var dashboard = BoldBI.create({
dashboardSettings: {
fontFamily : "Patrick-hand"
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Dashboard Parameter icon in dashboard banner.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
showDashboardParameter: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Export icon in dashboard banner.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
showExport: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the header panel in the Dashboard Viewer.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
showHeader: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Metrics option in the dashboard banner.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
showMetrics: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Option icon in dashboard banner.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
showMoreOption: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Refresh icon in dashboard banner.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
showRefresh: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to display or hide the Save As option in the Filter Overview section of the dashboard banner.
falseExample
var dashboard = BoldBI.create({
mode: BoldBI.Mode.View,
dashboardSettings: {
filterOverviewSettings :{
showSaveAsIcon: true,// To enable save as option in filter overview
}
}
});
dashboard.loadDashboard(); boolean
Specifies whether to display or hide the Save option in the filter overview section of the dashboard banner.
falseExample
var dashboard = BoldBI.create({
mode: BoldBI.Mode.View,
dashboardSettings: {
filterOverviewSettings :{
showSaveIcon: true,// To enable save option in filter overview
}
}
});
dashboard.loadDashboard(); boolean
Specifies whether to display or hide the View Saved Filter option in the Filter Overview section of the dashboard banner. When clicked, it triggers the onViewSavedFiltersClick event, allowing customization of the views dialog and additional actions.
falseExample
var dashboard = BoldBI.create({
mode: BoldBI.Mode.View,
dashboardSettings: {
filterOverviewSettings :{
showViewSavedFilterIcon: true,// To enable view saved filters option in filter overview
},
onViewSavedFiltersClick: function(args) {
// Retrieves the array of view information from 'args.viewInfos' and perform further actions.
console.log(args.viewInfos); //The 'args.viewInfos' contains a list of views in the form of an array.
},
}
});
dashboard.loadDashboard(); string
Allows embedding the dashboard with views by passing the viewId value, viewName, and query string in the filterParameters.
"" (empty)viewName and query string via the REST API.
Example
var dashboard = BoldBI.create({
mode: BoldBI.Mode.View,
dashboardSettings: {
filterOverviewSettings :{
viewId: '0732e6c9-f7d6-469a-85e0-a7a4b22dbb2a' // View ID
viewName: 'Filter View' // View name
}
},
filterParameters: 'filterQuery=[{"ucn":"Column1","cn":"Orderdate","rn":"ComboBox2","ir":false,"ims":false,"fi":"92884626db4ffba31a49504a4864e4","ipw":false,"dimfi":{"c":"Include","t":["2022"]}}]', //query string of the respective view
});
dashboard.loadDashboard(); string
Allows embedding the dashboard with views by passing the viewName value and query string in the filterParameters.
"" (empty)viewName and query string via the REST API.Example
var dashboard = BoldBI.create({
mode: BoldBI.Mode.View,
dashboardSettings: {
filterOverviewSettings :{
viewName: 'Filter View' // View name
}
},
filterParameters: 'filterQuery=[{"ucn":"Column1","cn":"Orderdate","rn":"ComboBox2","ir":false,"ims":false,"fi":"92884626db4ffba31a49504a4864e4","ipw":false,"dimfi":{"c":"Include","t":["2022"]}}]', //query string of the respective view
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the “Select Column” button in the view underlying data of the widget.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
viewDataSettings :{
enableColumnSelection: false,//Select column button will be hidden in the dashboard viewer.
}
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the export option in the view underlying data of the widget.
trueExample
var dashboard = BoldBI.create({
dashboardSettings: {
viewDataSettings :{
enableExporting: false,//The Export option will be hidden in the dashboard viewer.
}
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the display of all columns in the table in the View Underlying Data of the widget.
falseExample
var dashboard = BoldBI.create({
dashboardSettings: {
viewDataSettings : {
showAllColumns: true,//Column options are all checked in the dashboard viewer.
}
}
});
dashboard.loadDashboard(); integer
Customize the margins of the dashboard using the corresponding integer values.
nullExample
var dashboard = BoldBI.create({
designCanvasSettings: {
margin: 30,
}
});
dashboard.loadDashboard();The dashboard server provides a dynamic connection string feature for fetching the data used to render the dashboard.
string
This property holds the values that will be passed to the API in the dynamic connection string feature. This allows the user to use this identity in their API for validation and providing the required connection string.
"" (empty)Example
var dashboard = BoldBI.create({
dynamicConnection: {
isEnabled: true,
identity: "",
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the dynamic connection string feature.
falseExample
var dashboard = BoldBI.create({
dynamicConnection: {
isEnabled: false,
}
});
dashboard.loadDashboard();enableAiAssistant
boolean
Enables the AI Assistant for generating and modifying widgets using natural language queries. The AI Assistant enhances widget creation and customization by leveraging advanced AI models, making data visualization more intuitive and accessible. This feature is available in both Cloud and Enterprise editions for Dashboard Viewer, Dashboard Designer, Single Widget, and Pinboard embeddings.
falseenableAiAssistant directly in the create method.enableAiAssistant must be set inside embedAiAssistant.enabled instead of enableAiAssistant.Example (Before 12.1)
var dashboard = BoldBI.create({
embedAiAssistant: {
enableAiAssistant: true
}
});
dashboard.loadDashboard();Note: Please use the SDK and Bold BI server from the same version. Starting from version 12.1, the AI Assistant settings are restructured. Use the
enabledobjects as shown below.
Example (From 12.1 onwards)
var dashboard = BoldBI.create({
embedAiAssistant: {
enabled: true,
summary: {}
}
});
dashboard.loadDashboard();Note: A summary block is required to enable the AI Assistant due to a known issue in version 12.1.5.
boolean
Customizes the title of the AI Assistant as desired. Requires the enabled member API.
falseExample
var dashboard = BoldBI.create({
embedAiAssistant: {
enabled: true,
name: "Embedded AI",
summary: {
}
}
});
dashboard.loadDashboard();Note: A summary block is required to customize the title due to a known issue in version 12.1.5.
enableAiSummary
boolean
Specifies whether to show or hide the dashboard and widget summary option. Requires the enabledmember API.
falseembedAiAssistant.summary.enabled.Example (Before Version 12.1)
var dashboard = BoldBI.create({
embedAiAssistant: {
enableAiAssistant: true,
enableAiSummary: true
}
});
dashboard.loadDashboard();Note: Please use the SDK and Bold BI server from the same version. Starting from version 12.1, the AI Assistant settings are restructured. Use the
enabledandsummaryobjects as shown below.
var dashboard = BoldBI.create({
embedAiAssistant: {
enabled: true,
summary: {
enabled: true
}
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the AI Dashboard Summary option in the dashboard banner. Requires both enableaiassistant and enableAiSummary member APIs.
falseembedAiAssistant.summary.includeDashboardSummary.Default value
Example (Before 12.1)
var dashboard = BoldBI.create({
embedAiAssistant: {
enableAiAssistant: true,
enableAiSummary: true,
enableDashboardSummary: true
}
});
dashboard.loadDashboard();Note: Please use the SDK and Bold BI server from the same version. Starting from version 12.1, the AI Assistant settings are restructured. Use the
includeDashboardSummaryandsummaryobjects as shown below.
Example (From 12.1 onwards)
var dashboard = BoldBI.create({
embedAiAssistant: {
enabled: true,
summary: {
enabled: true,
includeDashboardSummary: true
}
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the AI Widget Summary option in the widgets. Requires both enableaiassistant and enableAiSummary to be set.
falseembedAiAssistant.summary.includeWidgetSummary.Example (Before 12.1)
var dashboard = BoldBI.create({
embedAiAssistant: {
enableAiAssistant: true,
enableAiSummary: true,
enableWidgetSummary: true
}
});
dashboard.loadDashboard();Note: Please use the SDK and Bold BI server from the same version. Starting from version 12.1, the AI Assistant settings are restructured. Use the
includeWidgetSummaryandsummaryobjects as shown below.
Example (From 12.1 onwards)
var dashboard = BoldBI.create({
embedAiAssistant: {
enabled: true,
summary: {
enabled: true,
includeWidgetSummary: true
}
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the AI Data Usage icon in the AI Assistant window. Requires the enableaiassistant to be set.
falseExample
var dashboard = BoldBI.create({
embedAiAssistant: {
enableAiAssistant: true,
//enabled: true, //Please use this property from v12.1
hideAiDataUsage: true
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the CSV export option.
trueExample
var dashboard = BoldBI.create({
exportSettings: {
showCSV: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Excel export option.
trueExample
var dashboard = BoldBI.create({
exportSettings: {
showExcel: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Image export option.
trueExample
var dashboard = BoldBI.create({
exportSettings: {
showImage: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the PDF export option.
trueExample
var dashboard = BoldBI.create({
exportSettings: {
showPDF: true,
}
});
dashboard.loadDashboard(); boolean
Displays or hides the dashboard localization dropdown in the dashboard banner.
falseLocalize Dashboard option in the Bold BI Server dashboard designer. The dropdown is visible by default; use hideLanguageDropdown to hide it.Example
var dashboard = BoldBI.create({
languageSettings:{
hideLanguageDropdown: true,
}
});
dashboard.loadDashboard(); string
Contains the value to change the dashboard’s localization during initial rendering.
"" (empty)Localize Dashboard option in the Bold BI Server dashboard designer to enable language changes via languageCode.Example
var dashboard = BoldBI.create({
languageSettings:{
languageCode: "fr-FR",
}
});
dashboard.loadDashboard();The localeSettings allows you to change the localization of the dashboard, modifying data based on the specified localization.
string
Holds the value to change the language of the dashboard, data source, or widget.
en-USExample
Note: The
fr-FRlanguage file has been generated in the Bold BI Server installed location.
var dashboard = BoldBI.create({
localeSettings:{
appLocale: "fr-FR",
}
});
dashboard.loadDashboard(); string
Holds the value to change the dashboard’s culture, affecting formats like currency.
en-USAuto (English(en-US)). After setting a custom culture, the widget reflects the new format.Example
var dashboard = BoldBI.create({
localeSettings:{
culture: "en-US",
}
});
dashboard.loadDashboard();Additional Info:
- Default currency culture:
- Default grid view:
- Modified culture:
- Refer to Embedding In Your Application for setup steps. Use the
cultureSettingsAPI to adjust the culture post-embedding.
string
Customize the box shadow of the widgets.
"" (empty)Example
var dashboard = BoldBI.create({
widgetContainerSettings: {
boxShadow: "10px 10px lightblue",
}
});
dashboard.loadDashboard(); integer
Customize the margins of the widget with the corresponding integer values.
nullpx suffix; only integer values are supported.Example
var dashboard = BoldBI.create({
widgetContainerSettings: {
margin: 20,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Export icon in widget banner.
trueExample
var dashboard = BoldBI.create({
widgetSettings: {
showExport: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Clear Filter icon in widget banner.
trueExample
var dashboard = BoldBI.create({
widgetSettings: {
showFilter: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Maximize icon in widget banner.
trueExample
var dashboard = BoldBI.create({
widgetSettings: {
showMaximize: true,
}
});
dashboard.loadDashboard(); boolean
Specifies whether to show or hide the Option icon in widget banner.
trueExample
var dashboard = BoldBI.create({
widgetSettings: {
showMoreOption: true,
}
});
dashboard.loadDashboard();