Application Architecture Modeling With ArchiMate

Introduction

Application Architecture (or Solution Architecture, SA) can be modelled with the same set of ArchiMate diagram types as other levels of architecture (Enterprise- and Domain levels).

Application architecture can be modelled with a small subset of ArchiMate elements as follows: Application Component, Application Service and Application Interface. Relationships between those elements can be modelled with ArchiMate relationships as follows: structural relationships (Composition, Assignment, Realization), dependency relationships (Serving, Access) and dynamic relationships (Triggering, Flow).

Application Architecture Overview – the Context (Layered View)

An overview of an application can be modelled with Layered View.

Note! Layering is the categorization of the elements, as there are exactly the same behavioral and structural elements on each layer. Layering doesn’t mean that the elements exist in specific layers – there is no such layers in practice in an organization.

The context of an application can be illustrated by utilizing the Layered View. This granularity of building blocks can be shared between the architecture levels from Enterprise Architecture to Application Architecture (Solution Architecture). There can be many variations of the Layered View, an example is shown below.

Layered View (pattern).

The main advantage of the Layered View is to illustrate the overview in a single diagram. E.g. relevant elements of the business architecture such as the business service and the business process involved, and which application services are supporting the business process, which applications are providing those application services etc. The Layered View can be applied to fit for purpose, only relevant layers can be modelled depending on the case and what is appropriate. E.g. the infrastructure on which the applications are running, can be modelled if relevant, or left out in the case of cloud-services for eample.

Application Co-Operation View (Data flows)

This informative view can be used for introducing interactions between applications: what information they switch and to which direction the information flows.

Application Co-operation View.

Application And Data

This view introduces the data objects accessed by the applications. Now exactly the same data objects are explicitly modelled as shown as labels of the data flows in the diagram above.

Applications And Data View.

Another variation how applications access the data objects shown below. This view visualizes the ownership of the data objects. When using nesting (placing element inside another element), the “write access” relationship is hided (but still exists in the repository).

Applications And Data View 2.

Application Structure View

This view is useful in designing or understanding the main structure of an application and its sub-components and the associated data. This diagram can be used e.g. to break down the structure of the application system under construction, to illustrate modularization /decomposition: what are the sub-systems / sub-components what are the application services (or application interfaces) they provide.

Application Structure View.

Note that application services (figure above) are the behavioral functionalities that are provided by the structural interfaces (figure below). Application Interface (figure below) is more concrete, representing the actual interface in the form of a) user interface (GUI) or b) application-to-application interface (API)

Application Structure View 2.

This view below connects the application services with application interfaces. As application services are provided via application interfaces, this view can illustrate which application services are exposed with which application interfaces.

Application Structure View 3.

This variation below is using nesting when showing which application services are provided by which application interfaces. Note that using nesting (element inside another element) is not visualizing the relationship between elements explicitly, but the relationship (assignment in this case) is existing in the repository nevertheless.

Application Structure View 4.

Application services and application interfaces are the “different sides of the same coin”: a) behavioral services and b) structural interfaces. Both of them can be used for modelling interactions. Which one to use depends on the case and purpose. Application interfaces depict concrete user interfaces (GUIs) or app2app interfaces (APIs) with operations. As such, application interfaces can be used for modelling actual dynamics between applications, or between users and applications. Application services instead, can be used for modelling functional dependencies and interactions. Next chapter introduces different modelling options to depict interactions between applications.

GUI = Graphical User Interface, API = Application Programming Interface, both interfaces of an application. The former provides application services to the users, whereas the latter provides application services to another applications. According to ArchiMate specification: “An application interface represents a point of access where application services are made available to a user, another application component, or a node” (link).

Application Integration View (Dynamic relationships)

Several alternative approaches of modelling data switching between applications are shown in the examples (1 to 10) below.

  • “Application A” owns a data object “A-1”, which is requested by “Application B”.
  • Data flows from “Application A” to “Application B”.
  • “Application A” realizes a service “A-1” that is used by “Application B”.
  • Practically, “Application B” requests the Application Interface “A-1” and gets response…
Application Integration View.

Application Architecture View

This view mixes EA level and solution level approaches, as there are both applications and application modules (sub-components) in the same view. This is not suggested, as this mixes components from different “levels”. However, this can be used to put all-in-one diagram to avoid several different views, if the development target is not so complex..

Application Architecture.

