383 Matching Annotations
  1. Jul 2025
    1. The uniting (aggregating, assigned, or realizing) concept (the “from” side of the relationship) is always an element; for assignment and realization it can be an element or a junction. The united (being aggregated, assigned to, or realized) concept (the “to” side of the relationship) may also be, in some cases, another relationship or junction.

      Shouldn't this be moved to per relationship sections for the sake of readability? If not, I suggest to reformulate as saying that the uniting concept is ALWAYS an element and then providing two exceptions (over 3 relationships), is a bit odd. (JB)

    2. When modeling the internal behavior, it is often useful to distinguish a process view and a function view on behavior; two elements associated with these views, process and function, are defined. Both elements can be used to aggregate more detailed processes/functions but based on different aggregation criteria. A process represents a workflow consisting of smaller processes/functions executed in a certain order, with one or more clear starting points and leading to some result. It is sometimes described as “customer to customer”, where this customer may also be an internal customer in the case of sub-processes within an organization, or some system in the case of automated processes. The goal of such a process is to “satisfy or delight the customer” [10]. A function aggregates behavior based on required skills, resources, (application) support, etc. Typically, the processes of an organization or system are defined based on the products and services that this organization or system offers, while the functions are often the basis for the assignment of resources to tasks. It is permitted to use aggregation relationships between processes and functions; e.g., a process can aggregate other processes or functions, as can a function.

      Shouldn't this paragraphs moved after the "4.2.2. Process" header ? (JB)

    3. A path can aggregate nodes.

      Not only node, but any active structure element. The meaning of this aggregation should be better explained. (JB)

      Proposal: "A path can aggregate internal active structure elements to model the people and technology on which the path relies"

    4. It is realized by one or more communication networks or distribution networks

      I would change "it is" to "it may be" If we use path to express communication among people then it will not be realized by neither of them.

    5. The relationships shown in this and other metamodel figures are not to be confused with ArchiMate relationships. They are metamodel relationships expressing the structure of the language rather than a model in the language.

      We should add back a note saying "In this and other metamodel figures, the label of a relationship signifies the role of the source element in the relationship; e.g., a service serves an internal behavior element." (JB)

    6. Nesting for other relationships has no defined meaning but is still allowed.

      5.2.2 still allow nesting for access, and I personally think it makes sense because this is another meaning than the newly added assignments to passive structure. (JB)

    7. Realization is also allowed between application components and between nodes. This way, a physical application or technology component can be modeled realizing a logical application or technology component, respectively.

      No more true (JB)

    8. cannot perform behavior

      Almost anything can perform behaviour, e.g. paper can burn, stone can melt etc. Should we somehow reflect that in the description? I usually use the explanation that passive element is something we manipulate with but not sure if it fits better.

    9. See [ch-Common-Elements] for an explanation of the notation

      There is no more such explanation in "Common Domain" (or it as best incomplete). We might want to add back this previously existing note in "Common Domain" (and btw fix the reference): "In this and other metamodel figures, the label of a relationship signifies the role of the source element in the relationship; e.g., a service serves an internal behavior element." (JB)

    10. The Open Group gratefully acknowledges the contribution of the following people in the development of this and earlier versions of this standard:

      We have to update this part to reflect the involvement of every member of the Coronado workgroup (JB)

    11. This edition of the standard includes a number of corrections, clarifications, and improvements to the previous edition, as well as several additions.

      Not true for NEXT version, was valid for minor versions (e.g. 3.2)

    12. Representation can be replaced by a (specialization of) data object, artifact or material

      I think that it should be replaced by (specialization) of business object, not a data object. The rest remains.

    13. Specialization of concepts provides extra flexibility as it allows organizations or individual users to customize the language to their own preferences and needs, while the underlying precise definition of the concepts is preserved. This also implies that analysis and visualization techniques developed for the ArchiMate language still apply when the specialized concepts are used.

      I would also add negatives: Limited understandability by other parties like partners, suppliers and even readers within the organization who learnt standard ArchiMate.

    14. Specialization of concepts is done by using the profile mechanism described in Section 14.1, “Adding Attributes to ArchiMate Concepts”. The name of the profile is the name of the specialization, and it may have other attributes if relevant to the specialization. The specialized concept is modeled by assigning such a profile to the general concept.

      This is tool specific. I would not prescribe how to implement the specialization.

    15. Conceptual Model of an Architecture Description [14]

      The ISO standard specifies that Viewpoint and View have 1:1 relationship which is not true in general and also not true for ArchiMate. You can have multiple views (ASIS, TOBE) governed by one viewpoint. Do we want to address it at least by mentioning it?

    16. Goals, outcomes, and requirements can be aggregated in plateaus.

      I would add explanation what does it means. I am personally confused by the aggregation realization here. In most cases I think people would like o express that some goal will be realized by some plateau. Using aggregation means something different - possibly that the goal is valid for only that time period but not necesarilly realized by that. On the other hand it would mean that aggregation is weaker then realization in this case.

    17. Relationships of Implementation and Migration Elements with Core Elements

      I think Plateau may also aggregate Grouping, it should be stated in the right top box. The picture is also cropped on the right side.

    18. An important premise in the TOGAF framework is that the various architectures are described for different stages in time. In each of the Phases B, C, and D of the ADM, Baseline and Target Architecture descriptions are created, describing the current situation and the desired future situation. In Phase E (Opportunities and Solutions), so-called Transition Architectures are defined, showing the enterprise at incremental states reflecting periods of transition between the Baseline and Target Architectures.

      I would not start explaining Plateau by referring to TOGAF. It is needed regardless what TOGAF says and is valid for other methods as well. More generic description is needed first (at least switch order with the second paragraph).

    19. Implementation and Migration Elements

      In all previous chapters description of an element always ends with its notation picture. In this chapter some texts are present below the notation picture so it is inconsistent to the rest of the document

    20. Cross-Domain Relationships

      I think there is a general inconsistency in the allowed relationships for example: If an Application component may be realized by a Device, then a Service realized by the Device (e.g. Hosting Services) whould be allowed to realize the same Application Component. Otherwise we loose the strenght in the derivation here. My proposal is not to allow it but to restrict the realization from Device to Application Component (and similar realizations).

    21. Cross-Domain Relationships

      Possibly missing relationship between Application hosting service and Financial Application Web Archive artifact - inconsistent with the other technology service which accesses the other artifact.

    22. Perhaps the most common case of this is an application interface serving a business actor, to model that a user accesses the GUI of some application.

      It is but is not present on the picture and is stated as a last sentence in the chapter. I would either explicitly show this on the picture or state it already at the beginning.

    23. Relationships Between Business, Application, and Technology Domain Elements

      I would not put Application component between Facility and Business actor. It is hard to read and people may think there is some link between Application Component and Business Actor. Please split these into separate columns.

    24. However, a central issue in Enterprise Architecture is business-IT alignment:

      Too historical, it is not a primary goal of today's EA as I understand it. I would simply remove or rephrase this sentence.

    25. The name of an artifact should preferably be the name of the file it represents; e.g., “order.jar”.

      It can also represent something that is not a file like packet or message or emails sent via network. How to name such things?

    26. provides the basic services to interconnect systems and provide the basic mechanisms for opaque transfer of data. It contains the hardware and software elements which make up the networking and physical communications links used by a system, and of course all the other systems connected to the network

      I like the definition but not sure of to refer to TRM which is in my opinion dead for already for more then 10 years ... It may cause that ArchiMate will be perceived the same.

    27. quipment can be aggregated in a location.

      Aggregation to location applies to all the elements and should be either listed in every element description or at none. How to work with locations is described in 4.3.2 and I think no more details are needed in later chapters.

    28. livestock

      Please add a short description in chapter below explaining the use of livestock e.g. Equipment may also be used to describe animals, especially livestock to express how it consumes and produces materials (hay, milk, manure) or otherwise manipulates with material (horses pulling wood elephants carrying tourists).

    29. This element is used in the same way as data objects (or object types) in well-known data modeling approaches, most notably the “class” concept in UML class diagrams.

      I would put this UML related text as the last sentence in this chapter not the second.

    30. other application components

      Not only application components as it is stated in the end of 9.2. I would rephrase it to either remove the application component reference or refer to other potential consumers.

    31. A product may aggregate services, business objects, data objects, artifacts, and material. Hence a product may aggregate elements from other domains than the Business Domain.

      Most of it is already part of the definition.

    32. As explained in ([ch-common-domain]), active structure elements can be assigned to common behavior elements such as processes and functions. This way, you can e.g. model that a business actor performs a process or a business interface provides a service. These behavior elements, in turn, can access passive elements, so you can model that this process reads or writes a business object.

      This chapter uses statements like you can which is the other style than the one used in previous chapters.

    33. Example 21: Capability, Resource, and Course of Action

      I would replace influences by realizations to describe the structural view on how the motivation will be achieved. Wrong location colour.

    34. Courses of action can be categorized as strategies and tactics.

      While the statement is completely true I would think of updating the statement as somebody decided to create an exam question on this very detail.

    35. For example, business planning, customer management, or asset management [21].

      I would rephrase it to Example capabilities names are ... Or remove it completely as there are examples just before the notation overview

    36. Additionally, a business actor may be assigned to a stakeholder to express that someone with an operational position within our outside the enterprise is also a stakeholder of that enterprise.

      It is already stated on the picture so it is not Additionally... Or it should be moved above the picture.

    37. Relationships Between Motivation Elements and Core Elements

      Maybe it should be mentioned, that relationships to Implementation and Migration elements are described in their chapter and not here.

    38. Goal, Outcome, Principle, and Requirement

      Mixing realizations with influences in this picture is not a good approach. Either we want to show how things are realized or influenced. In this picture the realization vertical is broken by influences and is unclear, how the goal will be realized.

    39. strengths, weaknesses, opportunities, or threats

      For me it is too much SWOT oriented but also other techniques may be used to assess something. I would rephrase it at least by saying that it is one of the common approaches, examples etc.

    40. Several motivation elements are included in the language: stakeholder, value, meaning, driver, assessment, goal, outcome, principle, and requirement.

      I think listing the elements in the text does not bring any value.

    41. Cardinalities

      Does it mean we predefine some attribute (profile) with specified values for it? Is it mandatory for tools and will it be part of exchange file? Or is it just an example how to do it and left to the modeller?

    42. A label may be added to outgoing triggering relationships of a junction to indicate a choice, condition, or guard that applies to that relationship. Such a label is only an informal indication. No formal, operational semantics have been defined for these relationships because implementation-level languages such as BPMN and UML, differ in their execution semantics and the ArchiMate language does not want to unduly constrain mappings to such languages.

      Ca also junction have a name? I expect so.

    43. Junction

      I think we agreed on spliting the junction into two separate concepts And junction (without brackets) and or junction. Currently it is unclear if it is one concept or two. regardless of the result of splitting it I would really remove those brackets for And.

    44. A stronger interpretation of triggering (everything in B is preceded by everything in A) could be imposed on the ArchiMate model by a modeling group wishing to do so.

      I would mention that junctions may be used here to express the same. It is very often used in sample exam scenarios

    45. The association relationship can be used when drawing a first high-level model where relationships are initially denoted in a generic way, and later refined to show more specific relationship types.

      As this is not the case for all use cases I would add that in some cases it is the only valid one to connect some elements.

    46. The fact that an element positively contributes to the achievement or implementation of some motivation element, or The fact that an element negatively influences – i.e., prevents or counteracts – such achievement

      I also use examples with zero or indifferent influence to explicitly show that something is not going to influence something else. Should it be added?

    47. Top-Level Language Structure

      I would add some statement to this chapter about naming the concepts. That similar to spoken language concepts have names where for elements is almost always specified (also exchange file format requires elements to have names) while fot relationships and junctions they are allowed but used rarely.

    48. Attributes can be used to indicate the sign and/or strength of the influence. The choice of possible attribute values is left to the modeler; e.g., \{++, +, 0, -, --} or [0..10]. By default, the influence relationship models a contribution with unspecified sign and strength.

      I would mention that the strength is not a name for the relationship and influence can have both name and strength in parallel

    49. behavior and active structure elements

      I think it applies to other elements (e.g. composite) too, but I would keep the definition as it is because this would be the majority of the use cases.

    50. grouping element

      I don't think that using grouping in this case will have the same meaning as using the junction. Grouping definition does not define this meaning and according my understanding of the note at the end of the Grouping chapter it specifies exactly the opposite ("contents of the group together, or parts thereof,")

    51. No relationships are allowed between two relationships

      We discussed to allow this for specialization to express that one relationship specializes other relationship (e.g. flow). But I understand it is too big change whith potential huge impacts.

    52. logical places

      I very often receive the question on the difference between logical location and facility. E.g. branch, warehouse etc. may be expresses by both. Can we be more precise on explaining that? Or should the location be used solely for the physical location and logical left to the facility?

    53. This event concept is similar to a BPMN event, and to the initial state and final state elements in UML activity diagrams. However, the ArchiMate event is more generally applicable in the sense that it can also be used to model other types of events, in addition to triggers of processes.

      I meet many people experienced in BPMN who think that using the event in process descriptions is mandatory. Can we add a simple statement like "Unlike in BPMN, expressing events when modelling process is not mandatory and is left upon modeller?"

    54. Common Domain Elements

      Process second row names are strangely aligned (not centred like if there is a space in front of them. The roles and collaborations have different sizes and are not horizontally aligned.

    55. An event may have a time attribute that indicates the moment, moments or frequency at which the event happens. For example, this can be used to model time schedules.

      I would not propose any specific attributes to concepts. What about proposing such in a separate list in an appendix table (similar to what TOGAF has)?

    56. An external behavior element, called a service, represents an explicitly defined behavior that a business actor, application component, node, device, system software, equipment, facility, role or collaboration provides to its environment.

      Can path or its derivates provide service too? Distribution network can distributes goods, communication network can transfer data which both can be expressed as a service.

    57. The properties (e.g., bandwidth, latency) of a path are usually aggregated from these underlying networks.

      It is too detail to mention properties here. We removed them in other cases (impl. events) in the past too. Also using the word aggregates here might be confusing as readers may understand it as a relationship type.

    58. business actors, application components, nodes, devices, system software, equipment, facilities, roles, and/or other collaborations

      Mixing singular and plural (which might be OK in English).

    59. rather than instances

      In some areas it is also common to describe instances, like departments are instances of an actor and very ofthe the technology domain describes the instances too (particular servers).

    60. grouping concept

      Is there some more detailed guidance on this? I would never think of it this way. If I have a department it would consists of sub-departments, application component of functions (assignment) etc.

    61. This has its roots in data modeling

      Not an expert in data modeling, for me the concept is more familiar from Zachman framework in which some more levels are defined but more importantly word physical means the physical implementation and is not limited to data storages etc.

    62. and it may depend on the context whether a certain piece of software is considered to be part of the Application Domain or the Technology Domain

      Maybe example showing the same difficulty between IT and physical may help as well. E.g. printer can be expressed both device and equipment.

    63. also called interfaces

      I thin "also called" has slightly different meining. I understand interface as on of potential many external active structure elements (they could be specializaed in parallel to interface) nut also called means that they are the same. The same applies to services below.

    64. To signify this, they are depicted in white with labels in italics.

      Add explanation on meaning of the relationships too. They should not be understood as ArchiMate relationship. Then each of them should be explained. I would also consider removing the composition for the model to concept as the composition is on later metamodels depicted by using normal link (triggering like one - see 4.3)

    65. Any conflict between definitions described here and the TOGAF framework is unintentional. If the definition of a term is specific to the ArchiMate modeling language, and a general definition is defined by the TOGAF framework, then this is noted in the definition.

      Is this statement needed? I would limit links to TOGAF to minimum. Also the statement is not true as the ArchiMate definitions are many time intentionally different to TOGAF counterparts.

    66. For example, consistently satisfying the principle “serve customers wherever they are”, will help to make the goal “increase market share”, come true. In other words, the principle contributes to the goal.

      This is more an example of a "horizontal" use of influence and not a "vertical" one as stated in the beginning of the next paragraph. (JB)

    67. The Technology Domain elements are typically used to model the Technology Architecture of the enterprise, describing the structure and behavior of the technology infrastructure of the enterprise

      Redundant use of "of the enterprise". This could be simplified to: The Technology Domain elements are typically used to model the structure and behavior of the technology infrastructure of the enterprise.

      (JB)

    68. Figure 8. Path Notation

      Shouldn't there be some additional explanation for path? E.g., difference with network, naming, main relations, etc. The other elements have this, and there also was an explanation when Path was still in the technology layer (although this text will have to be modified because the use of Path has been extended).

      Henk

    69. has three ways of modeling

      only one way (specialization) is described here.... what are the other two?

      Eventually, the whole sentence should be: The ArchiMate language has many ways of modeling such abstractions in the application domain, as described in....

      Also, I suggest that the first sentence is joined to the previous paragraph, leaving the discussion of abstractions in the technology domain separated. (AP)

    70. comprises both information technology and operational (physical) technology

      comprises both information technology and operational (physical) technology that enable and support the enterprise operating model

  2. May 2025
    1. Figure 8. Path Notation

      Shouldn't there be some additional explanation for path? E.g., difference with network, naming, main relations, etc. The other elements have this, and there also was an explanation when Path was still in the technology layer (although this text will have to be modified because the use of Path has been extended).

      Henk

    1. 10.3. Example

      This is a bit strange now. Although the physical elements are now completely integrated in the technology domain, the previous examples only use elements from the original (information) technology layer, while this overall example of the technology layer only uses physical elements.

      Henk

    2. A process or function may be interpreted as the internal behavior of a single internal active structure element.

      This is no longer true, because collaborations now also perform processes or functions.

      Henk

    3. Figure 8. Path Notation

      Shouldn't there be some additional explanation for path? E.g., difference with network, naming, main relations, etc. The other elements have this, and there also was an explanation when Path was still in the technology layer (although this text will have to be modified because the use of Path has been extended).

      Henk

    4. Figure 6. Role Notation

      Placement of notation figures in this chapter is not consistent with the other chapters. Everywhere else, the notation figures are placed after the additional explanation, not directly after the definition.

      Henk