NX User Preferences Override Mechanism

2021-10-06T23:28:03Z
NX for Design

Summary


Details

User Preferences in file UserPreferences.txt have replaced the registry entries, 
but how can we handle this at a Site and Group Level.




Solution

Preferences Override Mechanism


 
This change introduces the mechanism to override User preferences in NX. Along with User preferences, we are now introducing Group and Site preferences which are read after the user preferences are read. Group preferences override user preferences, and site preferences override both group and user. The 2 environment variables that are used for this purpose are UGII_GROUP_DIR and UGII_SITE_DIR for group and site respectively. The preference file to be kept in group must be named as "GroupPreferences.txt" and placed under UGII_GROUP_DIR\startup folder whereas the preference file to be kept under site level must be named as "SitePreferences.txt" and should be placed under the UGII_SITE_DIR\startup folder.


A general workflow on how to create Group and Site preference files is as follows:


1.       Launch NX
2.       Set necessary preferences in the NX session that you want to override
3.       Exit NX
4.       NX session changes will now be reflected in "UserPreferences.txt" located in 
         the user profile directory.
5.       Copy the "UserPreferences.txt" file and rename it to "GroupPreferences.txt" or "SitePreferences.txt" depending on the level at which you want to override the preferences. Required manual changes to the preference file can also be done. Syntax of these files should be same as that followed by the "Userpreferences.txt".
6.       Put the "GroupPreferences.txt" and "SitePreferences.txt" file in UGII_GROUP_DIR/startup and UGII_SITE_DIR/startup respectively.


Two additional features supported now are key and value-pair deletions. If a key must be deleted, then prefix the key name with a hyphen, as follows:


[-HKEY_CURRENT_USER\Software\Unigraphics Solutions\NX\1926\SampleKey…..] 


If a value under a key must be deleted, then simply use a hyphen in place of its data as shown below:


[HKEY_CURRENT_USER\Software\Unigraphics Solutions\NX\1926\SampleKey…..] 


"SampleValue"=-


Note that there should not be any white spaces before\after the hyphen.


Another point to note is that main key deletion is not supported, i.e. in old windows registry-based usage of NX configurations, a clean slate NX session could be launched by first deleting the main key. An example of the main key, say for NX 1926, would be:


 HKEY_CURRENT_USER\Software\Unigraphics Solutions\NX\1926


 But since we don't support a tree-based structure for the keys as done in windows registry, deletion of such a key would not work. Clean slate NX launch is now done by manually deleting the "UserPreferences.txt" file in user profile directory.



Hardware/Software Configuration

Platform: all
OS: n/a
OS Version: n/a
Product: NX
Application: GATEWAY
Version: V1926
Function: PREFERENCES

Ref: 002-8559772

KB Article ID# PL8559772

Contents

SummaryDetails

Associated Components

Modeling