CRC sessies zijn een perfecte tool voor het maken van bedrijfsmodellen maar zijn tot mijn verbazing nog steeds relatief onbekend.

Daarom een korte introductie: waarom zijn CRC sessies zinvol? hoe doe je dat dan? wat leveren ze op?

Waarom zijn CRC sessies zinvol?

Om een goed model te krijgen van het business domein is het nodig dit model tot stand te laten komen met zoveel mogelijk input, maar belangrijker nog: met zoveel mogelijk betrokkenheid van de business deskundigen. Niet alleen omdat op die manier de betrokkenheid (buy-in) van de business groter is (zeker niet onbelangrijk en vaak onvoldoende of zelfs helemaal niet meegenomen) maar ook om de kwaliteit van de modellen zo goed mogelijk te krijgen.

Software engineers hebben vaak geen hoge pet op van de vaardigheid van business domein kenners om dat domein uit te leggen. Ze denken al snel dat een interview en een rapportje voldoende zijn om hun bovenmenselijke vermogen tot begrip te voeden en daar een compleet domein model uit te destilleren. Per slot van rekening is het begrijpen en in kaart brengen van veel verschillende domeinen hun vak!

Aan die houding klopt heel veel niet. Ook iets wél trouwens! In de software engineering is de noodzaak om zaken expliciet te krijgen natuurlijk altijd nijpend geweest. Daarom is het eigenlijk vooral in de software-engineering dat modelleertechnieken zijn ontwikkeld. Maar daarmee moeten we nog niet de vergissing maken dat we beter in staat zijn de business te begrijpen dan de business zélf. Zoals we zouden moeten weten is het voor experts helemaal niet makkelijk om hun kennis expliciet te verwoorden (expert kennis is "tacit knowledge"). Maar maak niet de fout te concluderen dat ze er dus eigenlijk weinig van begrijpen!

Zie hiervoor ook mijn artikel over intelligentie: Business Intelligence: een andere definitie.

Ons probleem (mij even verplaatsend in de software engineer) is dat wij onvoldoende in staat zijn geweest, al decennia lang, de manier waarop een business persoon de wereld bekijkt, te faciliteren. Wij (architecten) leven in een wereld waarin alles expliciet is, tot op de punten en komma's, maar dat is voor "gewone" mensen heel anders. Wij hebben als het ware een disfunctioneel wereldbeeld gekregen, en het ergste is dat we er ons niet eens van bewust zijn! Het zijn "zij" die niet weten wat ze willen, die niet snappen wat echt belangrijk is, die voortdurend zwalken. "Zij" zijn lastig!

Er is grote behoefte aan technieken die zowel "ons" als "hun" helpen met elkaar te praten. Elkaars taal spreken. Een hulpmiddel voor verbinding.

En dat is nu precies waar we CRC sessies voor kunnen gebruiken. De speelse werkvorm helpt om het ijs te breken, en is zo ingericht dat geen van de partijen in een oneerlijk voordelige (of nadelige) positie zit. De vorm daagt op een neutrale manier experts uit hun kennis vorm te geven, door die kennis tot leven te laten komen. En de vorm waarin die kennis tot leven komt is een verhaal.

Hoe doe je CRC sessies?

Het is belangrijk dat we ons realiseren dat CRC sessies in principe door en met business domein experts gedaan worden. De resultaten worden opgepakt door software engineers of business analisten, maar het is niet nodig dat deze bij de sessies zélf aanwezig zijn. Het kán echter wel, en het kan ook wel degelijk zinvol zijn om dat wel te doen om het wederzijdse begrip te voeden. Maar de sessie zou ook gedaan kunnen worden door een ervaren CRC sessie-facilitator (ervaring is echter wel van groot belang, juist omdat deze techniek nog relatief onbekend is en zeker in het begin een aantal valkuilen vermeden dienen te worden) en verder alleen maar mensen uit de business.

Er is een maximale groepsgrootte. In de praktijk varieert dit maar ik hou een maximale grootte van 8 man aan. Iedereen krijgt een stapeltje papier of karton dat er als volgt uit ziet:

Aan de linkerzijde is een lijst van Responsibilities (de "R" in CRC).

Aan de rechterzijde is een lijst van Collaborators (de laatste "C" van CRC).

Bovenin komt de naam van het concept/object te staan, zijn Class (de eerste "C" van CRC).

Vaak maak ik ook nog gebruik van een balletje (jongleerballen zijn heel geschikt!), of van een "talking stick"; eigenlijk een hulpmiddel om structuur aan te brengen: alleen de persoon met een balletje of the "talking stick" mag praten. Maar ik geef aan het begin van de sessie het balletje ook een lading: het is belangrijk om dat balletje zo snel mogelijk weer kwijt te raken! Het is als het ware een hete aardappel waar je je aan brandt als je het te lang in je mond (handen) houdt.

Het uitvoeren gaat door een stukje bedrijfsproces of gebeurtenissen in de werkelijke wereld op te pakken en dit na te spelen. Iedereen zit met zijn stapeltje (nog blanco) kaarten, en het spelen van het stukje bedrijfsproces is nu als het ware de hete aardappel: wie denkt een object te kunnen bedenken dat hier iets in kan betekenen?

In het begin is het een beetje aftasten, maar dat is niet erg: de structuur van de oplossing komt gaandeweg tot stand. Daarvoor is de ervaring van de facilitator nodig: die weet dat een exploratieve wijze van stukjes bedrijfsproces uitspelen het beste resultaat oplevert.

Wat leveren CRC sessies op?

Het resultaat van één of meerdere CRC sessies is een bedrijfsmodel, ook wel domeinmodel genoemd. Maar dan wel eentje waar meer in zit dan alleen maar de structuur van het business domein. Doordat we namelijk de verantwoordelijkheden van de deelnemende objecten expliciet hebben benoemd hebben we ook de dynamiek, het gedrag, van het systeem beschreven. En wel zodanig dat we al een heel eind zijn gekomen in de richting van een implementatiemodel, geschikt om uit te werken in een programmeertaal als Java of C#.

