Version 25.1 by Carlijn Kokkeler on 2024/08/07 16:51

Hide last authors
Erik Bakker 14.1 1 {{container}}{{container layoutStyle="columns"}}(((
eMagiz 1.1 2 To conclude our section on microlearnings that all have something to do with the CDM we wrap things up by learning what the difference is between CDM and CDM messages.
3
Erik Bakker 14.1 4 Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
eMagiz 1.1 5
6 == 1. Prerequisites ==
7
8 * Basic knowledge of the eMagiz platform
9
10 == 2. Key concepts ==
11
12 This microlearning centers around understanding the difference between CDM and CDM messages.
13 By CDM we mean: The Canonical Data Model that plays a vital and central role while exchanging data between various systems via the messaging pattern
14
15 * The complete CDM consists of the collection of entities that are used or going to be used in the various CDM messages
16
17 == 3. Difference between CDM and CDM messages ==
18
19 Simply put the difference between the CDM and the CDM messages is as follows:
20
21 * The CDM holds all entities and attributes that are relevant within the context of your complete integration landscape.
22 * The CDM message is tailor-made for a specific piece of data (i.e. Order, Invoice, Employee) and only holds the entities and attributes relevant for that piece of data.
23
Carlijn Kokkeler 20.1 24 When a new system message needs to be processed, new entities have to be created. These entities have to be generic, according to the language and notation of the CDM. Thus, the entities have to be created in the CDM first. After that, these entities can be created in a CDM message, gateway message, or topic message. Once the entities and attributes have been created in a CDM message, gateway message, or topic message, they can be mapped to the entities and attributes from the system message.
25
26 Note that both the CDM and CDM/gateway/topic message show all entities and attributes that are relevant within the context of your complete integration landscape. The main difference is that the CDM message only holds the entities and attributes that are tailor-made for a specific piece of data. This is indicated in green.
27
28 Below, the CDM for a model is shown.
eMagiz 1.1 29
Carlijn Kokkeler 20.1 30
Erik Bakker 14.1 31 [[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-difference-between-cdm-and-cdm-messages--cdm-overview.png]]
eMagiz 1.1 32
Carlijn Kokkeler 20.1 33 An example of a CDM message for this model is the following:
eMagiz 1.1 34
Erik Bakker 14.1 35 [[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-difference-between-cdm-and-cdm-messages--cdm-overview-message-type-selected.png]]
Carlijn Kokkeler 20.1 36
37 This CDM message holds the entities CrashCourse and Design, as indicated in green.
38 Once the entities and attributes have been created, the message definitions have to be added. As explained before, a system message is specific to the system, whereas a CDM/gateway/topic message is generic and consistent across systems. For the system message, it is possible to add complete entities, but it is also possible to add only one attribute to the system message definition. This can be done by using the Toggle canvas edit mode button, hovering over the desired attribute and clicking on it. The attributes can also be removed individually.
eMagiz 1.1 39
Carlijn Kokkeler 20.1 40 [[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-difference-between-cdm-and-cdm-messages--toggle-canvas-edit-mode.png]]
41
42 For a CDM/gateway/topic message it also possible to add and remove entities and attributes. This can be done by hovering over the desired entities or attributes and clicking on them. The Toggle canvas edit mode button is not present here, it is only needed to hover over the entities/attributes. A minus will appear when the entity/attribute is already present in the message definition. By clicking, the entity/attribute will then be removed from the message definition. In case a plus appears, the entity/attribute is not yet present in the message definition, and can be added by clicking on it.
eMagiz 1.1 43
Eva Torken 24.1 44 == 4. Key takeaways ==
eMagiz 1.1 45
46 * The CDM holds all entities and attributes that are relevant within the context of your complete integration landscape.
47 * The CDM message is tailor-made for a specific piece of data (i.e. Order, Invoice, Employee) and only holds the entities and attributes relevant for that piece of data.
48
Eva Torken 24.1 49 == 5. Suggested Additional Readings ==
eMagiz 1.1 50
Carlijn Kokkeler 25.1 51 * [[Crash Courses (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.WebHome||target="blank"]]
52 ** [[Crash Course Platform (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.WebHome||target="blank"]]
53 *** [[Creating a message definition (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-design-creating-a-message-definition||target="blank"]]
eMagiz 1.1 54
55
Erik Bakker 14.1 56 )))((({{toc/}}))){{/container}}{{/container}}