Elements

Terminology

As for entities, elements should be named in the most generic way, to comply with every business need related to this piece of master data.

Labels

Always set a label for the default language on an entity element, even if the label value is equal to the element name.

Facets

• When a facet is defined on the element type, a facet message should be set to warn the user in case of an error.
• Every element having facet should have a documentation set, so that the user understands what constraint is set on the element, in the Web UI.

Naming conventions

• Do not use any special character or number in the element name.
• Try to avoid using more than 20 characters for the element name, not to have too long XPath queries in the MDM components thereafter.
• Never rewrite the entity name in the element name (e.g. ProductLabel). This is not useful, and makes the XPath longer.
• Use Upper Camel Case to improve the readability of the XPath queries.