Note! Application Service A-3 seems to be a type of user interface (GUI), whereas the other application services are type app2app interfaces (APIs).

Application Component Model (CM)

Application Component Model 0-n (CM 0-n for short) is an application architecture modelling approach, which consists of diagrams of different abstraction levels as follows:.

  • At CM-0 -level the diagram describes how the application interacts with its environment, what are the interactions with adjacent applications and users. The target application is depicted as a black-box.
  • At CM-1 -level the target application is decomposed into modules (main components), and what application services (or application interfaces) those modules provide and require. The target application is depicted as a white-box.
  • At CM-2 -level, the diagrams describe how the main modules are decomposed into sub-components, and what are their responsibilities, services or interfaces.

The Application Component Model (CM) diagrams below consist of application components and application services. Alternatively, application interfaces can be used instead of application services depending on the case. As always, it is important to utilize such a modelling style what is appropriate for the purpose, and model only those elements that are informative enough and provide certain added value. It is up to modeler, whether he or she likes to emphasize the functional aspects, or to be more concrete, and model e.g. the actual interfaces with exact naming.

Application Component Model – 0 (CM-0)

Application Component Model – 0.

Component Model – 0 (CM-0) level illustrates interactions between target application and adjacent applications. All the relevant application services (or application interfaces) are introduced. The 0-level the diagram consists of enterprise architecture level components and their services, target application is in the middle.

Application Component Model – 1 (CM-1)

Application Component Model – 1.

Component Model – 1 (CM-1) level illustrates how the target application is decomposed into modules (or main components), and which module realizes which application services (or application interfaces). Note! External applications can be left out from this level, but their services (or interfaces) are shown. When more low-level elements are shown, then more high-level elements can / have to be left out – for the sake of simplicity: to keep the diagram readable.

Application Component Model – 2 (CM-2)

Application Component Model – 2.

Component Model – 2 (CM-2) level illustrates how target application’s modules are composed from sub-components, and how they interact. CM-2 diagram can be modelled for each application component separately, as shown in the diagram below.

Application Component Model -2 (Application Component A-2).

Application Functions View

Application functional decomposition: what are the functions the application contains, and which application services they provide.

Application Functions View.

Application Process View

This view illustrates the role of an Application Process (a.k.a. automatized process), that is performed by an Application Component. An Application Processes can receive and throw Application Events (as typical e.g. in Event-Driven Architecture, where small application or microservices switch information with events).

Application Process View.

The Application Process can be nested in Application Component to save space in the diagram and to illustrate which Application Components is responsible of the concerned Application Process.

Application Process View – nesting.

An Application Process can consist of phases or process steps, that is analogous to Business Processes. The main difference between Business- and Application Process is that the former is more abstract and can consist of manual steps performd by business actors, whereas the latter is automatized and performed by an application. This Application Process View can be used for modelling e.g. cases such as AI and robotics.

Application Process View – internals.

Application Component Sequence Diagram View

Dynamic relations “Trigger” and “Flow” can be used for modelling dynamics between application components. The layout of this view can be positioned analogously to the UML  sequence diagram.

Application Sequence View.

Another version of the application sequence (figure below) that is using the flow -relation, which is more aligned with the ArchiMate philosophy for using flow -relation for information switching.

Application sequence view (2).

Application Deployment View

This view can be used for modelling the deployment of the application. E.g. clustering, servers and system softwares (such as operating system, application server etc.) can modelled if necessary.

Infrastructure View.

Conclusions

Application architecture can be modelled with the same ArchiMate elements and relationships as other levels of architecture (Enterprise- and Domain levels). Ideally the very same modelling tool (an EAM tool) and same modelling method can be used for all the architecture levels. However, there are some specific diagram types for application internal architecture modelling.

An example how to model application internal structure is the “Component Model 0-n”. This approach provides certain levels (from 0 to n) on which an application architecture can be modelled. For example, the “Component Model – 0” level describes how the application interacts with its environment, the “Component Model – 1” level describes what are the main components (modules) of the application. Next Component Model levels 2 to n can be used for to describe the structure of the main components more detailed if necessary.

Same architecture description document can be utilized for different levels of architecture: 1) Enterprise Architecture, 2) Domain / Capability Architecture and 3) Solution Architecture (link).

 


For more ArchiMate examples see:

  • ArchiMate Examples link
  • ArchiMate Cookbook link.