Edit Preferences

Creo Elements/Direct Model Manager Customization Guide > XML Customization > How to > Edit Preferences

Edit Preferences

Many user preferences can be customized in your xml file, but not all - the remaining preferences are configured in Java code.

Preferences configured in wmconf.xml

Preference	<Key>
Advanced BOM Versions	ADVANCED_BOM_VERSIONS
Allow reserve/unreserve of previous version of Models in Modeling	ALLOW_UNRESERVE_OR_RESERVE_OLD_MODELS
Refresh status after load or save	AUTO_REFRESH_STATUS
Automatically renumber children when saving BOM	AUTO_RENUMBER_WHEN_SAVING
Automatically resort position numbers	AUTO_RESORT_POSITIONS
Clear old notifications on refresh	CLEAR_NOTIFCATIONS
Copy link attributes when creating splits	COPY_LINK_ATTRIBUTES_FOR_SPLITS
Display the user full name for values containing the user name	DISPLAY_USER_FULL_NAME
Enable BOM Versions	ENABLE_BOM_VERSIONS
Generate unique position numbers for BOM reports	GENERATE_UNIQUE_POSITION_NUMBERS
Load containers	LOAD_CONTAINERS
Load root item using default load rule	LOAD_ROOT_USING_LOAD_RULE
Scan using model files (DDM data support)	PB_PUB_BOM_SCANNING
Preserve duplicate position numbers while automatically renumbering children during BOM save	PRESERVE_DUPLICATE_POSITION_NUMBERS_DURING_BOM_SAVE
Send To CSV uses UTF-8 character set	SEND_TO_CSV_USES_UTF8
Set locked, changed assemblies as modified	SET_LOCKED_CHANGED_ASSEMBLIES_AS_MODIFIED
Show Copy BOM attributes dialog	SHOW_COPY_MASTERDATA_LINK_ATTRIBUTES_DLG
Show save UI	SHOW_SAVE_UI
Renumber using last position number values	USE_LAST_POSNO_VALUES
Use same position number for splits	USE_SAME_POS_FOR_SPLITS
Use SYS IDs for Versioning	USE_SYS_IDS_FOR_VERSIONING
Allow related files to be deleted	ALLOW_DELETE_RELATED_FILES
Load Stock Parts	LOAD_STOCK_CONTAINERS

Only boolean preferences can be set in the XML file. The value of the preference will become the label.

• <Group>

The <Group> child tag defines the group in which to place the preference. If the group name matches an existing group, the preference is added to that group. Otherwise a new group is created and the preference is added to that group.

• <Key>

The <Key> child tag defines the key used by the system to track the preference. If <Key> is not specified, the preference name is used.

Values for the <Key> tag can be found in the JavaDoc for the UserProfile class.

• <DefaultValue>

The <DefaultValue> child tag may be set to true or false to define whether the preference is checked or unchecked by default. If <DefaultValue> is not specified, the default value is false.

• <Reset>

The <Reset> child tag may be set to true or false to define whether the preference should be reset when Creo Elements/Direct Model Manager is restarted. If not specified, the default value is false.

• <Protect>

Use the <Protect> tag to prevent the user from changing the default setting for the property. If <Protect> is true, the preference is grayed out and cannot be changed by the user.

These settings are stored in the database. Use UserProfile.getUserProfile(),getBooleanProperty(key) to retrieve the current setting for the property.

Change the behavior of an existing preference

You can configure existing preferences to change their default behavior. For example, you can control whether a preference resets by using the <Reset> tag. You can prevent a user from changing a setting by including the <Protect> tag and setting it to true.

1. Copy the desired preference from the <Options> section of wmconf.xml to the <Options> section of your custom xml file.

2. Modify the settings for <DefaultValue> or <Protect> to control how the preference displays in the Preferences dialog and whether you can change the value.

3. By default, preferences are reset when Creo Elements/Direct Model Manager restarts. Add the <Reset> tag and set it to false if you want the preference to not be reset.

Was this helpful?