Configuring application switcher (Nomad for web browsers)
Application (app) switcher is an optional, configurable dropdown menu displayed on the left of HCL Nomad for web browsers' navigation bar. Each app switcher menu entry shows an application icon followed by the application’s name. Clicking on an app switcher menu entry navigates to the corresponding application address in a new browser tab.
The configuration of the app switcher can be done even after HCL Nomad for web browsers has been deployed. The app switcher configuration is retrieved from the network each time the user loads Nomad. The cache is then updated with the latest version pulled. If Nomad were to enter Offline mode, the last cached version of the app switcher configuration is used.
How to configure app switcher?
Where is the app-config.json file?
App switcher can be configured in the app-config.json file. A template of the app-config.json file, named app-config-template.json, can be found in the config folder on the root path of the HCL Nomad for web browsers' source folder.
To configure app switcher, make a copy of the app-config-template.json file and name it to app-config.json. Then customize the app-config.json file based on the information in the section below.
Once deployed, the app-config.json file should be accessible
from the same common path as where HCL Nomad for web browsers is deployed. For
example, if HCL Nomad for web browsers’ URL is https://example.org/nomad/index.html, then app-config.json should be accessible from
https://example.org/nomad/config/app-config.json.
Configure the app-config.json file for the app switcher
appSwitcher and add
the attributes below:| Attribute | Type | Description |
|---|---|---|
| visible | Boolean | Only show the app switcher when visible is true. |
| Apps | Array of app objects | A list of applications to show in the app switcher's dropdown menu. |
| Attribute | Type | Required | Description |
|---|---|---|---|
| label | String | Yes | Application name |
| URL | String | Yes | Application https URL |
| icon | String | No | Predefined icon name or customized icon URL to show in front of the application name. Predefined icons are Verse, Volt, Sametime, Connections and Nomad. Refer to the section below if you want to use customized application icons. A default icon will be used when the icon attribute is not given. |
Use a customized icon
To use a customized icon, set the icon’s URL or Nomad local path in the icon attribute.
The icon needs to be served via the HTTPS protocol and if the icon is hosted in a different origin, the response MUST have one of the following HTTP headers to be displayed: Access-Control-Allow-Origin: https://mynomadserver.mydomain.com or Cross-Origin-Resource-Policy: cross-origin. Access-Control-Allow-Origin is associated with CORS (Cross Origin Resource Sharing) and generally aligns best with the purposes here.
The Nomad local path would be to put a copy of the image file in the Nomad's /config folder on the server (same location as the app-config.json file itself) and then specify the path to the file (for example, "/nomad/config/pathtoicon.png") as the value of icon. If you want to specify a sub-folder for these images under /config, that is an option too.
.notes::// links. For more information, see Configuring notes.ini customizations.