For the complete documentation index, see llms.txt. This page is also available as Markdown.
Perspectives
Create and configure the Management Dashboard perspectives views.
The Perspectives Manager view is designed to further extend and customize the Management Dashboard. The view is available only to tenant administrators. Within this view, administrators can manage the available perspectives in the Emporix system, including customizing views, restricting access for particular user groups, or registering custom perspectives.
Perspective Manager view
The available tenant perspectives list appears in the perspective chooser for other Management Dashboard users with the appropriate access rights.
Perspective chooser
Restricting perspective access
For the already available perspectives, administrators can grant access to specific user groups, depending on their roles and needs.
1
Navigate to Perspectives Manager view
Go to the Administration -> Perspectives.
2
Select the perspective to edit
From the list, choose the available perspective which you want to restrict visibility for using the Edit icon.
3
Limit access to user groups
In the Allowed Groups field, expand the list to select the employee user group or multiple groups that you want to grant access to the perspective.
For more information how to create user groups and assign relevant permissions, see the Users and Groups.
4
Save the perspective
To persist the changes, choose Save on the perspective level.
Result: The perspective is available only to the selected groups. Users can switch between the perspectives they are assigned to with the perspective chooser.
If a user has access to only one perspective assigned, the perspective chooser is not displayed.
Registering a custom perspective
Administrators can register a custom perspective, which in essence is a Management Dashboard extension. This way, you can organize the Management Dashboard to better respond to users' needs.
1
Prepare a custom MD extension
Build and deploy your Management Dashboard extension with the logic you want to include.
To create an MD extension with all necessary dependencies, follow the instructions described in the Enabling custom extensions.
2
Add an extension as a perspective
Go to the Administration -> Perspectives and choose + to add a new one. Provide the required details:
Name - the displayed name of the perspective
URL Path - the part of the URL that directs to the perspective, it must start with the slash /.
Module URL - the URL where the module/extension is deployed, it must point to the module's remoteEntry.js file for module federation.
Module Name - the federation scope name from the remote's module vite.config.js file.
Add a perspective
Select the Active toggle and confirm your changes with Save to close the form.
3
Save the perspective configuration
Choose Save at the Perspectives Manager level to persist all your changes and make the module available from the perspective chooser.
Additional options
When editing or adding perspectives, there are some additional options available.
Discard - Use to dismiss any changes you've made when you are modifying or adding a perspective.
Discard option
Reset to default - Use when you have already saved the modified or added perspectives to the Management Dashboard, but for any reason you'd like to return to the default setup and use the standard perspectives provided in the Management Dashboard. Note this is irreversible.
Reset to default state
You can deactivate the navigation menu in the perspective view so that it doesn't disturb the view. Activate the Hide Sidebar toggle.
