initialRootComponent (default home page)

The top-level initialRootComponent property in settings.home-page-config.json specifies one or more default home pages - the page that users see when they open the One MI application.

To show the same initial home page to all users, simply specify the name of the component which defines the home page, for example:

"initialRootComponent": "SampleHomePage"

All users who log in will see this home page (access control properties may be applied to the component that defines the home page to prevent it from being shown to unauthorized users).

It is also possible to show different default home pages based on a user's membership of a local or domain Active Directory (AD) group that is mapped to one of the 5 Granta MI system security groups. For this, you map the name of the component which defines the home page to one of 6 role keys:

"initialRootComponent": {
  "admin": "component_name",
  "grant": "component_name",
  "powerUser": "component_name",
  "write": "component_name",
  "read": "component_name",
  "unset": "component_name" }
        

Key	Description
admin	Users who are members of the Admin system security group
grant	Users who are members of the Grant system security group
powerUser	Users who are members of the Power User system security group
write	Users who are members of the Write system security group
read	Users who are members of the Read system security group
unset	Users who are not members of any Granta MI system security group

The same home page can be mapped to more than one key. For example, the config below maps the 6 role keys to 4 separate home page definitions, one for Admin users, one for Read users, one for Write, Grant, and Power users, plus one more for unauthorized users:

"initialRootComponent": {
  "admin": "AdminUsersHomePage",
  "grant": "Write+UsersHomePage",
  "powerUser": "Write+UsersHomePage",
  "write": "Write+UsersHomePage",
  "read": "ReadUsersHomePage",
  "unset": "UnauthUsersHomePage" 
  }