One MI settings

Application configuration settings for the One MI web application are configured on the One MI page in MI Settings.

Application main menu configuration

This setting contains JSON that defines the One MI application main menu.

As well as integrated Granta MI applications, this menu can also be configured to include links to the standalone Granta MI Viewer web application, or to web pages, such as company procedures, wiki pages, or training resources.

For details of how you can modify this setting to customize the available menus for your Granta MI users, refer to One MI application configuration in Granta MI Administration and Configuration.

Application integration settings, and global UI preferences

Specifies configuration settings and number format and language preferences that apply to all of the applications in One MI.

Syntax:

{
    "configPaths": {
        "bomAnalyzer": "BomAnalyzer",
        "explore": "Explore",
        "homePage": "HomePage"
    },
    "preferences": {
        "language": {
            "defaultValue":"cn|de|en|fr|ja|ko|ru",
            "userEditable":true|false
        },
        "numberFormatting": {
            "defaultValue": {
                "groupSeparator": [ 
                    "symbol", 
                    "symbol",
                    ... 
                ],
                "decimalSeparator": [ 
                    "symbol", 
                    "symbol", 
                    ... 
                ]
            },
            "userEditable":true|false
        }
    }
}
configPaths
Specifies the location of application configuration files for MI Explore, MI BoM Analyzer, and the One MI home page.
preferences
Defines default language and number format preferences for the all applications in One MI, including the Home Pages, and whether or not these defaults can be changed in Edit Preferences > Edit Global Preferences. A change to global preference will change it in all of the applications available in One MI.
language

Specifies the default user interface language, and whether or not this can be changed.

  • defaultValue specifies the default language. Supported languages are: Chinese, German, English, French, Japanese, Korean, and Russian.
  • userEditable enables or disables the ability to choose a different UI language in Edit Global Preferences. When true, users can choose their preferred language. When false, users cannot change the default language.
numberFormatting

Defines number formatting options for all One MI applications.

  • defaultValue specifies the number formatting options that are available in Edit Global Preferences, and which are selected by default.
    • groupSeparator specifies a list of characters that can be used as the thousands separator in digit grouping, for example, space, comma, or none.
    • decimalSeparator specifies a list of characters that may be used to separate to separate the integer part from the fractional part of a number, for example, period or a comma.
    • The same symbol cannot be used for both the group and decimal separator.
    • The first symbol listed in each case is the default option for the application.
  • userEditable enables or disables the ability to choose a different decimal separator or group separator in Edit Global Preferences. When true, users can choose a different separator. When false, users cannot change the default separator character.

Application-specific UI preferences

Defines application preferences for MI Explore, MI BoM Analyzer, MI Material Calibration, and the One MI Home Page.

Syntax:

{
    "application_key": { 
        "Preferences": {
            "unitSystem": {
                "defaultValue": "unit_system_name",
                "userEditable":  true | false
            },
            "viewerDatasheetButtonEnabled": true | false
        }
    }
}
application_key

Identifies the application. The value must be one of: bomAnalyzer, explore, homePage, materialCalibration.

preferences
Defines UI preferences for the specified application
Name Value
unitSystem

Specifies the default unit system for the application, and whether or not this can be changed in Edit Preferences > Edit Application-level Preferences.

  • defaultValue specifies the name of the default unit system.
  • userEditable enables or disables the ability to choose a different default unit system in the application preferences. When true, users can choose a different default unit system. When false, users cannot change the default unit system.
viewerDatasheetButtonEnabled

This option applies to MI Explore only.

  • When true, users can open MI Viewer directly from embedded datasheets.
  • When false, users cannot open MI Viewer directly from embedded datasheets.
Note: The default value for this option is false. It will be reset to the default value when Granta MI is upgraded.

Application home page configuration

Defines the One MI home page that users see when the application opens. For information about how you can modify this setting to customize the home pages available to Granta MI users in your organization, refer to One MI application configuration in Granta MI Administration and Configuration.

Users who can export data to Excel

Specifies the Windows Active Directory groups or User Manager Roles whose members are permitted to export data from Granta MI to Excel using MI Export. Local Windows Active Directory group names should not include the local computer dot backslash ( .\ ) prefix here.

Members of the specified groups or roles can:
  • Launch MI Export from an Export Data to Excel option in MI Viewer and MI Explore.
  • Run export jobs in the One MI Export app, and download exported workbooks.
  • Users with MI Data Administrator privileges will also see an Export option on the One MI toolbar, providing easy access to template management options.
Note: Export Data to Excel in MI Explore is only available when exportersDisabled is set to false in the data view configuration, see Granta MI Administration and Configuration for details.

If exportersDisabled = true, users won't be able to export data to Excel from MI Explore, even if they are members of one of the groups specified in Users who can export data to Excel.

One MI application server alternative machine names

Specifies each hostname and FQDN at which a user might access One MI. This should include both the hostname and the fully-qualified domain name (FQDN). You do not need to include the protocol (http, https). For example:

myhostname,myhostname.mydomain.com

If using User Manager, include each of those machine names again with the User Manager port number appended (by default, port 9000). If the hostname and port are not included, then MI Server will refuse requests with a CORS error, causing access issues in the One MI application.

myhostname,myhostname.mydomain.com,myhostname:9000,myhostname.mydomain.com:9000