De kaarten kunnen rechtstreeks vertaald worden naar zogenaamde "class stubs" van zogenaamde POJO's (Java) of POCO's (C#). Dat zijn de classes, en members van die classes. De lijst van verantwoordelijkheden komt terug in de interface van de class als methodes. De lijst met collaborators komt terug als associations, waarschijnlijk member variabelen die als "slots" dienen om de association in te implementeren.

De uitgespeelde CRC sessies kunnen nog eens opnieuw gespeeld worden ter validatie. Een nuttige aanpak is de sessies in unit tests op te schrijven (met de verwachte uitkomsten).

Er is een gedeeltelijke overlap met de technieken zoals ik die beschreven heb over exploratory modelling.

Boeken

• Using CRC Cards: An Informal Approach to Object-Oriented Development (SIGS: Advances in Object Technology)
• The CRC Card Book
• CRC Card Book Value Pack

Abstract

This article describes an approach to modelling that is relatively unknown . It capitalises on capabilities of modern programming tools and languages, especially dynamic qualities, as well as advances in object-oriented modelling.

It empowers the development of DSL's, using what might be called a meta-DSL approach.

For the examples in this chapter (as in most of our projects) we have used a Smalltalk development environment, VisualWorks  in particular, but the approach is in no way exclusive to the Smalltalk language or environment. The author has also applied the approach in a Microsoft VisualStudio environment with C# and Java/Eclipse/IntelliJ with comparable success. The approach is called eXploratory Modelling. Its aim is to significantly improve the modelling and requirements effort.

We will start by describing the overall xM process and an example xM session. This will hopefully convey the “feel” of xM. After this we will introduce several relevant theoretical issues intended as a first attempt at laying a foundation for xM practices.

A more compact introduction can be found in this article: eXploratory Modelling Introduction.

Reflektis provides training to effectively use this revolutionary technique: eXploratory Modelling (Training)

The xM process

The actual xM process consists of two parts, possibly iterative:

1. Elicitation sessions with clients, domain experts or business experts
2. Transformation of the resulting domain into an implementation

During the sessions, of which you will get a feel in the next subchapter containing a walkthrough of a typical xM session, domain experts actually build a running domain component. This is an executable component, executing the defined business processes, and validated as-they-build-it by the domain experts.

After this phase, or iteratively if needed, the executable domain can be transformed to run on the platform of choice, i.e. Java EE or .NET or any other platform. The implemented domain can remain in Smalltalk which will require minimal if any transformation (this is my preferred strategy), or in C# or Java or another programming language. We have experience with the following strategy that worked surprisingly well.

1. Export the implemented classes to XMI. We have written a simple but usable component to do this in Smalltalk, which is available for VisualWorks in the VisualWorks public repository under the name xM-XMI Mapping.
2. Import the resulting XMI into any UML tool (such as Sparx Enterprise Architect or Rational XDE)
3. Export and/or transform the resulting model into a target platform such as .NET using the UML tool

The result is an implemented domain as an executable class library, not just a class stub framework as in some other modelling approaches. More on this process later.

An xM walkthrough

This subchapter will describe a typical xM session facilitated by an expert modeller who should be fluent enough in the IDE to implement the model on the fly as prompted by the workshop participants who are the domain experts. However the actual programming skills in the programming language used need not be sky-high – basic skills are usually more than sufficient.

This subchapter is written in the first person (“I did this, then that”), from the viewpoint of the facilitator.

The goal of this subchapter is to convey the “feel” of an xM session, and to communicate the prime patterns to apply. In the rest of this article some of these patterns will be elaborated upon further. Finally we will attempt to lay a more theoretical foundation.

We will take a simple example that may seem familiar to those who read the book on Domain Driven Design by Eric Evans a Cargo application (for a sample Java implementation you might check Github). During the creation of this object model the readers will hopefully appreciate the subtle differences of this model with the one from Eric Evans’ book.

We will use VisualWorks Smalltalk from Cincom, but in the various Smalltalk dialects the process would be very similar.

Please visualise the following setting. I, the facilitator, behind my laptop running the development environment and projecting this on a large screen that is visible to the audience. The audience may consist of one or more domain experts. The extent of the group is determined of course by the scope of the session. Try to keep the group small to enable maximum interaction. Also don’t be afraid to do several sessions with different domain experts on the same or overlapping domain areas. This will only make the domain richer. I am never afraid of conflicting domain definitions — this is a fact that we need to support instead of discourage as we usually do when we do requirements engineering. Try to centre any discussions around the domain objects on the screen, the components from the business domain, and avoid direct discussions between team members. The domain objects should be anchors of the discussions. Sessions should be short, typically a maximum of three hours, with at least two breaks between. These sessions are intensive, or should be, and longer sessions are hard to keep up.

To start the discussion I ask the workshop participants to decide about an object that reaches a certain goal, an end goal or state of the business domain. I talk about demand-chain processes, about flexibility, and about inverting time (see the subchapter on Reverse Time Pattern for more on this introductory story, as well as the article on this pattern). The question, when this story has been told, is:

“What object can we find that, when reaching a certain state, accomplishes a relevant business goal?”

The group decides on Cargo, which is delivered to a customer site. So I start with creating an instance of Cargo. For this I will need to create this class in the browser. I usually talk my way over this, since most of the artefacts in the domain, objects, methods and variables, will be created dynamically as you will see shortly, except classes. This is a feature of the IDE that could easily be added.

In the illustration below you can see I created a package called xM-Walkthrough, with a Namespacecalled XMExamples. With this namespace selected I ask a menu and select New Class…:

This will open the standard Class creation window. I fill in the class name we want: Cargo. I ignore the default options:

The previous steps are done quickly and covered-up by explaining I do some technical groundwork which is not relevant.

Now I am finally able to create our start object:

This will open a window you as an xM modeller, and the workshop participants will become very familiar with. Things will start coming alive now!

An inspector:

The inspectors are the business domain objects we will play with continuously during the xM sessions. There may be dozens of them on the screen at any moment during the sessions, and may contain links to hundreds or even thousands of other objects that are not explicitly represented on the screen in inspectors. These objects may persist during many sessions, we may even have some in the last sessions that were created in the first! This is the power of this approach, that we do not start from scratch every time, but start in a living world in which objects begin as trivially simple things but become more and more able. Nothing goes down, everything evolves, morphs, into the functionality we are aiming for.

The other window most of our time will be spent in will be the debugger. For business domain experts the debugger is usually introduced as the “object message-passing hiker”. It is a small backpack on the objects we create to trace their journey through life. They should not feel they are doing software development or programming; in fact I even don’t want to feel that way myself when I am working on the business domain!

The message passing metaphor is our “hook” into the domain behaviour, and the foundation on which new objects (with their responsibilities) are created.

The inspector “is” our object. I point to it (hand-waving is important!), and ask the session participants to see this window as our business object itself, by using a bit of imagination. Human beings have imagination to spare, so this is never a real problem in our sessions. And probably this simple cargo object we have created in the first few minutes of our domain modelling sessions will live for a long time, maybe during the entire modelling effort! It will remain, growing, evolving, morphing, being put to sleep and woken up again over the course of many sessions.

Now the time has come to do a bit of conceptual thinking. The object is there, but it cannot do anything yet, and we need to think back to why we were doing these modelling sessions again. Oh yeah, we were building the domain model for a cargo application. So if that were the case – what would be the purpose of this application? Or better: try not to think about applications at all. Think about the problem or business domain: what is the purpose of the cargo company? It will probably not take long to come to the insight that the purpose in life of the cargo company is to pick up cargo at one location, and move it without attrition to another location. Secondary purposes exist, such as doing this efficiently, at least as efficient or cost-effective as existing or potential business competitors.

When this insight has been declared viable, I take a little time to explain to the domain modellers that we need to adopt a specific way of thinking about problem domain issues. This is an explication of the Active-Passive Pattern in combination with the Time Inversion Pattern. This story however is not one I tell in the context of software development or modelling. You should avoid doing that also. Concentrate on explaining the concept to them from a business management perspective, or from the perspective of supply chain management processes. Explain that companies have adopted this pattern on a global scale in the past decade, companies like Toyota and Nike. Explain that business process theories like Lean, Six Sigma and supply chain management contain this pattern as a powerful tool to help enterprises create efficient and flexible business processes.

In the Active-Passive Pattern, objects do things themselves, and generally avoid things being done to them. In the “real” world this is the other way round, and that is exactly what we want to achieve here: turn things upside down, in order to create extendible, complex models. I call this process mirroring. The Active-Passive Pattern is nothing more than a simple trick to enable complex and scalable models.

Viewing the domain object we created with this newly gained perspective, what would be the last thing this object would need to do to fulfil the business goal? After some discussion the group might come to appreciate that the goal could be to deliver the cargo.

We write:

self deliver

in our workspace and evaluate this expression with Do it. Notice what we are doing? We are proceeding "as if" our application was already finished, as if all objects already know what to do!

Of course an exception pops up:

The Cargo object exists (we are evaluating the expression self deliver in this object, in the inspector). However we are asking it to do something that it does not yet know how to do.

No worries. Click the Define it… button, and up pops the debugger, our second friendly neighbourhood tool:

The environment has done a few nifty things for us. It has dynamically created a method deliver in the class Cargo, restarted the execution of the code that we started in the workspace, and interrupted the execution thread in this new method. We can see that the method body has been filled in for us with a neat self halt, which has opened this debugger.

I usually make a little joke here that modelling this way is really efficient: we have already built our system! We have cargo, which can deliver itself.

Reality is a bit more demanding, but this way in which the model should unfold is important to explain. We are in the execution chain of business or domain objects, and we have indeed arrived at the last step in a relevant business process – there should be a clear and shared understanding of this principle.

Now the next step should be to think about the last preceding action. That is: what needed to be done, or what state should we have created, in order for the delivered state to be really done? Look at this as a sequence of steps, in effect a business process, which we are building up in reverse time. This is an application of the Reverse Time Pattern. We are in the last message sent in a relevant business process. Now we need to think about the last message before that.

What could it be? Imagine yourself to be the cargo. I repeatedly urge the workshop participants to identify themselves with the active model objects they are working with, to anthropomorphise. You are there; you have fulfilled your purpose in life. But what was the last thing that needed to be done before achieving that state of bliss?

Usually several alternatives are put forward. One could be: “go to the destination”. Or “put yourself on a ferry to the destination”.

The second option is interesting because it introduces a second object we have not yet created, but one clearly of a different type or class: a mover of things (could be a ferry, a ship, a train, etc.). Help the group appreciate the potential thinking error, in thinking about the “mover” object being active, and the cargo object being passive. In this case we might decide that cargo will have sufficient active properties in making its way to its destination, so we will delegate the final delivery responsibility to the mover:

For now we will leave the rest of the session to the imagination of the reader (or their inspiration!). We hope it is clear that by traversing the backward path, the demand-chain path, we slowly implement a complete process. And that by doing it in this fashion, this process might very well be an unexpectedly efficient and flexible process as well! We often come up with interesting alternatives of processes that were executed since the Stone Age without any change.

Many side paths may be explored, many of which may turn out to be wrong or inappropriate. This way of exploring the domain should be executed without fear: we will make mistakes, decide to throw away entire parts and build them again. The environment will help us in doing this without hampering our progress. Usually in the beginning the participants need a lot of encouragement to build up their courage to explore, try out, change, and re-think their decisions, but as they learn that the environment is actually helping them in doing this they gain courage and start becoming more and more creative.

This is always a very satisfying phase in the workshops.

An important issue concerning modelling has been tackled here as well. We mention it explicitly because it is a recurring issue. We were able to answer the question: Where to begin?

In subsequent sessions the model unfolds. Be not afraid to attempt alternative paths to the same or equivalent goals. The purpose of these sessions is not to mould a business process in concrete. The resulting object model should be seen as an enabling web of objects, a semantic web, which is able to reach the same goal even in ways not explicitly modelled or considered while modelling.

The sessions should also be productive. We do not need nor want a long stretching period of modelling sessions. The percentage spent in these sessions should be small. We need a lot of time for implementing the technical connections, typically more than 4/5 of the total implementation effort.

Agility

xM is very well suited for software teams that want to apply agile processes. The acronym xM is not accidentally similar to xP (Extreme Programming). The x in xM could be interpreted as extreme! Extreme Programming originated from software development best practices that were common in the Smalltalk community and was codified by Kent Beck in his seminal book. Many Smalltalk developers employ some sort of domain prototyping similar to xM, and like extreme programming, until Kent Beck published his book, this practice has never been codified or published. Graphical Smalltalk environments like VisualWorks, Squeak, Dolphin or VAST are best suited for xM sessions because the runtime objects and the development environment are so tightly integrated that in fact they cannot be viewed as separate. While in most development environments the deployed and implemented executable is different from the programmed stuff, this is not so in Smalltalk. Created objects, as you have seen in the walkthrough, can be modified while remaining in existence. Recompiling in Smalltalk environments is a different thing! This property of most Smalltalk environments can be utilised to the max for xM.

In Smalltalk, application development should be viewed a bit differently: an application in Smalltalk is developed within the IDE; in fact the IDE is itself a Smalltalk application. All objects in the Smalltalk environment live inside an entity called an “image”. Living dormant on disk as a file, this image is quickened, re-awakened, by the Smalltalk virtual machine. On closing a development session (or, indeed, an application execution) this set of objects is persisted on disk again. In Smalltalk, new objects and new classes are created by respectfully asking already existing Smalltalk objects to do so: morphing existing things creates new things. There is no real experience of compiling and deploying. Creating an application in Smalltalk is more about stripping out unnecessary objects to create the runtime.

The xM approach fits in with the minimalistic approach that prompted some proponents of agile methods to eschew modelling and UML. We think that xM brings you the best of two world: the advantages of having a model that can be viewed and played with, plus an executable class library that can be fitted with a complete set of unit tests, albeit one that needs some transformation effort. We will talk about that shortly.

xM also delivers what MDA attempts to deliver, at least partly. The result is a repository of objects that can be viewed as a UML model, but that also lives as an executable, verifiably running set of objects. You can play with these objects. Both representations have great merit.

Modelling dilemmas

Modelling has always been an important part of software engineering, or engineering in general. We use models to capture the problem domain in a way that is most cost effective: the model should require much less effort, yet be “complete” enough to help in achieving a full implementation.

A model is a replica of what we actually want to describe. It is a representation of the “thing“ we want to describe; in engineering this “thing“ usually is a system we want to build. A common definition of a model contains the element of simplification: the model is a replica of the “thing“ with all “superfluous” elements removed. Of course this introduces an interesting and not so easily resolved dilemma: did we not remove elements that will turn out to be important? Who decides what is superfluous and what is not?

In this sense, models also play an important role in capturing requirements.

To build models, we use a language or several languages, depending on the context or the aspect we want to model. In software engineering a unifying effort has been successful and has resulted in the Unified Modelling Language or UML. The UML has gone through several versions, but can be challenging to use. It is often perceived as too complex, difficult to learn, and hard to translate into a concrete implementation. As a rule however, the UML captures the domain in a generic sense: in the form of a class model. Most UML models contain little or no instance models, and if they do, they are usually additional and in no way complete, nor are they intended to be complete. In this way UML models are more abstract than, say, home models or car wind tunnel models. In no way this should be regarded as a fundamental shortcoming, we are just stating characteristics.

A popular trend has become known as Domain Specific Languages (DSL's), as an attempt to overcome the overly generic UML and create languages or vocabularies more tunes to specific business domains. These models may be somewhat easier to use, but we think they have a lot of shortcomings, especially regarding their domain-specificness: domains are seldom isolated and interact constantly, sometimes intrusively. How will your DSL deal with that?

We sometimes coin the Smalltalk environment the DSL of DSL's. An article that talks about this is DSL for the Uninitiated - Domain-specific languages bridge the semantic gap in programming (appeared in Communication of the ACM, 2011, No. 7). The author used Ruby, but we think Smalltalk (which was an important inspiration for Ruby) is even better suited.

The common definition of models is not one we adhere to in xM. We view models as reflections of the thing we want to model. The model mirrors the real thing. The concept of mirroring creates a powerful metaphor that helps our minds in applying models effectively, and not falling in the trap of viewing the models as somehow goals in themselves, or as more real than the thing it models.

Architectural Connotations

All accumulated knowledge concerning modelling complex domains, and the various patterns that can help in making decisions, are equally appropriate for xM. However three patterns or styles are especially important in xM, and are in the modelling literature in general undervalued in a way that merits special attention here. They are:

1. Domain Model pattern
2. Active-Passive pattern
3. Time Inversion pattern

Of these pattern the first is best documented but the other two are strangely absent from most pattern literature, or if they are, they are interwoven in other patterns. For example the Time Inversion Pattern is not explicitly documented anywhere, but it certainly has become an important part of modern supply chain management business process descriptions. It just has not elsewhere been published as a pattern yet.

Domain Model Pattern

For a proper understanding of xM in the context of a complete effort that delivers a solution to a customer, the reader needs to have a clear understanding of what a domain is, and how the part of this solution that is called the domain is isolated from other parts. xM delivers an implemented, complete, fit-for-purpose domain. It does not deliver a complete solution, which will consist of several additional components, such as user interfaces, persistency solutions, or others, which we call technical components. To visualise the role of what we call a domain, in relation to these technical components, we draw the following diagram:

This diagram is also called the Sunflower model or the Satellite model. It is topologically not very different from Layered Architecture, but cognitively it conveys the important message: the business should be central in our solutions.

The diagram contains a central component: the Domain. This is the business domain containing the required business functionality. There are several attributes we want this domain component to conform to, because we can derive most value from xM if we follow these guidelines:

1. The domain component contains only domain functionality. It should have minimal if any technical content: no databases, GUI, or computers.
2. The domain has no dependencies on any technical components such as the ones mentioned above.

However, a business domain implemented as such will have little value. For example it has no user interface to communicate with it. Therefore connections must exist with what we call the technical components. It is not within the scope of this article to describe ways to implement this coupling, we will only mention that we use adapter technology to connect the business component(s) with the technical components in such a way that is has no or minimal impact on the requirement that the business component has no awareness of technology. Several articles on this site elaborate on this, for example Business Centred Architectures (article in Dutch).

To aid in understanding this architectural design principle or style, please visualise the domain as a replication or mirroring of the real world of the business. Concepts and processes as they exist in the business or problem domain can be found here. We do not build a domain component as an implementation of an automation solution, or business process, but we re-create the business in a mirrored format. The business process model should be viewed as a derived or implicit result of creating the domain model.

This mirrored format is especially recognisable in the two main patterns we describe below. A mirror reflects, but it turns some things around! The attempt to create models that resemble the real thing as closely as possible is a fundamental mistake, and we hope to have demonstrated a different approach here. The trick of applying the Reverse Time and Active Passive patterns will create infinitely scalable domain models. Modelling complex domains without applying these patterns will produce models that collapse under their own weight.

The technical components can then be seen as being there for only one reason: as non-functional components they synchronise the mirrored business with the real, outside world. These technical components should be understood as nothing but synchronisation mechanisms. When viewed as such, we have a cognitive aid in applying these components wisely, and not fall into the well-known trap of endowing them with too much business logic.

We will now briefly describe the two mirroring or reversing patterns. In describing these patterns we follow a pattern template. These patterns are also documented separately on this site.

The Active-Passive Pattern

Intent

A domain model will become large and very complex. This is nothing to be afraid of. It is how it should be. We want complexity! The intent of the model is to capture the domain, that is: reflect the real world. This model should be functional when very small, but be willing to grow, indeed to be infinitely scalable. However, in order to avoid a model that is unmanageable we should not make the fundamental error of trying to model the domain as close to the real world as possible. A simple trick is to turn active and passive around: active objects in the real world are modelled as passive, indeed even almost devoid of complexity in the sense of behaviour or responsibilities. Passive objects in the real world on the contrary are modelled as active, taking initiatives, doing things. The responsibilities endowed upon them are precisely those activities that, in the “real” world, are done with them. This will help in realising the intent (this is another aspect of turning-around).

Also Known As

• The World of Roger Rabbit
• Activity inversion
• Looking-glass world
• Anthropomorphising

Example

A person pays a bill. He owns an account to pay bills with. The person is the active object in the real world. He pays the bill by opening or accessing the account, creating a transaction, telling the transaction the amount that he copies from the amount contained in the bill, as some other information. And finally he tells the transaction to go ahead. He is a very complex object, with many responsibilities and many relations with other objects. The objects bill, transaction, account, are passive. In fact they contain only the information (data) necessary for the person and usually contain little responsibilities. They are often trivially simple.

Context

There are many passive, exceedingly simple objects (i.e. an Account), and few active, exceedingly complex objects (i.e. a Customer). Usually the active objects correspond to actors in the use cases, or external agents or triggers. The passive objects are data containers, with information used in a business process.

Problem

The sequence in behaviour is rather critical: first do this, and then do that. This is called process brittleness. The process is not easily changed. The few exceedingly complex active objects are strongly coupled to a lot of often trivially simple passive objects (typically more than three) with which they perform all kinds of tasks. The system can capture the business problem domain reasonably well when still small, but as the domain grows (that is, the model of the business domain in the software) it becomes increasingly difficult to manage, until expanding the domain model becomes virtually impossible because of the exploding transitive dependencies. The model collapses under its own weight. This is what is most often the cause of the exponential cost curve of computer systems we build.

Solution

The Active Passive pattern describes the world, or complex systems, by employing two rules:

1. Objects that are active in the real world (machines, systems, persons, committees) are modelled as passive, that is they do not initiate actions themselves, and any responsibility they have (usually they have responsibilities) are delegated to other objects
2. Objects that are passive in the real world (documents, cars, products) are modelled as active: they initiate actions, take responsibilities upon themselves to reach a business goal. They typically delegate most of the actions needed to finish a business process to other active objects, and in doing so succeed in staying simple and small.

Association hubs are, when this pattern is properly applied, greatly reduced in number. Association hubs are classes in the model with many associations (more than three is often already too many!). Inversion of activity turns activity and passivity around. In the example: the person has almost no responsibility. Instead the bill has the one main responsibility in this context, namely to “pay himself”. The bill starts the entire process of paying by contacting the person (someone has presumably created the bill, and this someone told the bill: “I want some money from this person.” The bill only needs to ask the person for one thing: an account payable. After receiving this account he proceeds by telling the account to create a transaction for himself. The bill is done now; the chain of responsibility has been transferred to the account. However, account does not hold this responsibility for long. He creates a transaction for the bill, and subsequently tells this transaction to go ahead. All the rest is done by the transaction. A simple rule of thumb is that any responsibility of an active object in the real world can be relocated to a passive object in the model.

Active objects should limit themselves in the number of responsibilities they have: typically an object should have only one responsibility. There may be more defined in the interface of the object, but these should be delegated to others. Good objects are lazy!

Consequences

The distribution of complexity over the model is more balanced. Some objects are rather passive but are usually linked to several other objects. Some objects are rather active but linked to few others. This way there are less complexity hubs in the model. The resulting or generated processes are more demand-chain and more easily changed. Processes are not the source for the structural model, but rather the responsibilities of a few key objects (like "bill" in the example above). This recurs in the way the domain model structure comes into being, by employing the Inverse Time Pattern that is described in another subchapter.
The domain model may be large, but any segment of it is loosely coupled.

See Also

1. The Active Object  pattern should not be confused with this pattern. This is a pattern that is mainly used to model objects that contain their own thread of control, to be used in concurrent systems.
2. The domain-centred design principle is also strongly related to what Craig Larman calls the Expert Pattern.
3. This pattern is usually applied together with the Inverse Time Pattern.
4. There is a strong relation between this pattern and CRC sessions. In CRC sessions, workshop participants play the role of objects in the customer domain. The facilitator usually emphasises the need to choose objects in the domain that are usually considered passive

The Time Inversion Pattern

Intent

The Time Inversion Pattern is used to model dynamic collaborative behaviour between model components. To choose which responsibilities should be endowed upon a component, the modeller considers a goal that should be reached by one or more key components. This goal should be an end-goal. There may be more than one end-goal, but one at a time is chosen for a modelling session. Reasoning backward from this end-goal the modellers searches for other components to delegate behaviour to, but in an inverted time frame: the first modelled object implements the last step in reaching the goal, the second the last step before that, and so on. The choice of candidate objects is from a list of active objects obtained from the Active-Passive Pattern.

Also Known As

• Demand-chain
• Pull model (Toyota)
• Just-In-Time

Example

A model that implements a business process that builds and delivers cars would probably contain an active object Car. The main responsibility, as last in the business process steps, could very well be: deliver yourself to the customer. Sometimes a responsibility named "sell yourself" is used.

How can a car deliver itself? Well, we define a method (=responsibility) in the class Car, called deliver. We dive into the method that should be executed when the car does this. What is the last thing that should be done in order to satisfy the deliver responsibility? We might decide that this is the fact that the car dealer drives the car to the customer site. So we need a CarDealer, and we create this class/object with the responsibility driveToCustomer. How can the car dealer drive the car to the customer site? He needs to have the car. The car, in order to be able to exist on the dealers’ site, needs to build itself: build. This is a new responsibility, in the case of aggregates largely delegated to the composing elements, etc.

The picture we want to unfold here is exactly that: of unfolding. A business process is created dynamically, can in fact be seen as generated from the collected interfaces of the web of available objects. Business processes should not be hard-coded, explicitly modelled, or contained in a separate software component, as is often the case for example in Service Oriented Architectures.

Problem

Where do you begin modelling the customers’ problem domain? This strategy makes this simpler: begin with the goals the business wants to accomplish.

How can you know that the way you model things that are done, are not modelled in such a way as to be almost impossible to change?

Modelling a complex business domain often is very hard, and it is even harder to find out where to begin.

Solution

Walking backwards along the process chain, creating active objects along the way, the car would build itself, parts would build themselves and assemble themselves, factories making the parts would pay themselves, etcetera. This is a backward inferencing process, a demand-chain process. In general, the goal objects generate the process to achieve their goals, instead of hard-coded processes as we too often see for example in BPM.

Structure

The resulting object graph is able to perform one or more trees of business processes, where the roots of the trees are the final business results. However it is important to remark here that the object graph structure itself is not at all directly conceived from these processes. Instead, various, sometimes incomplete, processes are taken during the modelling phase to "play out" by existing and newly created objects. This leads to an object graph that can be validated to at least be able to perform the defined processes, but usually is able to perform a superset of these input processes. This can be seen in the modelling sessions, when the domain experts propose a new process, and we find out that the existing model is able to generate this process without needing any change whatsoever in the model.

Known Uses

The Time Inversion Pattern is one of the three primary patterns used in eXploratory Modelling (xM). Behaviour of objects is realised by thinking about the final goal of an object, and then to decide upon the last previous action needed to accomplish this goal. This final or last action is usually delegated to a new object (usually an Active Object), upon which the modeller jumps to this object, and tries to find out the previous action in this object in the same way. This process can be viewed in action in the subchapter containing an xM walkthrough.

This pattern is well known in industry, as exemplified by Toyota in what they originally called the Pull Model.

Consequences

By using the demand-chain modelling strategy models gain in flexibility, especially in the case of uncertainty, vague business requirements, processes that are difficult to make concrete or should be highly optimised.

The resulting solution, the model, may lack structural consistency: models can be redundant and impossible to understand on an overall level. This is a potential problem, but we argue that in the case of the kind of model we talk about, this is usually not so. We create models that are complex, difficult to overview or comprehend, but because of the high cohesion this actually works in favour of the model instead of against it. The model is to a large extend managing its own complexity.

See Also

This pattern is usually combined with the Active-Passive Pattern, because the choice of where to place the previous process step to is determined by selecting an active object that is usually passive in the real world.

As mentioned earlier this pattern is well known and documented in supply-chain management theory.

Interoperability

An xM effort is not an island. It is embedded in a complete solution effort and should behave as a good citizen. It should not dictate the way software development is done, although as mentioned it operates most effectively in projects with certain characteristics such as agility.

To behave as a good citizen it should be interoperable. The Smalltalk environment may be used for the sessions, but the result should be, when necessary, transferrable to any other environment. Also the work of integration should not require high skilled or specialised labour, but be highly automated.

There are two aspects of interoperability we want to cover in this subchapter.

1. Importing existing domain information
2. Exporting into different programming languages and environments

We will only report those strategies that we have used in our own projects, since the purpose of this article is primarily an experience report. Much experience must still be gathered from others applying the method.

Importing existing domain information

For modelling a domain with domain experts it is usually necessary to “fill” the domain with objects they know. Having these objects to play with greatly helps in feeling “at home” in the domain and explore sensible processes and responsibilities. This filling, in order to be realistic, may often involve the creation of many thousands of objects. Often the classes for these objects do not exist yet, so how do we deal with this situation?

There may be alternative or better solutions, but what we have used in our projects was a very pragmatic approach. We asked the customer for access to their data. For one customer this data was too sensitive but it was not difficult to obtain a relevant data set in the form of an anonymised export of their Oracle data into a Microsoft Access database. This proved to be very useful. The dataset can be made available as raw data in Smalltalk, to be parsed and made into “real” objects with simple Smalltalk scripts.

This way we were able to create vast amounts of persons with extensive profile data which in this project was an important aspect of their domain and needed to be available in order to play with the domain effectively.

Exporting into other environments

MDAis working on an extensive set of transformation rules to enable model driven implementations. We have used a very restricted subset of this functionality, as was available in one of the tools we used, Enterprise Architect from Sparx Systems. This tool states it implements part of the MDA specification.

The part we used was XMI import, and transforming the resulting model into a C# implementation. XMI is part of the UML specification, and defines an XML interchange format for object-oriented languages.

We did not use (in fact these rules do not even exist yet) any transformation rules for transforming Smalltalk code into C#. This of course means that the resulting C# framework did not contain code either! We re-created the classes and methods. We did not re-create the method bodies. In that respect the resulting model does not bring us more than more or less traditional UML modelling.

However, we did export the Smalltalk method bodies. This was, together with all comment in classes and methods, placed into comments in the C# classes. A simple XMI framework in Smalltalk written by the author did the export.

Since we restricted ourselves to implementing in the domain classes only business domain behaviour, it is important to realise that the code in these classes has some interesting properties which help us a lot:

1. Method bodies are typically short and concise, on average 2-3 lines of code.
2. The complexity of this code is very low: they are typically easy to understand, because in fact they were created and written by the business domain experts, not by a programmer.
3. Only a very restricted subset of the Smalltalk class library was used to write this code. This of course implied that for the facilitator only this restricted subset of the vast Smalltalk class library should be familiar

This helped us with our very simple strategy for transforming the Smalltalk codebase into C#: programmers needed basic understanding of Smalltalk, not much more, to read the Smalltalk code as comment in the C# classes, and manually transform this code into C#. And of course this implied that the resulting C# code in turn was simple as well.

The task turned out to be trivial, if somewhat time-consuming. But we concluded that for this task cheap or junior programmers could be used. It was a low-skill labour.

Other instance based approaches

Other approaches exist that have more or less overlap with xM. Some of them complement xM while others are similar. We give a summarised overview of some of these, in order to help in understanding xM better.

1. Prototyping
   Used to get a feel for the required end product by creating simple examples, mock-ups or screen drawings. As a rule prototypes do not implement business logic or functionality because that would require too much time and effort, which had better be applied in implementing the "real" product.
2. Use Cases
   Describe typical interactions of users, called actors, with the system. No information is gathered on the components of the system, or the actual business processes in the domain that is under scrutiny.
3. Scenarios or user stories
   Sometimes closely related to use cases, but typically smaller or simpler. Used in so-called agile approaches. Basic planning input for extreme programming teams that gather them from requirements sessions with the customer, with the restricting requirement that they should be implementable within one iteration or sprint, typically with a duration of one to four weeks.
4. Naked Objects
   Offers an environment that enables the user to “play” with objects and their state. Strong overlap with xM and the tools used in xM. Business domains that are more data-centric and form-oriented are well suited to tackle with Naked Objects. xM is more generic and better suited than Naked Objects to tackle complex domains.
5. CRC sessions
   Closely related to xM, in effect xM can be seen as derived from it. Originally conceived at Tektronix to teach object oriented thinking , these workshop sessions actually play out objects and their interactions, and offer an effective technique to create high quality object models

xM in other environments

As was briefly mentioned in the article summary, the xM approach has been applied by the author and his colleagues in other environments, i.e. the VisualStudio development environment from Microsoft, using C# as the language to model/program in.

Programming languages like C# lack some features that can greatly increase the effectiveness of xM sessions. The same goes for the IDE, such as VisualStudio. This lack can partly be compensated by some modifications in the environment that we will describe here shortly. However we think the advantages of a modelling/programming approach like xM will bring sufficient benefits to justify its use even if external constraints prohibit a team from using the preferred Smalltalk environment for the effort.

1. On-the-fly changing class names, method names and such, without needing to re-create existing instances (remember, xM sessions constantly extend and build on existing domain objects). This can be overcome by streaming the objects to file, and back again, with some recovery algorithms to deal with adding or removing attributes or changing names of attributes. For example the Object Bench in VisualStudio empties the objects when one of their classes is recompiled. However it is possible to hook into this and stream the objects out and in again.
2. The ability to do this in several locations: in the browser, in the debugger, in the objects themselves
3. Drag-and-drop to move objects around or create instances of associations (links in UML parlance) visually

Conclusion

We think xM is an approach that can introduce significant and relevant improvements in any development effort.

Though many of its composing elements are not new, and indeed have been part of the toolbox of most experienced and accomplished object-oriented modellers, the combination of techniques offers much added value.

xM is especially useful in a domain-centred architecture, that is an architecture that has a clear separation between the business domain and the other components. We think this separation is an essential design principle in any architectural style. A domain driven architecture has not been elaborated upon in this article, but this can be accomplished in many of the existing architectural styles architectures, such as a Service Oriented Architecture.

The use of this technique in our projects has been met with great enthusiasm by our customers, and indeed often been characterised as “we never thought this was even remotely possible to do with such ease and efficiency”.

References

The author did not invent the term. It was first encountered at the ESUG 2007 conference in Lugano, in a presentation by Andreas Tönne (then from Georg Heeg eK, Germany).  See NiallRossESUG2007report.pdf (application/pdf Object). . Available from world wide web: http://www.esug.org/data/ReportsFromNiallRoss/NiallRossESUG2007report.pdf.

VisualWorks is one of several existing Smalltalk implementations. Cincom Smalltalk - Simply Possible.  . Available from world wide web:  http://www.cincomsmalltalk.com/userblogs/cincom/blogView?content=vwfactsheet.

CincomSmalltalkWiki: Public Store Repository.  . Available from world wide web:  http://www.cincomsmalltalk.com/CincomSmalltalkWiki/PostgreSQL+Access+Page.

EVANS, E. Domain-driven design : tackling complexity in the heart of software. Boston: Addison-Wesley, 2004.

Namespaces are here to scope the names of classes. Usually only one namespace is necessary.

BECK, K. extreme programming eXplained : embrace change. Reading, MA: Addison-Wesley, 2000.

Unit tests have not been discussed in this chapter, but their absence is only for the sake of conciseness. In fact many of the starting points of xM sessions can be from unit tests.

Object Management Group - UML.  . Available from world wide web:  <http://www.uml.org/>.

FOWLER, M. Patterns of enterprise application architecture. Boston: Addison-Wesley, 2003. (The Addison-Wesley signature series) has called this the Domain Model. The relation of this pattern to others can be seen in BUSCHMANN, F. Pattern-oriented software architecture : a system of patterns. Chichester ; New York: Wiley, 1996.

http://www.cse.wustl.edu/%7Edoc/pspdfs/Act-Obj.pdf

LARMAN, C. Applying UML and patterns : an introduction to object-oriented analysis and design and iterative development. 3rd. ed. Upper Saddle River, N.J.: Prentice Hall PTR, 2005.

Business Process Modelling.

Edge Perspectives with John Hagel. . Available from world wide web: <http://edgeperspectives.typepad.com/edge_perspectives/2005/10/from_push_to_pu.html.

TAYLOR, D. A. Supply chains : a manager's guide. Boston, MA: Addison-Wesley, 2004.

“MDA.” http://www.omg.org/mda/.

Welcome to Naked Objects.  . Available from world wide web:  <http://www.nakedobjects.org/home/index.shtml.

For an introduction on how CRC came to be, see chapter 4 in: BECK, K. Kent Beck's guide to better Smalltalk. Cambridge, U.K. ; New York: Cambridge University Press, 1999. (SIGS reference library series 14).

Estimated reading time: 5 minutes

xM

Exploratory Modelling is acronym-ed as xM, and the parallel with xP (eXtreme Programming) is not accidental: in a highly interactive development environment this modelling approach does for modelling what xP does for programming: it does away with procedures, documentation, or any activity that does not directly and visibly contribute to the end result. Moreover it cannot properly be categorised as modelling since the end result or deliverable of the xM effort is a running, executable software program. However, for the purpose of categorisation, but especially regarding the place of xM in the solution-realisation cycle, it can best be categorised as a modelling activity.

It empowers the development of Domain Specific Languages (DSL), and thus can be viewed as a DSL of DSL's.

Xm is truly instance based programming, since the actual business experts or domain experts, facilitated by an xM moderator who directly incorporates the results of the ongoing discussion into software objects, play around with objects. These are actual instances of classes with the behaviour and state that was deemed relevant for them.

It is a perfect example of what Adele Goldberg referred to as “robust prototyping”. The modelling effort seamlessly results in running, validated business models.

Xm is very well suited for DDD (Domain Driven Design) since it is well suited for business models but less well suited for the technological layers which are also necessary in deployed customer solutions.

You can read other articles on this site about how to couple the domain with the technology components .

xM can be done in many environments/tools, with some essential functionality to facilitate the sessions, but the Smalltalk development environments are exceedingly well suited. We have used Naked Objects successfully as well, especially in projects that are strongly data-driven and rely on user interfaces that are form-oriented.

Sessions start by exploring the desired end result or goal of a typical use of the system, or preferably of the business that we are building a business model for. An example can be an insurance product: the goal is that this product is purchased by a customer. The first step might be to create an actual, visible instance of InsuranceProduct. The modelling team will see this object on the screen, and it may be adorned with an icon to designate as an insurance product. Also this object will typically stay alive during many modelling sessions, not just this one. It will grow, accumulate all kinds of different objects around it to extend its functionality and to complete the vision of the business about its business domain. This is an application of the Time Inversion Pattern.

The unfolding model is a living persistent entity, which will be enhanced in each subsequent modelling session.

At closing a modelling session the complete state is frozen to be unfrozen at the start of the next session.

These objects must be created on the fly, modified on the fly, and open to any kind of transformation or even morphed into totally different objects or classes, so the system needs to be extremely dynamic. We have worked with other environments (Java Eclipse, Microsoft VisualStudio) and from these experiences we know that xM is possible in these environments. However the Smalltalk environment and language has proven to be vastly superior in the context of these modelling sessions.

Since we categorise these sessions as modelling sessions, in spite of the fact that the result is an executable running application (albeit only for the business domain component), it has been necessary to deliver the modelling results to projects that need to implement it in any other environment. For this we have used a transformation engine that exports the system to XMI, which is used to generate C# or Java code for the domain model. This way other target platforms can easily be supported as well.

However nothing would prevent you from employing the Smalltalk classes built during the modelling sessions to implement a complete solution in Smalltalk itself, resulting in an executable component (one or more running Smalltalk images containing the business domain components). We have not yet had the opportunity to try this in any of our projects, but in a world where everything is easier to interoperate with web services, this seems to be a viable and probably very cost-effective solution.

Also, on the interoperability aspect, we made extensive use of creating many business objects from existing business data, by importing them and transforming them from Microsoft Access databases, SQL Server and others. Especially for business experts, who constitute these modelling teams, this creates a realistic and familiar environment. The goal of the simulated world is to be an accurate representation of the business domain.

An interesting aspect of the application of this modelling technique is the feedback from customers who participated as business experts in these sessions. They were exceedingly enthusiastic, showed no noticeable discomfort to work in an environment that was originally meant to be used only by software developers (although some tricks were applied to hide some of the programming language from them), and felt the exercise to be extremely productive.

Curious whether xM might help you improve your requirements engineering process? Dealing with a complex business domain? Contact me, I think I can help!

For a more extensive article on xM, please go to: eXploratory Modelling Explained.

• eXploratory Modelling Explained
• Exploratory Modelling followup
• Architect Scrum
• Deploying VisualWorks Applications
• Why use UML for Business Modeling

Today James Robertson published his video of my talk on eXploratory Modelling at ESUG2008.

Have fun watching it, and please do not hesitate to contact me if you have questions or if any part of the presentation was unintelligible because of the noise or such. The presentation was done without a microphone, and I guess James did a great job getting the sound quality to acceptable levels.

For those who attended my presentation (and other interested people of course) on ESUG 2008 about Exploratory Modelling or xM, I collected some references.

• Slides of the presentation
• Podcast in which my presentation is discussed (note: no longer available, sorry)
• Video of the presentation, thanks to James Robertson of Cincom.

This site contains several articles related to the subject of my presentation:

1. To read more on the "reverse time pattern" please read Time Inversion Pattern
2. The subject of mirroring surfaces in a lot of articles and might even be regarded as the central theme of this site, but to get you started here are a few important links.
   1. The article on the Active-Passive Pattern
   2. Through the Looking Glass
   3. The Mirrored World

I mentioned Domain Driven Design as required reading for Smalltalkers:

• Website on Domain Driven Design: www.domaindrivendesign.org
• The book by Eric Evans (and Eric Evans was a Smalltalker...)

Some of the patterns are not completely documented, this is of course work in progress.