ECObjects Information Modeling Language Overview

The ECObjects language is comprised of items that have attributes. In this section, we will briefly describe the "ECSchema" element and the kinds of items that are the direct members of an ECSchema element. For each of these kinds of items, we will define their attributes (and other kinds of items that they contain) in subsequent sections.

The first kind of element is an ECSchema itself.

  • An ECSchema describes one "domain"—its primary contents are a closely related set of "ECClasses" of various kinds. The name attribute of the ECSchema serves as a namespace for all elements defined within it. ECSchemas cannot contain other ECSchemas.

First among the kinds of elements that can be a direct member of an ECSchema is the ECSchemaReference:

  • ECSchemaReference is a member of an ECSchema that expresses that the ECSchema references another ECSchema. ECSchemaReferences are necessary when an ECSchema contains items that depend on the referenced ECSchema in some way (e.g., its ECClasses subclass from ECClasses in the referenced ECSchema.)

ECSchema gets its extensibility through custom attributes:

  • ECCustomAttributes element is a container of ECInstances (___NEED_LINK) of ECCustomAttributeClasses. Those ECInstances are "extended" metadata about the item of which the ECCustomAttributes are a member. The ECCustomAttributes can be directly applied to most (but not all) kinds of items in an ECSchema, including ECSchema, ECClass, ECProperty, etc.

The next 5 kinds of items are direct members of ECSchema and define different kinds of ECClasses. All of the ECClasses can contain ECProperties that define named properties with data types that are "primitives", "structs", arrays or navigation.

  • ECEntityClass describes a class of object whose instances are individually instantiable and identifiable. ECEntityClasses are the only kind of ECClass that can be inserted into a repository.

  • ECMixinClass describes a special type of abstract entity class that can add properties and secondary inheritance hierarchies to an entity class. Mixin classes define concepts that span the primary entity inheritance hierarchy and they hold common property definitions. Mixins can be used as relationship endpoints.

  • ECStructClass describes a class of object whose instances are always instantiated as part of a larger entity, and are not individually identifiable or addressable. ECStructClasses are the only kind of ECClass that can be used as the datatype of an ECProperty.

  • ECCustomAttributeClass describes a class of object whose instances are "applied to" particular items of an ECSchema in order to extend their metadata beyond the built-in attributes of the items.

  • ECRelationshipClass defines the connection between two entity instances. An ECRelationshipClass can be thought of as a description of a link table or foreign key column in a database. It can define which endpoint owns the other, the multiplicity and valid ECEntityClasses for each endpoint.

The remaining kinds of elements are also direct members of an ECSchema:

  • ECEnumeration defines a named type that contains a set of value-label pairs where the label is a non-localized display label (which can be used to form a localization key) and the value is the persistent primitive value. The value may be a string or an integer.

  • KindOfQuantity describes the quantity that a property’s value is measuring. For example, an ECProperty named "Pressure" in an "Instrument" ECEntityClass could have KindOfQuantity "RelativePressure". The "RelativePressure" may specify persistence units as being in PSI, as well as other metadata associated with that KindOfQuantity.

  • PropertyCategory defines a classification that can be associated with a property and help identify the importance of the properties it classifies.

  • Unit defines a unit of measure in terms of other units

  • InvertedUnit inverts an existing unit whose dimensional derivation is unitless, like slope.

  • Constant defines a constant value which can be used in a unit definition

  • Phenomenon defines a measurable physical quantity

  • UnitSystem defines a loose grouping of units

  • Format defines how to format a numeric value when displaying it to the user or for a report

  • Changes Between ECObjects 2 and 3 helpful if you have used EC in PowerPlatform.

The items that are direct members of an ECSchema must have names that are unique among all items that are direct members of an ECSchema, e.g., an ECEntityClass cannot have the same name as an ECStructClass. Uniqueness is determined using case-insensitive comparisons. See ECName for EC Naming Rules.

Last Updated: 14 November, 2019