...
While it is possible for users to create and customize their own dashboards, it can also be advisable to provide several predefined dashboards through the configuration so users don't have to construct common dashboards themselves. While user-defined dashboards are stored in the user settings, predefined dashboards are configured through a dashboards.ini file, which is a root config file. To share the preconfigured dashboards with other operation clients (OCs), dashboards.ini needs to be included in the otherRootConfigFiles element of the clientConfig file. An example is provided below. For further information, please refer to the clientConfig Wiki page.
<otherRootConfigFiles> <name>patch.jar</name> <name>fews-splash.jpg</name> <name>oc_delft_global.properties</name> <name>dashboards.ini</name> </otherRootConfigFiles>
Predefined dashboards will be shown in a separate section of the dashboards menu than user-defined dashboards. In the example below there is one predefined dashboard present in the system "BE Creation", and one user-defined dashboard called "My Custom Dashboard".
...
| user-defined | predefined | |
|---|---|---|
| sharing | user specific, can't be shared between usersshared through userSettings | shared between all users and the same for all users |
| creator | created by a user | created / configured by a configurator |
| customization | can be customized by the user, i.e., frames can be added / removed, frame titles can be changed, frames can be deleted | can not be customized, i.e., no new frames can be added, if a frame is closed the change won't persist when reopening the dashboard, frame titles can't be changed |
| storage | stored in the user_settings.ini file | stored in the dashboards.ini file |
...