emxSystem.properties for Configurable UI Components

The properties in this table can be edited to configure the ENOVIA Business Process Services applications for your business processes. These properties work with configurable UI components.

Related Function Property Name
Allowed Values Description
Configurable Form 
eServiceSuiteSpecificationCentral.UIForm.ValidationFile = <JS file name>
Enter the name of the JavaScript file or JSP file.

For example:

eServiceSuiteLibraryCentral.UIForm.ValidationFile = 
emxLibFormValidation.js 
eServiceSuiteLibraryCentral.UIForm.ValidationFile = 
emxLibTSValidation.jsp

The same file cannot be used for validation in indented tables because for indented tables, the <script language="JavaScript"> and </script> tags should not be present in the validation .jsp file.

Specifies a JavaScript file with custom methods for validating form fields. For more information, see Validating Form Field Data. 
emxFramework.UIForm.Checkbox.BooleanValues=yes/no,true/false,on/off
Enter a a comma-separated list, with each value providing 2 values that map to the boolean values of true and false. Defines the system-wide values that will be treated as Boolean when working with check boxes and radio buttons on a webform. 
emxFramework.FormCalculations.DecimalPrecision=5

Deafult = 5, and you can define any positive numeric value. The same precision is used for all calculations for all forms.

 Defines how a webform rounds the calculations off to the number of decimal points. Depending on the ENOVIA products you use, the form page may perform numeric calculations, such as averages or totals. 
emxFramework.RenderPDF=false 
emxFramework.RenderPDF.ShowIconByDefault=false
emxFramework.RenderPDF.WaterMark=false
emxFramework.RenderPDF.Port=
emxFramework.RenderPDF.HostName=
emxFramework.RenderPDF.UserName=
emxFramework.RenderPDF.Password=
emxFramework.RenderPDF.FTPInputFolderPath=
emxFramework.RenderPDF.FTPOutputFolderPath=
emxFramework.RenderPDF.SleepInterval=1
emxFramework.RenderPDF.RetryTimeOutLimit=60
emxFramework.RenderPDF.CleanupOnRestart=false
For details on all PDF rendering properties, see Configuring PDF Rendering. Controls PDF rendering when AdLib is installed. 
emxFramework.Charset.ja=Shift_JIS
emxFramework.Charset.zh-tw=UTF-8 
emxFramework.Charset.zh-cn=UTF-8
emxFramework.Charset.ko=ISO-2022-KR
emxFramework.Charset.en=UTF-8
emxFramework.Charset.fr=UTF-8
emxFramework.Charset.de=UTF-8
emxFramework.Charset.it=UTF-8
emxFramework.Charset.es=UTF-8
emxFramework.Charset.pt=UTF-8
  Defines the character set used for PDF rendering when the language is set to a number of languages.

The properties use these character abbreviations:

ja--Japanese

zh-tw--traditional Chinese

zh-cn--simplified Chinese

ko--Korean

en--English

fr--French

de--German

it--Italian

es--spanish

pt--Portuguese

Configurable Structure Browser 
emxFramework.SBTableCalculations.DecimalPrecision=5

The default value is 5, and you can define any positive numeric value. The same precision is used for all calculations for all structure browsers, but can be overridden for a specific column using the Decimal Precision setting when defining the column. See Table Column Calculations for details.

 define the number of decimal points that the structure browser rounds calculations off toDepending on the ENOVIA products you use, the structure browser component may perform numeric calculations, such as averages or totals, on structure browser columns. 
emxFramework.UIFreezePane.Checkbox.BooleanValues=yes/no,true/false,on/
off
Specify a comma-separated list, with each value providing 2 values that map to the boolean values of true and false.

Defines the system-wide values that will be treated as Boolean when working with check boxes and radio buttons in a structure browser

 
emxFramework.FreezePane.ExpandInSingleQuery=false

  • true. all expands return the objects in all levels in a single query. The JPO to execute the expand must return expandMultiLevelsJPO=-true, and must be written to return the full list of expanded objects.
  • false (default). If expandMultiLevelsJPO = true, the expand returns all objects in a single query. If expandMultiLevelsJPO = false, the expand iterates through each node expanding one level at a time.
 Defines if the page expands all selected levels in a single query to the database, or iterates through the nodes expanding one level at a time.

