Skip to content

What an entity definition is

An entity definition is the configured description of a business record type in Moltaro. Users see the result as records, lists, detail pages, forms, related sections, and allowed actions. In user documentation the same concept is called a record type; one concrete record is an entity instance.

Entity definitions are managed in Constructor > Entity Explorer. Opening one shows its configuration sections: Overview, then Data model (Schema, Projection, Location), Governance (Access, Transfer), Automation & logic (Mutation effects, Logic, Validation, Object context facts), and User interface (Display fields, Runtime screens, Surface library). This documentation section follows the same structure.

Every entity definition has a type that fixes what it is for:

  • Data — a normal business record type. Most entities are Data entities.
  • Association — a many-to-many relationship modeled as its own records. See Relationships and containment.
  • Part — records owned by another aggregate, such as a board. Part records are hidden from standalone data browsing and route access through their owner.
  • Dictionary — a creation preset for simple reference-data lists. It produces a normal Data entity shaped for lookup values.

An entity definition has a stable id and an internal name — the technical identifier used for storage and APIs. The internal name must be unique and is separate from the display names users see. Display wording lives in the singular and plural display names described under General settings.