Skip to Content
Version 1.1 by eMagiz on 2022/05/10 11:29
Show last authors
1 {{html wiki="true"}}
2 <div class="ez-academy">
3 <div class="ez-academy_body">
4
5 <div class="doc">
6
7
8
9 = What is a message mapping =
10
11 In this microlearning, we will educate you on what we mean when we talk about message mapping
12
13 Should you have any questions, please contact academy@emagiz.com.
14
15 * Last update: February 3th 2021
16 * Required reading time: 3 minutes
17
18 == 1. Prerequisites ==
19
20 * Basic knowledge of the eMagiz platform
21
22 == 2. Key concepts ==
23
24 This microlearning centers around understanding the concept of message mapping
25
26 With message mapping we mean: Drawing lines, making notes, and defining static inputs between two message definitions to identify how data elements will be transformed from the source to the target definition
27
28 In other words, the art of good message mapping lies within your ability to correctly translate between two definitions. eMagiz will help you to make that art a reality.
29
30
31
32 == 3. What is a message mapping ==
33
34 A message mapping is a visual representation of how data is translated from the source definition to the target definition.
35 In all integration patterns (Messaging, API Gateway, and Event Streaming) you can translate data elements between definitions.
36
37 You can access a message mapping when you navigate to the Design phase of eMagiz.
38
39 <p align="center">[[image:crashcourse-platform-design-what-is-a-message-mapping--design-overview.png||]]</p>
40
41 In this phase, you can open the context menu on the integration level (remember, that is a line between eMagiz and an external system).
42 The context menu will look slightly different for each integration pattern. These differ as the use case for each pattern differs slightly.
43
44 <p align="center">[[image:crashcourse-platform-design-what-is-a-message-mapping--context-menu-messaging-mapping.png||]]</p>
45
46 <p align="center">[[image:crashcourse-platform-design-what-is-a-message-mapping--context-menu-api-mapping.png||]]</p>
47
48 <p align="center">[[image:crashcourse-platform-design-what-is-a-message-mapping--context-menu-es-mapping.png||]]</p>
49
50 Selecting one of the above options will lead you to an overview similar to the one shown below.
51
52 <p align="center">[[image:crashcourse-platform-design-what-is-a-message-mapping--message-mapping-overview.png||]]</p>
53
54 In this overview, you can actualize the message mapping between the system (identifiable by the blue bar above the definition) and eMagiz (identifiable by the green bar above the definition).
55 In the next microlearning, we will continue to actualize the message mapping so we can transform the data between the external system and eMagiz.
56
57 ===== Practice =====
58
59 == 4. Assignment ==
60
61 Navigate to Design and open the message mapping option of at least one integration within your project.
62 This assignment can be completed within the (Academy) project that you have created/used in the previous assignment.
63
64 == 5. Key takeaways ==
65
66 With message mapping we mean: Drawing lines, making notes, and defining static inputs between two message definitions to identify how data elements will be transformed from the source to the target definition
67 In other words, the art of good message mapping lies within your ability to correctly translate between two definitions. eMagiz will help you to make that art a reality.
68
69
70
71 == 6. Suggested Additional Readings ==
72
73 If you are interested in this topic and want more information on it please read the help text provided by eMagiz.
74
75 == 7. Silent demonstration video ==
76
77 This video demonstrates a working solution and how you can validate whether you have successfully completed the assignment.
78
79 <iframe width="1280" height="720" src="../../vid/microlearning/crashcourse-platform-design-what-is-a-message-mapping.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
80
81 </div>
82
83 </div>
84 </div>
85
86 {{/html}}