Configuring the Sidebar and Settings App
The sidebar of the Hub shell is configured using the applications.json file.
#
Adding an Application EntryPerform the following steps in the Frontend-packages. Refer to the API Reference for complete configuration options.
Add an
applications
entry topackages/config/applications/applications.json
.Your changes to this file should be able to be promoted to further environments if at all possible. If you do not want your application to appear beyond a certain environment you can use the
environmentToggleLevel
parameter.Add a group entry to
packages/config/applications/applications.json
.Depending on the needs of your application, you will need to add its
id
to groups under any number of the following locations:Key applicationGroups
Parent entity that has neither the Company
orMasterEntity
role.
Eg. iQmetrix usersapplicationGroupVariations.Company
Parent entity with the Company
role.applicaitonGroupVariations.MasterEntity
Parent entity with the MasterEntity
role.If you are adding new permissions, you will need to add the permission to permissions.json.
Create a pull request and have your team review and merge it.
#
Releasing ChangesChange Management
Releasing applications.json must be treated like releasing any other project and follow Change Management processes, including having it's own release tickets.
applications.json
is deployed from the frontend-packages using Azure DevOps Pipeline. Merging a change will trigger a build and a release into INT
automatically. You can find the steps in the applications.json api document.
If you've added new permissions, you will also need to release it using Azure. More info in the permissions.json api document.