Configuring Properties

The content, appearance and some features of ENOVIA Variant Configuration Central and the ENOVIA Product Line Management shared component are configured through their respective properties files, emxConfiguration.properties and emxProductLine.properties.

Note: For information about the emxConfigurationMigration.properties file, used to configure the migration of V6R2012x databases to V6R2013 if there are custom schema definitions, see About Custom Migration.

Each file contains detailed comments about how to use the properties. A property value only needs to be changed if you do not want to use the default behavior defined by it. You can configure additional properties such as the login page using properties files called emxLogin.properties and emxSystem.properties, located in the SERVERHOME/managed/properties/ directory. For information about these files, see the Live Collaboration - Server Administration Guide.

Before you begin: Locate the ENOVIA Variant Configuration Central properties file, emxConfiguration.properties, and the ENOVIA Product Line Management properties file, emxProductLine.properties, in SERVERHOME/managed/properties/. The properties files for all ENOVIA applications are located in the SERVERHOME/managed/properties/ directory.
Related Topics
Migration Property File Settings
Configuring the ImageMagick Tool
Configuring Timeline Chart Properties

  1. To set the default build type that is used during build creation, follow these steps:

    1. Locate this line in the emxProductLine.properties file:

      emxProductLine.Build.CreateBuild.DefaultType=Hardware Build

    2. Set the value of this property to either Hardware Build or Software Build.

  2. To set the maximum number of builds that can be generated from a single build creation, follow these steps:

    1. Locate this line in the emxProductLine.properties file:

      emxProductLine.Build.CreateBuild.NumberLimit=100

    2. Set the value of this property to a whole number. This value corresponds to the maximum value that can be entered in the Number of Builds field in the Create Build page.

  3. To use check boxes to indicate which features are included in a product variant or revision in the Effectivity Matrix page, follow these steps:

    1. Locate this line in the emxConfiguration.properties file:

      emxConfiguration.ViewEffectivity.FeatureUsage=true

    2. Set the value of this property depending on your preference.


      • true. feature usage values (Standard, Optional, or Mandatory) are used to indicate which features are included.
      • false. check boxes are used to indicate which features are included.

  4. To make equipment features visible and available for selection when creating an Effectivity Matrix or previewing a BOM, follow these steps:

    1. Locate this line in the emxConfiguration.properties file:

      emxConfiguration.Feature.EquipmentFeatureOption=false

    2. Set the value of this property depending on your preference.


      • true. equipment features are visible and available for selection.
      • false. equipment features are not visible or available for selection.

  5. To prevent System Engineers from replacing parts in the GBOM part table for features in the Released state, follow these steps:

    1. Locate this line in the emxConfiguration.properties file:

      emxConfiguration.GBOMPartUpdateAllowedForReleasedFeature=true

    2. Set the value of this property depending on your preference.


      • true. System Engineers can replace parts in the GBOM part table for features in the Released state using an Engineering Change (EC) in the Active state.
      • false. the Replace command is disabled for features in the Released state.

  6. To set the maximum number of alphanumeric characters that can be used for the Product Prefix attribute defined for a model and inherited by those products and product configurations related to that model, follow these steps:

    1. Locate this line in the emxProductLine.properties file:

      emxProductLine.Model.ProductPrefixLength=3

    2. Set the value to a whole number.

  7. To configure the thresholds for the different selection methods provided for selecting the options for features when creating a product configuration, follow these steps:

    1. Locate the following lines in the emxConfiguration.properties file:

      emxProduct.ProductConfiguration.DropDownLimit = 4

      emxProduct.ProudctConfiguration.ChooserLimit = 20

      emxProduct.ProductConfiguration.DatabaseChooserLimit = 30

    2. Set the values to whole numbers.

      The different selection methods include radio buttons, drop-down lists, new windows, or opening a search page. The default values mean if the number of choices is 1 to 3, radio buttons are used. If the number of choices is 4 to 19, a drop-down list is used. If the number of choices is 20 to 29, a new window opens with the choices and a name filter is provided. If the number of choices is 30 or more, the Search page opens where you can search for options for the feature. In all scenarios, the options are restricted according to the rule conditions on that feature.

  8. To specify the maximum value length of a field that is permissible for any field in the create dialogs, especially the object Name fields, follow these steps

    1. Locate this line in the emxConfiguration.properties file:

      emxProduct.MAX_FIELD_LENGTH = 100

    2. Set the value to a whole number.

  9. To configure the number of days which determines the threshold value to display the slip days icon on the builds list page, follow these steps:

    1. Locate the following lines:

      emxProduct.Build.IconRedDays = 5

      emxProduct.Build.IconGreenDays = -2

    2. Set the value to a whole number.

      If the actual build date is greater than the planned build date by the number of days set for IconRedDays, it displays the red icon. If the actual build date is less than the planned build date by the number of days set for IconGreenDays, it displays the green icon. For any case in between these it displays the yellow icon.

  10. After making changes to any properties file, you must restart the application server for the changes to take effect. In a J2EE environment, you must also run the warutil and deploy the archive file. You should also save backups of any properties file that you configure.