Frequently Asked Questions
Where can I download the Eclipse Plugin?
Open the Eclipse Marketplace in Eclipse, search for “Context Mapper”, and press “Install”.
Alternatively, use the following Eclipse Update site and install the plugin in Eclipse via Help -> Install New Software… (copy past the update site link).
How do I create an Eclipse project with a new CML model to start modeling my Context Map?
Consult the page Create CML Model. It describes how to setup your project to get started with modeling CML Context Maps.
How do I create a new context map?
Just create a file with the file extension .cml (Context Mapping Language). Take a look at our example to get an idea how the file content should look like: https://github.com/ContextMapper/context-mapper-examples. Let the code completion and other editor features in Eclipse guide you while completing the map and modeling Bounded Contexts.
Which DDD Patterns are supported by CML?
Have a look at our CML Reference - Introduction page. You will find all patterns supported by CML there.
Which combinations of Strategic DDD Patterns are allowed?
Have a look at the page Language Semantic Model. It introduces the semantic model of our DSL and lists the implemented semantic checkers.
Where do I find a documentation regarding the tactic DDD syntax to specify a bounded context in detail?
The tactic DDD part of our DSL is based on the Sculptor DSL. We provide a short introduction and examples how you can detail your bounded contexts on the pages Aggregate and Tactic DDD Syntax. If you are interested in more details and all features, we refer to the Sculptor documentation.
How do I validate all CML models (*.cml files) in my Eclipse project?
The CML models are validated when you save the *.cml automatically, if “Build Automatically” is enabled in the Project menu. If it is not enabled, you can validate all models by triggering “Build All” in the Project menu.
Which transformations can I apply to my CML model? Which generators are available?
Currently you can generate Microservice Domain-Specific Language (MDSL) (micro-)service contracts providing assistance regarding how your system can be implemented in an (micro-)service-oriented architecture, Service Cutter input to get suggestions for service cuts or new bounded context, and you can generate UML (PlantUML) diagrams out of your CML. The following pages explain the generators in detail:
- Generate graphical Context Maps
- Generate PlantUML diagrams
- Generate MDSL (micro-)service contracts
- Generate Service Cutter input files
- Generate arbitrary text files (with Freemarker templates)
How can I refactor my CML model?
Does Context Mapper support Event Sourcing and CQRS?
The concepts behind event sourcing and CQRS do not require special modeling objects other than DomainEvents, which are supported by the Context Mapper DSL (CML). The syntax to specify the domain models within Bounded Contexts is based on Sculptor which supports event-driven concepts. Have a look at our Event Sourcing and CQRS Modeling in Context Mapper tutorial to learn how to model events in CML.
Can I use Context Mapper to document Event Stormings?
Yes, the results of an Event Storming are based on the DDD concepts that are supported by Context Mapper. Our Model Event Storming Results in Context Mapper tutorial explains how Context Mapper can be used to document an Event Storming.
I have other questions not listed here. How can I contribute?
If you have any questions not answered by our documentation page, we appreciate if you create an issue in our documentation repo. Of course, Pull Requests (PRs) are always welcome too.
Active contributions are welcome as well!