This property applies when expanding the tree in the structure browser using a custom JPO.

All expands using the type and relationship filters continue to return the objects in all levels in a single query. 

emxFramework.Freezepane.view=details

  • details (default). Users cannot change the view of the structured data.
  • details,thumbnails. Users can choose between details and thumbnails to view the structured data.
 Defines the available views for structure browser pages.

This value can be overridden by passing the view URL parameter to the specific structure browser page.

 
eServiceSuiteAPPLICATIONNAME.UIFreezePane.ValidationFile = VALIDATIONFILENAME
where VALIDATIONFILENAME is either .js or .jsp. For example:
eServiceSuiteEngineeringCentral.UIFreezePane.ValidationFile =
emxEngineeringCentralSBValidation.jsp

Specifies a JavaScript file with custom methods for validating cell values. This file can contain methods called using the applyURL URL parameter optionally called when a user clicks Apply after editing in a structure browser.

 
emxFramework.ThumbnailView.fieldcount = 3

Default = 3.

Defines the number of lines (one line per column) to display beneath the thumbnail (when the structure browser is shown in Thumbnail view).

The columns that display as lines beneath the thumbnail have the Display View=thumbnail setting defined, or, if no columns have this setting, then the structure browser uses the first n (the value for this setting) columns. If a structure browser has more columns defined with this setting than the number set here, only this number of lines displays on the page.
Configurable Tables 
emxFramework.Table.Type=new

  • new (default). The system converts table components to structure browser components (emxIndentedTable.jsp).
  • classic. Pages use emxTable.jsp and emxTableEdit.jsp as configured.
 Specifies if pages defined using emxTable.jsp or emxTableEdit.jsp should be converted to use emxIndentedTable.jsp.

When set to new, this property can be overriden by passing the tableType=classic URL parameter to the table component. See Table-to-Structure Browser Conversion for details.

 
emxFramework.PaginationRange = 10

The default value is 10.

Defines the number of rows in a table per table page .For example, if you set the property to 15, the system creates a new page for the 16th row and users must use the pagination controls to see the 16th row. 
emxNavigator.UITable.Pagination.RememberSelection = true

  • true (default). The system remembers items selected across different pages in a paginated table (only table pages built using emxTable.jsp). If the user selects rows from several different pages within a table and then clicks a toolbar item to process the items, such as Remove Selected, the system processes selected items from all pages, not just the one that is currently displayed.
  • false. The system only remembers items selected on the current page.
 Controls selection of items across pages, This property defines the global setting, and can be overridden on a specific table page using the rememberSelection URL parameter for emxTable.jsp. 
emxFramework.Pagination.MaxNumberOfItems =

Assigning this property to any value less than 1 sets the pagination to have no maximum limit.

 Sets the maximum number of items allowed in table list pages when viewing the page with pagination off. 
emxNavigator.UITable.Style.List = styles/emxUIList.css 
emxNavigator.UITable.Style.Dialog = styles/emxUISearch.css
  Defines the style sheets to use for table pages.

The List style is for table pages that display in the content frame of emxNavigator.jsp. The Dialog style is for table pages that display in popup windows. The Style parameter, which can be passed to emxTable.jsp, determines whether the table pages uses the List or Dialog style sheet. For more details, see URL Parameters Accepted by emxTree.jsp.

 
emxNavigator.UITable.HeaderRepeat = 15

To turn off header repeat as the default, set this property to 0.

 Defines the default value for how often header rows repeat in configurable tables.

Headers in configurable tables will repeat based on this value unless the headerRepeat parameter is passed with a different value to emxTable.jsp.

 
emxFramework.Timing.LogFile =
To enable logging, assign a file name.

This property can be assigned to any file. For example, emxFramework.Timing.LogFile = /temp/ emxFrameworkTiming.log.

