Advanced Value List Properties

Value list hierarchy

Value lists can have two types of hierarchical relationships:


In the advanced settings, various hierarchical relationships can be defined.

Defining an Internal Hierarchy for a Value List

A value list can be hierarchical in itself, meaning that it can contain items and subitems. A parent item collects related subitems. This way, you can create, for example, a value list containing all drawing types hierarchically. The parent object can be for instance a floor plan, with floor plans in different scales as its subobjects. Regardless of their internal hierarchy, all items in the hierarchical value list represent the same concept (for example, the parent item Floor plan and its subitems Floor plan 1:100 and Floor plan 1:50).

Do the following steps to define an internal hierarchy for a value list:

  1. Open M-Files Admin.
  2. In the left-side tree view, expand a connection to M-Files server.
  3. Expand Document Vaults.
  4. Expand a vault.
  5. Expand Metadata Structure (Flat View) and then select Value Lists.
    Result:The Value Lists list is opened in the right pane.
  6. Double-click the value list that you want to edit.
    Result:The Value List Properties dialog is opened.
  7. Open the Advanced tab, and check This value list is a sublist of the following value list check box.
  8. Using the drop-down menu, select the Same list (defines a value list with internal hierarchy) option.
  9. Click the Contents... button.
    Result:The Value List Contents dialog is opened.
  10. Select an item on the list for which you want to create a subitem and click New Subitem.
  11. Type in an appropriate name for the new item.
    You can also rename the item later by selecting the item in the list and clicking Rename.
  12. Optional: If you want to create additional subitems, repeat the steps 10 and 11.
  13. Click Close when you are ready.
The value list items that you have just created are added to the value list as subitems of the selected owner value list items. When you assign a value to a property from the aforementioned value list, you can select a subitem by clicking the down arrow next to a value list item to expand its subitems.

Defining a Hierarchical Relationship Between Value Lists

If a parent item and subitems represent different concepts, such as countries and their cities, separate value lists must be created for the items and the value lists must be defined as two hierarchically related value lists. In such a case, the item in the Countries value list (country name) is the owner value for the items in the Cities value list. The Countries value list is then the higher-level list and the Cities list is its sublist.

Do the following steps to define a hierarchical relationship between two value lists:

  1. Open M-Files Admin.
  2. In the left-side tree view, expand a connection to M-Files server.
  3. Expand Document Vaults.
  4. Expand a vault.
  5. Expand Metadata Structure (Flat View) and then select Value Lists.
    Result:The Value Lists list is opened in the right pane.
  6. Double-click the value list that you want to define as a sublist of a higher-level list.
    Make sure that the property definition using this value list uses automatic filtering. For more information, see Property Definitions.
    Result:The Value List Properties dialog is opened.
  7. Open the Advanced tab, and check This value list is a sublist of the following value list check box.
  8. Using the drop-down menu, select the value list that you want to set as the owner of this value list.
  9. Click OK to save your changes and close the Value List Properties dialog.
  10. In the Value Lists list, find the value list that you have just set as the owner of the previous value list, right-click it, and select Contents... from the context menu.
    Result:The Value List Contents dialog is opened.
  11. In the upper list, select the owner item for which you want to add a subitem.
  12. Next to the lower list, click New Item.
    Result:A new value list item is added to the lower list.
  13. Type in an appropriate name for the new subitem.
    You can also rename the item later by selecting the item in the list and clicking Rename.
  14. Optional: If you want to create additional subitems, repeat the steps from 11 to 13.
  15. Click Close when you are ready to save your changes and close the Value List Contents dialog.
The selected value list is defined as a sublist of the selected owner value list. When you assign a value to a property from the owner value list in M-Files, you can then also assign any associated subvalues from the sublist.

Default for automatic permissions

You can activate the automatic permissions by value, value list, object type, or class. You can specify the automatic permissions for each value list in the same way as for each value. The automatic permissions are attached to an object when a value with automatic permissions is added for the object.

Note: The value-specific settings always have priority over the settings made at value list and object type level.

The contents of this value list can be translated

Enable this option to allow the contents of the selected value list to be translated to different languages. For more information, see Languages and Translations.

Value list aliases

Using the Aliases field, you can define an alias for the value list. For more information, see Associating the Metadata Definitions. Use semicolons (;) to separate many aliases.

When automatic aliases are in use and you write a name on the General tab, the Aliases field on the Advanced tab is automatically filled in. The alias has the format <predefined prefix>.<name>. Configure automatic aliases for your vault in Advanced Vault Settings.