143 Matching Annotations
  1. Jun 2025
    1. 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.

    2. 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.

    3. in the default notation, these are shown as a comma-separated list (“«specialization 1, specialization 2»”).

      Too specific, standard should not prescribe.

    4. 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.

    5. Viewpoints are designed for the purpose of communicating certain aspects and domains of an architecture.

      Almost the same statement as the first sentence in the previous paragraph

    6. 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?

    7. 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.

    8. Like most of the core language concepts, a composite element may aggregate a work package or deliverable.

      I would be precise to say it is Plateau composite element.

    9. 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.

    10. 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).

    11. 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

    12. 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).

    13. 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.

    14. 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.

    15. 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.

    16. 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.

    17. 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?

    18. A network has properties such as bandwidth and latency.

      Propoisng attributes is too detailed, see my previous proposel to put all the proposed attributes to an appendix.

    19. 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.

    20. 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).

    21. 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.

    22. (possibly virtualized)

      While true I would not state this in the definition but in the description below (it already is). I think that definitions should not state anything in brackets.

    23. Artifacts deployed on a node may either be drawn inside the node or connected to it with an assignment relationship.

      This sentence does not make sense. Drawing something inside refers to some relationship (nesting). The sentences can be understood that putting something in the node is enough and no relationship is needed ... BTW also access can be used and nested in this case.

    24. 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.

    25. 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.

    26. Cooperating application components can be aggregated in collaborations.

      I would remove it. Applications cannot agree by themselves to create a collaboration, for this domain it makes the least sense and I would not mention it at all. Allow it in the definitions and relationships but not proactively propose using that.

    27. Alternatively, an access relationship can be expressed by nesting the passive structure element inside the behavior or active structure element that accesses it; for example, nesting a data object inside an application component.

      I thin access nesting is not needed anymore as we allowed assignments for passive objects.

    28. 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.

    29. 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.

    30. Relationships Between Strategy Elements and Motivation and Core Elements

      Do we need to show Service and Internal Behaviour Element? Wouldn't it be easier just to show Behaviour element? Or do we want to say by the picture that Work package does not realize Strategy Behaviour Element?

    31. Example 22: Value Stream with Capability Cross-Mapping

      The icon notation for values treams looks odd. Value stream stages are not aligned within the bigger values stream and the flow arrows are not well visible. What about changing it to boxed notation?

    32. 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.

    33. 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.

    34. 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

    35. 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.

    36. Relationships Between Motivation Elements and Core Elements

      Role should be added to Business Actor to be assigned Stakeholder as it is part of the stakeholder definition.

    37. 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.

    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. conforms

      And the best way to express the conformance is the influence and not a realization... (Still having troubles with requirements realizing principles ...

    40. 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.

    41. In this section, the generic motivation element is introduced. The more specific motivation elements are described in Chapter 6, Motivation Elements.

      It point to actual chapter. Should be removed, probably left when moving from another chapter to this one.

    42. 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.

    43. 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?

    44. 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.

    45. 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.

    46. instances

      I think the word instance is not valid here as I can use it for example between application as a category (class) and its versions or installations (instances). I would rephrase it that it is allowed between elements of the same type. (Also mention, that if it is allowed between relationships, the word element should be changed to concept)

    47. 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

    48. Semantics of Dependency Relationships

      We should avoid using blue for service part in A. When changing the picture, please set the height of service A to the same as for the process B to make it more consistent. Please swhitch the order of the right part to behaviour - passive (left to right).

    49. 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.

    50. 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.

    51. 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

    52. 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?

    53. 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.

    54. Assignment

      Please move the active element (interface) to the left to keep active-behaviour-passive order. Also replace composition with aggregation. I would also change the applicaiton's ambiguous name Finance to something like Financial application, ERP, ...

    55. 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,")

    56. The non-directional notation from the ArchiMate 2.1 Specification and before, which shows the black ball at both ends of the relationship, is still allowed but deprecated.

      Lets deprecate it finally within this major version.

    57. 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.

    58. 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?

    59. 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.

    60. 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?"

    61. 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)?

    62. To each of these, finer-grained roles may be assigned.

      Roles assignment refers to subprocesses but the assignment of the role to the whole process should be defined prior this statement.

    63. 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.

    64. 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.

    65. 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.

    66. 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).

    67. 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).

    68. 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.

    69. 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.

    70. a unit

      The word unit is a bit confusing. As the process may be divided into fin-grained processes while the word unit may be impoperly understood as something that cannot be split into pieces.

    71. 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.

    72. 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.

    73. Hierarchy of Behavior and Structure Elements

      inconsistency between the way how interface and service are described. Either both should be white with name in brackets or both should be grey.

    74. 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)

    75. 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.

    76. one domain are served by the services of other domains.

      I would rephrase it to active tense which is more natural and will be consistent with realization description below.

    77. (Common Domain, Business Domain, Application Domain or Techonology Domain)

      Inconsistent way of referencing the domains compared to other statements (e.g. 2.2.)

    78. 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.

    79. 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)