Defines the file to use for performance time logging. If the key is assigned to empty there will be no logging.

Currently the time logging is implemented only on the configurable table component for internal testing purposes and should not be turned on in a production environment.

 
emxFramework.ShowMassUpdate = true

  • true. Users can change multiple records with a single operation with the controls located in the header frame of the In-Cell Editing popup window. The massUpdate section in the TableEdit Header is shown in all cases.
  • false. The mass update tool is not available.

The default value is true.

 Enables or disables mass updating.

This property can be overridden by passing the parameter massUpdate=false to emxTableEdit.jsp or emxIndentedTable.jsp.

 
emxFramework.TableCalculations.DecimalPrecision = 5

By default, the calculated value is rounded to 5 digits after the decimal point if the result contains more than 5 digits after the decimal point. For example, if the calculated value is 25.1234562, then the value would be rounded to 25.12346.

 Defines how many digits should follow the decimal point when rounding calculations.

For total, maximum and minimum table column calculations, rounding is not done. Average, median (for columns with an even number of items) and standard deviation calculations involve division of numbers so rounding is done when needed.

 
emxFramwork.Table.ProgramColumn.HTMLEncode=true

  • true (default). HTML tags are processed as tags, no as text.
  • false. HTML tags are not processed and the programHTMLOutput column setting should be used.

For example, if a column heading contains this: 

<title>Section Title</title>

It displays in the column header like this: 

Section Title
 Defines if a table column that uses the program setting displays HTML code or processes the code.

If you need to display HTML code in a column header, use programHTMLOutput for the Column Type setting instead. See Settings for Table Column Objects.

 
emxFramework.UITable.Customization=enable

  • enable (default). A user can create a custom table from a list of visible and available columns. If a column is deleted from a system table, it is also deleted from all custom tables.
  • disable. Users cannot create their own views for tables
 Enables or disables the ability for users to define custom tables for all ENOVIA products. When enabled, these columns are available to users in addition to those shown in the default table:
  • All columns defined in the system table for the administrative object type but currently hidden.
  • All attributes for the object type except hidden attributes.
  • All basic properties defined by the emxFramework.UITable.Customization.Basic.InclusionList system property.
  • All attributes defined by the emxFramework.UITable.Customization.<type_name>.SelectExpression. InclusionList system property.
  • All attributes inherited from a parent administrative object.
  • For structure browser pages, all relationship attributes for the relationship used in the current structure. 
emxFram.ework.UITable.Customization.Attribute.ExclusionList
Enter any attribute names that you do not want users to add to custom table views. Explicitly excludes an attribute from being used in custom tables.

Access controls for the columns in the system table are carried over to custom table views. If users do not have access to a column, they cannot add it to custom views. This includes access controls defined by:


  • role-based access
  • the Access Mask and Access Expression settings
  • the Access Program and Access Function settings 
emxFramework.UITable.Customization.Basic.InclusionList=type, name, 
revision, policy, description, modified, current, originated

The above list shows the default basic properties. Additional basic properties include: vault, owner, grantee, modified.

Defines the basic properties available for customized tables.

The values for this property show in the Available Columns box (unless already listed in the Visible Columns box) when creating a custom table view.

 
emxFramework.UITable.Customization.Attribute.ExclusionList=
Enter any attribute names you want to exclude from custom table views.

As installed, the list of attributes to exclude is empty. You can add the symbolic names of attributes as needed in a comma-separated list.

Defines the attributes that cannot be added to customized tables, even if the attribute is associated with the object of the table. 
emxFramework.UITable.Customization.<type_Name>.SelectExpression. 
InclusionList=
Enter a comma-separated list of the symbolic names of attributes and select expressions for the specified object type (<type_Name>). The values for this property show in the Available Columns box when creating a custom table view.

Replace <type_Name> with the symbolic name for the administrative object type.

For example, the list current,locker,from[relationship_ECO].to.name,modified could be specified. Child object types inherit this property value.

