Metadata Card Configuration

You can use the configurations editor in M-Files Admin to modify the behavior and appearance of the metadata card. For instructions on how to use the configurations editor, see Using the Configurations Editor.

Metadata card configurations allow you, for instance, to:
  • add an additional header, including text and an image, for a certain object type or a class.
  • add tooltips and description fields for individual properties.
  • create collapsible property groups.
  • control the order in which properties and groups are displayed on the metadata card.
  • assign default values for properties.
  • manage automatically added (mandatory and optional) properties based on, for instance, object type and class.
  • hide properties from the metadata card.

Metadata card configurations do not, however, allow you to impose any real restrictions on metadata modifications as the configurations are effective at the user interface level only. You can, for instance, change the workflow state of an object via the Change State command without filling in a required property value imposed by a metadata card configuration rule. In such a case, you should use the workflow state preconditions or postconditions to ensure that certain property values are filled before state transitions are carried out.

Metadata card configurations in the Configurations editor.

Metadata card configurations can be found in the Metadata Card section in the configurations editor.

You can add and remove rules by clicking the Add New button in the Rules section. The rules are hierarchical, meaning that you can add subordinate rules in the Sub-Rules section for further specifying main rules (or any superordinate rules).

The Name field should contain a descriptive name for the rule. The name is only visible in the rule editor.

The Filter section defines the scope of the rule. You may want to, for example, apply a metadata card configuration of objects of a certain class only.

The Behavior section is for specifying what happens when the above-defined condition is met. For instance, when the object class is Customer, you might want to add the property groups Contact information, Subscription and Responsible employee to the metadata card.

The hierarchical rule list is evaluated from top to bottom. The higher a rule is in the list, the earlier it is evaluated. You can change the evaluation order by right-clicking a rule and selecting one of the following options:
  • Move Up to move the rule up in the list
  • Move to Top to move the rule to the top of the list
  • Move Down to move the rule down in the list
  • Move to Bottom to move the rule to the bottom of the list
Note: When a rule becomes effective, it always overwrites any overlapping behaviors of rules that have previously come into effect. In other words, a rule always overwrites any overlapping behaviors of other rules higher up in the hierarchical rule list.

For more information on defining the rule condition and behavior, see the article Configuring the Metadata Card (M-Files 2018).