Skip to Content

Wiki source code of Exercises

Version 6.1 by Carlijn Kokkeler on 2022/09/30 09:47
Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 In this microlearning, we will educate you on what we mean when we talk about message definitions.
3
4 Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
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 concept data modeling in design.
13
14 == 3. CDM, CDM & system message, message mapping ==
15 By following the steps below, you should gain a better understanding of the differences between CDM, CDM messages, and system messages.
16
17 == 3.1 Creating a CDM ==
18 Please add the following entities and attributes to your CDM:
19
20 * Person, with attributes ID, Name, and Email
21 * PlatformCourse, with attributes ID and Name
22
23
24 One person has access to many platform courses. It should look like the following:
25
26 [[image:Main.Images.Usecase.WebHome@data-modeling-in-design-exercises--adding-attributes-entities-CDM.png]]
27
28 == 3.2 Creating a CDM message ==
29 Now, go to your CDM message and add the Person and PlatformCourse to your message definition, including all attributes. It should look like the following:
30
31 [[image:Main.Images.Usecase.WebHome@data-modeling-in-design-exercises--adding-message-definition-CDM-message.png]]
32
33 == 3.3 Creating a system message ==
34 In System message, create the following entities and attributes:
35
36 * User, with attributes ID and Name
37 * Course, with attributes ID and Name
38
39
40 One user has access to many courses. It should look like the following:
41
42 [[image:Main.Images.Usecase.WebHome@data-modeling-in-design-exercises--adding-attributes-entities-system-message.png]]
43
44 Now, remove the attribute Name in Course by using the Toggle canvas edit mode. It should result in the following:
45
46 [[image:Main.Images.Usecase.WebHome@data-modeling-in-design-exercises--remove-attribute-system-message.png]]
47
48 == Complete message mapping ==
49
50 Now that you have completed these steps, go to Message mapping and complete the mapping.
51
52 [[image:Main.Images.Usecase.WebHome@data-modeling-in-design-exercises--complete-message-mapping.png]]
53
54 == 4. Assignment ==
55
56 Navigate to Design and open the message definition option of at least one integration within your project.
57 This assignment can be completed within the (Academy) project that you have created/used in the previous assignment.
58
59 == 5. Key takeaways ==
60
61 * A message definition is a visual representation of how the elements are related to each other, whether they are mandatory and the data types they have that can be used in the message mapping
62 * Some message definitions are specific to a system. Others are generic across systems
63
64
65
66 == 6. Suggested Additional Readings ==
67
68 If you are interested in this topic and want more information on it please read the help text provided by eMagiz. Furthermore check out these links if you want a more in-depth knowledge of the eMagiz data models:
69
70 * [API Gateway model](crashcourse-api-gateway-api-data-model.md)
71 * [Understanding the eMagiz CDM](crashcourse-messaging-what-is-cdm.md)
72 * [Event Streaming data model](intermediate-configuring-event-streaming-data-model.md)
73
74 == 7. Silent demonstration video ==
75
76 This video demonstrates a working solution and how you can validate whether you have successfully completed the assignment.
77
78 {{video attachment="crashcourse-platform-design-what-is-a-message-definition.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
79
80 )))((({{toc/}}))){{/container}}{{/container}}