What Is MDG Technology in Enterprise Architect? Definition and Governance Guide
The short version: MDG Technology (Model Driven Generation) is Sparx EA’s metamodel extension mechanism. It defines the custom element types, stereotypes, tagged values, diagram types, and validation rules available inside the modeling environment. Every framework Sparx EA supports — ArchiMate, SysML, BPMN, DoDAF — is an MDG extension, either built in or custom-built for an organization’s own standards.
A well-designed custom MDG is the difference between a repository of loosely-typed diagrams and a governed, queryable architectural vocabulary. It is the foundation of model quality — and therefore of everything you can reliably do with the data downstream, from BI dashboards to AI-assisted querying.
What MDG Technology does
MDG Technology is what lets Sparx EA model in ArchiMate, SysML, BPMN, TOGAF content, and any custom notation an organization invents for its own governance.
MDG Technology is what transforms Sparx EA from a general-purpose UML modeler into a governed enterprise architecture tool.
Without MDG, Sparx EA models in base UML. A rectangle is a Class; a connection is a Dependency. A “Customer Management Capability” is just a Class with a text label — its meaning is not captured. With the ArchiMate MDG, Sparx EA knows a Capability is a Strategy-layer element with specific allowed relationships, and validation can check that elements are used in architecturally valid ways. With a custom organizational MDG, it knows a SaaS Application is your stereotype of Application Component, with mandatory tagged values for Cloud Provider, Subscription Cost, and Data Classification, enforced before the element can be saved.
The components of an MDG extension
An MDG Technology package contains four kinds of definition:
Stereotype profiles. Stereotypes extend base UML metaclasses (Class, Component, Node, Dependency) with additional metadata and semantic meaning. ArchiMate’s Business Process extends the UML Activity; a custom Managed Application extends Component with your specific attribute requirements.
Tagged value definitions. Each stereotype can define custom attributes — name, data type (text, integer, date, boolean, enumeration), allowed enumeration values, whether the value is mandatory, and any default. Enumerations matter most: they define the controlled vocabulary used when filtering, grouping, and reporting on the model.
Diagram types. Custom diagram types constrain which element and relationship types may appear. An ArchiMate Application Layer diagram allows Application Components and Services but not Business Process elements. This enforces modeling discipline.
Validation rules. Rules checked when the model is validated — mandatory relationships, attribute constraints, naming conventions, structural constraints. Running validation surfaces every element that violates a governance rule, without relying on each architect to self-enforce.
Built-in MDG extensions
Sparx EA ships MDG extensions for the major standards:
- ArchiMate 3.x — the Open Group’s EA notation. All layers, element types, relationships, and viewpoints. The primary MDG for most EA programs.
- BPMN 2.0 — flow elements (Tasks, Events, Gateways, Pools, Lanes) for process modeling.
- SysML 1.x — systems engineering: requirements, block definition diagrams, internal block diagrams.
- TOGAF Content Metamodel — Principles, Requirements, Gaps, Work Packages, Plateaus, used alongside ArchiMate.
- UML 2.5 — the base package: class, sequence, use case, and state machine diagrams.
- DoDAF / MODAF / NAF — defense architecture frameworks with their own viewpoint and stereotype sets.
Custom MDG extensions: the organizational standard
Beyond the built-in frameworks, organizations build custom MDG extensions to govern their own standards. A custom MDG typically includes:
- Organization-specific stereotypes — a
Cloud Servicestereotype with tagged values for provider and data classification; aLegacy Systemstereotype with migration priority and technical-debt scoring. - Governance vocabulary — tagged-value enumerations defining lifecycle stages, investment bands, criticality ratings, and business-domain taxonomy.
- Validation rules — enforcing that new elements cannot be committed without mandatory governance data, the discipline that keeps the repository from filling with ownerless, statusless elements.
- Custom diagram types — tailored templates such as “Current State Application Landscape” or “Capability Heat Map.”
- A custom toolbox — surfacing your stereotypes prominently so architects reach for the right element types directly.
Why MDG is the model-quality foundation
The precision of your MDG directly determines the precision of everything you can do with the model downstream. An element typed only as a generic Class with a free-text note saying “this app is end of life” is not a structured, filterable fact. The same element typed as a SaaS Application with a governed Lifecycle Status = End-of-Life tagged value is a precise, queryable dimension.
That distinction compounds across reporting, portfolio analysis, and any AI or BI tool that reads the repository. Where a semantic layer exposes model data to those tools, it can only be as precise as the MDG underneath it. Every investment in MDG governance — more precise stereotypes, governed enumerations, enforced validation — improves the reliability of every output the repository feeds. MDG is not a technical detail; it is the foundation of intelligence quality.
Building vs consuming MDG extensions
Consuming built-in MDGs. Most teams start by activating built-in extensions (ArchiMate, BPMN) and using their element types. This is straightforward configuration.
Building custom MDG extensions. Custom development uses the MDG Technology editor — a profile-based approach where stereotypes are defined as UML profile packages with tagged-value definitions and constraint specifications, then packaged by the MDG wizard into a deployable .xml file importable into any Sparx EA installation. It is a specialist skill requiring fluency in both the UML metamodel and the Sparx EA MDG implementation.
For most organizations, 3–8 custom stereotypes covering the key element types is the right initial scope. Sparx Services delivers custom MDG design and implementation as a core part of Configure the Solution — building the governance framework that fits your modeling needs and transferring the knowledge so your team can maintain it.
Deploying and maintaining MDG extensions
Deployment. Custom MDGs deploy through Project/Model Options › MDG Technologies, or via Pro Cloud Server configuration so every connecting client receives the MDG automatically.
Version control. MDG extensions are XML files — version-control them in Git, with MDG version numbers for compatibility tracking.
Updates. When the MDG changes, redeploy to the repository and clients. Existing elements are not auto-re-validated; a model validation run surfaces elements that no longer meet updated rules.
Frequently asked questions
What is the difference between a stereotype and a tagged value?
A stereotype defines a new element type — it extends a UML metaclass with a specific identity, icon, and relationship rules. A tagged value is an attribute on an element of that stereotype. The stereotype answers “what kind of thing is this?”; tagged values answer “what data does this instance carry?” Both are MDG-governed.
Do I need a custom MDG if I just use ArchiMate?
Not to use ArchiMate itself — the built-in MDG provides the element types and relationships. But you will likely want a custom extension to add governance tagged values (lifecycle status, business owner, investment band) that the ArchiMate spec does not define. A custom MDG that adds tagged values to existing ArchiMate stereotypes, without redefining them, is the standard approach.
How long does it take to build a custom MDG?
A focused design and build covering core stereotypes, tagged values, validation rules, and diagram types typically takes 4–8 weeks: discovery, design, build, testing in a staging repository, and deployment. More complex MDGs spanning multiple domains take longer.
Can validation rules block elements from being saved without mandatory data?
Yes. Validation can flag or block. Blocking on save requires integration with Sparx EA’s model validation framework via scripts triggered on element-save events. Flagging (run on demand) surfaces violations across the repository without preventing saves. The right enforcement level is a governance decision — stricter improves quality but can slow modeling.
Can multiple MDG extensions be active at once?
Yes — a common configuration is ArchiMate + BPMN + TOGAF Content Metamodel + a custom organizational MDG. Element types coexist and can be linked; diagram types stay distinct. The main consideration is avoiding naming conflicts between stereotypes from different MDGs.
What happens to governed data when the MDG is updated?
Existing instances retain their tagged values. If a value is renamed, old data persists but is no longer recognized by the new schema — a migration step is needed. New tagged values start empty until populated. Tightened validation rules may cause existing elements to fail. MDG updates need a migration plan.
Build your MDG governance framework
Sparx Services’ Configure the Solution engagement delivers a custom MDG Technology extension designed for your modeling standards — stereotype design, tagged-value governance, validation rules, diagram templates, and deployment configuration. The MDG is what makes your enterprise architecture repository an intelligence asset rather than a diagram store. For how that foundation feeds an AI-ready practice, see AI Augmented Architecture.
Is your model governed — or just drawn?
Talk to a practitioner about designing a custom MDG that makes your Sparx EA repository precise, queryable, and AI-ready.
Book a call →Keep reading
You might also be interested in
How to Configure MDG Technology in Sparx EA
The step-by-step build: requirements, stereotype design, validation, and deployment.
Read → InsightMDG Technology as Your AI Quality Gate
Why model governance is the real unlock for reliable AI output from the repository.
Read → For leadersConfigure the Solution
Design and deploy the MDG, governance, and structure that make the repository trustworthy.
See how → ApproachWhy Sparx EA
Why the platform's extensibility makes it the foundation for governed, AI-ready architecture.
Explore →