Wiki source code of Exercises
Version 6.1 by Carlijn Kokkeler on 2022/09/30 09:47
Hide last authors
author | version | line-number | content |
---|---|---|---|
![]() |
1.1 | 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 | |||
![]() |
2.1 | 12 | This microlearning centers around understanding the concept data modeling in design. |
![]() |
1.1 | 13 | |
![]() |
6.1 | 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 | ||
![]() |
1.1 | 22 | |
23 | |||
![]() |
6.1 | 24 | One person has access to many platform courses. It should look like the following: |
![]() |
1.1 | 25 | |
![]() |
6.1 | 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: | ||
![]() |
2.1 | 30 | |
![]() |
6.1 | 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 | ||
![]() |
5.1 | 38 | |
39 | |||
![]() |
6.1 | 40 | One user has access to many courses. It should look like the following: |
![]() |
1.1 | 41 | |
![]() |
6.1 | 42 | [[image:Main.Images.Usecase.WebHome@data-modeling-in-design-exercises--adding-attributes-entities-system-message.png]] |
![]() |
1.1 | 43 | |
![]() |
6.1 | 44 | Now, remove the attribute Name in Course by using the Toggle canvas edit mode. It should result in the following: |
![]() |
1.1 | 45 | |
![]() |
6.1 | 46 | [[image:Main.Images.Usecase.WebHome@data-modeling-in-design-exercises--remove-attribute-system-message.png]] |
47 | |||
48 | == Complete message mapping == | ||
![]() |
1.1 | 49 | |
![]() |
6.1 | 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 | |||
![]() |
1.1 | 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}} |