Managing the navigation bar theme

In the Web Application interface of the beqom application, it is possible for an admin to define a default navigation bar theme (dark or light, dark being the default value). Once this theme is defined, it is applied for all users in the system.

This is a warning message.

This feature was introduced in Hotfix Package 69 (deployed October 13th, 2021). Its deployment includes an automatic migration to define a default navigation bar theme. The migration defines the navigation bar theme to the default theme for all users who have selected the "Dark" theme. While they will not see an impact upfront, any change to the default system theme by the admin will trigger a change of navigation bar theme for those users. There is no impact for users who were previously using the "Light" theme.

Defining the Default Navigation Bar Theme

Defining the Default Navigation Bar Theme Using the Web App User Interface

To define the default application theme, proceed as follows:

1. Open the "Appearance" page, located under (Undefined variable: CompoVariables_WA_Alternate."Admin") > General.

2. Select the theme of your choice in the Default Navigation Theme drop-down list:

• Light: when this setting is selected, the navigation bar is white with black labels.

• Dark: this is default setting. When this setting is selected, the navigation bar is black with light gray labels.

3. Click Save in the lower-right corner of the application window. The default navigation bar theme is saved for all users.

Defining the Default Navigation Bar Theme via API

To define the default navigation bar for the system, run the following API method:

Service	Action	Endpoint	Parameters	Body Sample
Gateway	POST	/api/Admin/SaveSettingsMng	Use -91 to define the default navigation bar theme	Copy {"json":"[{\"id\":-91,\"text\":\"light\"}]"}

Retrieving the Default Navigation Bar Theme Defined for a Tenant

To retrieve the default navigation bar theme defined for a given tenant, run the following API method:

Service	Action	Endpoint	Response
Gateway	GET	/api/Admin/GetGlobalParameterKVPs	In the call response, the parameter "Default Navigation Bar Theme returns the currently defined value.

Updating Users' Navigation Bar Theme in Bulk

You can update in bulk the navigation bar theme, for all users or a subset of users, by updating the navigationBarTheme column of the k_users_parameters to the required value:

• default: default navigation bar value set by the administrator

• dark: dark theme

• light: light theme

For instance, to update the navigation bar theme to the default theme for all users who are using the dark theme, run the following query on the table:

Copy

UPDATE k_users_parameters 
SET navigationBarTheme='default'
WHERE navigationBarTheme='dark'