Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.

Prev Next


Service oriented architecture Modeling Language (SoaML) is a standard method of designing and modeling SOA solutions using the Unified Modeling Language (UML).

This text is derived from Service oriented architecture Modeling Language (SoaML) - Specification for the UML Profile and metamodel for Services (UPMS) (OMG document ad/2008-11-01); pp. 25-26:

"A service is an offer of value to another through a well-defined interface and available to a community (which may be the general public). A service results in work provided to one by another."

"Service Oriented Architecture (SOA) is a way of organizing and understanding (representations of) organizations, communities and systems to maximize agility, scale and interoperability. The SOA approach is simple - people, organizations and systems provide services to each other. These services allow us to get something done without doing it ourselves or even without knowing how to do it - enabling us to be more efficient and agile. Services also enable us to offer our capabilities to others in exchange for some value - thus establishing a community, process or marketplace. The SOA paradigm works equally well for integrating existing capabilities as for creating and integrating new capabilities."

"SOA ... is an architectural paradigm for defining how people, organizations and systems provide and use services to achieve results. SoaML ... provides a standard way to architect and model SOA solutions using the Unified Modeling Language (UML). The profile uses the built-in extension mechanisms of UML to define SOA concepts in terms of existing UML concepts."

"... the highest leverage of employing SOA comes from understanding a community, process or enterprise as a set of interrelated services and ... supporting that service oriented enterprise with service-enabled systems. SoaML enables business oriented and systems oriented services architectures to mutually and collaboratively support the enterprise mission. ... SoaML depends on Model Driven Architecture® (MDA®) to help map business and systems architectures, the design of the enterprise, to the technologies that support SOA, like web services and CORBA®."

"For further information on the concepts of SoaML, see the specification document on the OMG website SoaML document page."

SoaML in Enterprise Architect

In Enterprise Architect you can model services architectures quickly and simply through use of an MDG Technology integrated with the Enterprise Architect installer. The SoaML facilities are provided in the form of:

  • Two SoaML diagram types - SoaML Component Diagram and SoaML Sequence Diagram - accessed through the 'New Diagram' dialog
  • SoaML pages in the Diagram Toolbox
  • SoaML element and relationship entries in the Toolbox Shortcut menu and Quick Linker

Example SoaML Diagram

Disable SoaML

If you prefer not to use SoaML in Enterprise Architect, you can disable it (and subsequently re-enable it) using the 'MDG Technologies' dialog ('Configure > Technology > Manage').


  • Service Oriented Architecture Modeling Language (SoaML) is supported in the Corporate, Systems Engineering, Business and Software Engineering and Ultimate editions of Enterprise Architect

Learn more