To provide a column label for an MQL expression, the expressions for this property should have a corresponding string resource in the emxFrameworkStringResource.properties file. For an example property value for type_Part, the expression from[relationship_ECO].to.name shown in the above example should have a string resource defined as: 

emxFramework.UITable.Customization.type_Part.from[relationship_ECO].to.name = 
ECO Name
Defines expressions to select attributes for a specific object type in a customized table.

If an attribute is defined by more than one of these options, such as listed in the Inclusion List and also selected by the select expression, it only shows once in the list.

This property can be overridden for a table or structure browser page using the customize URL parameter as defined in URL Parameters Accepted by emxIndentedTable.jsp.
Configurable Tree 
emxFramework.UIStructureTree.ShowUponOpen=true

  • true (default). The Structure Navigator automatically displays when a user accesses an object that has a hierarchical structure defined, such as a Workspace or a Project.
  • false. The user must click a name of an object within the heirarchy to show the Structure Navigator.
 Defines whether to open structures by default. 
emxFramework.smallIcon.type_MechanicalPart = 
iconSmallMechanicalPart.gif

For example, the above property defines the icon for a mechanical part.

 Specifies the image file to use in the root category of a type's navigation tree (the Categories menu) and in table column headings that display an icon. 
emxFramework.smallIcon.defaultType = iconSmallDefault.gif
  Defines the default image for a type that does not have a specifically-defined image. If there is no emxFramework.smallIcon property defined for the type's icon, the system looks for a property for the type's parent type icon, then grandparent's type and so on. If no property is defined for any parent type's icon, the system uses the default image.

One exception to the above is that if the system uses a parent's tree menu because no tree menu is defined for the subtype, then the icon associated with the parent type is used instead of the subtype. 

emxNavigator.DefaultTree.TreeName = menu_DefaultTree
  Specifies the menu administrative object that represents the default tree.

For more information on the default tree, see About the Default Tree.

 
emxframework.LegacyTree = false

  • true. The Categories menu is replaced with the traditional list of categories in a pane on the left side of the page.
  • false (default). The Categories menu is used.
 A recent user interface design change converted the category list that allows access to related details about a context object (such as History, Lifecycle, Documents, and so on) into a Categories menu. This property allows you to enable the old-style (categories pane) tree structure.

Note: The User Guides for all ENOVIA products use the default value of this property to show screens and give instructions. If you change this property to true, tasks will still instruct your user to click the Categories menu in the toolbar when they need to click the Category name in the left pane.

This property can be overridden for a specific tree by passing legacyTree=true URL parameter to emxTree.jsp.
Toolbar 
emxFramework.Toolbar.PivotCommand.Limit
Default = 3. Define the maximum number of menu commands, including submenus, that can be added to the page toolbar. If the number of menu commands exceeds the property value, then the menu is created.

The value must be a positive integer value. If the property is missing or an invalid value is entered, no error will occur and the menu commands will not be placed on the toolbar.

 Converts commands in the Actions menu to toolbar commands.

For example, if this property is set to 4, then when ENOVIA Business Process Services opens a page, it counts how many commands are in the Actions menu on that page. If the menu has four or less commands, ENOVIA Business Process Services adds each menu command to the toolbar and does not add the Actions menu. This property helps reduce the number of clicks required of the user.

This property is intended for use with menus that only have a few submenu commands. If the value is set to a number that causes the toolbar to run out of room, the excess commands are added to an expand button.

If a command has been defined both as a toolbar command and a menu command, Business Process Services does not add the menu command in addition to the toolbar command. 

emxFramework.Toolbar.PivotCommand.ActionsLabel=emxNavigator.UIMenuBar.
Shortcuts

The value of this property is emxNavigator.UIMenuBar.Shortcuts, which is another property defined as Actions (names the menu and supports internationalization).

Defines the menu to create if the above property value is exceeded. 
emxFramework.Toolbar.DefaultCmdIcon=iconGenericBlue.gif
Enter the image name. Defiens a default image to use in the toolbar if a command does not have an associated image. This property has no effect on the global toolbar.