User Interface Customization in Bold BI Embedded Analytics

This section explains how to customize the Bold BI application user interface by adding custom menus, listing menu items, showing previews, etc. through a configuration file.

NOTE: This feature is available in On-Premises Deployment, but not in Syncfusion Managed Cloud Server.

You can make your own selections about what you want to see or set preferences for how information is organized or displayed.

Configuration for layout customization

Steps to open and edit the custom_ui.json file to customize the user interface:

Go to the UMS Settings page.

Example: http://{yourdomain}/ums/administration
Select the Configuration tab from the settings menu and choose custom_ui.json from the Search your files drop-down.
Fill in the required fields in the file and Save.
Restart the application and access the site. Refer to this link to learn how to restart the Bold BI application.

Custom UI JSON

The Custom UI JSON file contains the following fields that are used to customize the UI in the Bold BI application:

Sites
Profiles
Preview pane
Schemes
Custom menus

Sites

You need to provide the site name and matching profile name that you want to customize the UI for.

Sites

Profiles

This section contains a list of default left side menu options and custom menus.

profiles

Profile syntax

	  "Profiles": [
		{
		  "Name": "profile1",
		  "Dashboards": {
			"ShowMenu": true,
			"SamePagePreview": false,
			"Order": 1,
			"Scheme": ""
		  },
		  "Datasources": {
			"ShowMenu": true,
			"Order": 2,
			"Scheme": ""
		  },
		  "Schedules": {
			"ShowMenu": true,
			"Order": 3,
			"Scheme": ""
		  },
		  "Slideshows": {
			"ShowMenu": true,
			"Order": 4,
			"Scheme": ""
		  },
		  "Pinboards": {
			"ShowMenu": true,
			"Order": 5
		  },
		  "Publish": {
			"ShowMenu": true,
			"Order": 6
		  },
		  "Users": {
			"ShowMenu": true,
			"Order": 7
		  },
		  "Settings": {
			"ShowMenu": true,
			"Order": 8
		  },
		  "Notifications": {
			"ShowMenu": true,
		  },
          "Profile": { 
            "ShowMenu": true, 
            "ShowYourSites": true, 
            "ShowManageSite": true, 
            "ShowMyProfile": true, 
            "ShowLogout": true
          },
		  "Help": { 
			"ShowMenu": true 
		  },
		  "CustomMenu": [
			{
			  "Name": ""
			}
		  ]
		}
	  ]

Name: Provide the name of the profile that will be used to specify the profile on the sites.
ShowMenu: Determines whether that specific left side menu option should be shown or hidden.
Order: Determines the position of the specific menu option.
Scheme: Provide the matching scheme name. The scheme will be used to customize the options in the item listing and the context menu.

Preview pane

You can preview the dashboards on the right side of the dashboard listing by using the SamePagePreview property in the configuration file.

SamePagePreview

Schemes

The scheme can be used to show or hide the context menu items in the item listing pages. These options are available on dashboards, slideshows, schedules, and data sources pages.

Schemes

For example, you can display the Get Link option in the context menu by setting the GetLink property to true, and also mentioning the corresponding scheme name in the profile.

You can add new menu items that you want to display in the left side menu along with the default side menu items.

Name: Specify the name of the scheme. This can be used to identify the scheme in the profiles.
Display: Name that should be shown in the menu item.
Order: Position of the menu item when displayed in the left side menu bar.
ImageLink: URL of the image to be displayed in the menu item.
OpenLink: URL of the site/page to navigate to when the menu item is clicked.
OpenBehavior: Determines whether the custom menu page opens in the same page or in a new tab.
ShowMenu: Determines whether the custom menu is visible or hidden.