Skip to Content

Changes for page Setting Up the CDM

Last modified by Danniar Firdausy on 2024/08/21 15:41
From version 23.1
edited by Erik Bakker
on 2023/01/19 19:58
Change comment: There is no comment for this version
To version 15.1
edited by eMagiz
on 2022/05/10 11:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,0 @@
1 -Setting Up the CDM
Parent
... ... @@ -1,1 +1,0 @@
1 -WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.marijn
Default language
... ... @@ -1,1 +1,0 @@
1 -en
Content
... ... @@ -1,9 +1,21 @@
1 -{{container}}{{container layoutStyle="columns"}}(((
1 +{{html wiki="true"}}
2 +<div class="ez-academy">
3 + <div class="ez-academy_body">
4 +
5 +<div class="doc">
6 +
7 +
8 +
9 += Setting Up the CDM =
10 +
2 2  In the last microlearning, we learned what the CDM is and how you should use it when building messaging integrations.
3 3  In this microlearning how you should go about whilst setting up the CDM.
4 4  
5 -Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
14 +Should you have any questions, please contact academy@emagiz.com.
6 6  
16 +* Last update: February 26th, 2021
17 +* Required reading time: 7 minutes
18 +
7 7  == 1. Prerequisites ==
8 8  
9 9  * Basic knowledge of the eMagiz platform
... ... @@ -20,11 +20,20 @@
20 20  * Choose one naming convention and one language
21 21  * Discuss which characteristics (i.e. attributes) belong to which entities
22 22  
35 +
36 +
23 23  == 3. Setting Up the CDM ==
24 24  
25 25  In the last microlearning, we learned what the CDM is and what it represents within the context of eMagiz.
26 26  In this microlearning, we will take a closer look at the CDM in terms of how you can create the CDM and maintain the CDM when your integration landscape grows.
27 27  
42 +There are several key considerations we should take into account when setting up and managing the CDM:
43 +
44 +* When you throw something away that is already used in Create you also lose that
45 +* Be careful with promoting to CDM. This can lead to replication of entities (i.e. Order and Order_1)
46 +* Choose one naming convention and one language
47 +* Discuss which characteristics (i.e. attributes) belong to which entities
48 +
28 28  === 3.1 Delete behavior ===
29 29  
30 30  Before we start discussing how you should create the first contours of the CDM and how you can manage the CDM
... ... @@ -63,11 +63,11 @@
63 63  
64 64  The first option would be to add all these characteristics to the Order entity which will result in the following solution in your CDM.
65 65  
66 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-setting-up-the-cdm--first-option.png]]
87 +<p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--first-option.png||]]</p>
67 67  
68 68  A second option would be to create a separate entity for DateTime which has a Type and a Value.
69 69  
70 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-setting-up-the-cdm--second-option.png]]
91 +<p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--second-option.png||]]</p>
71 71  
72 72  Both options have their advantages and disadvantages. The point of the matter is that you should make consistent choices with regards to which option you choose for your CDM.
73 73  
... ... @@ -84,19 +84,20 @@
84 84  If you navigate to Design and access the context menu to get to the system message you will see a canvas in which the system message is filled in or not.
85 85  If it is filled in you can promote the structure that is represented in the system message to the CDM
86 86  
87 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-setting-up-the-cdm--promote-to-cdm.png]]
108 +<p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--promote-to-cdm.png||]]</p>
88 88  
89 89  You can do so after you have left Start Editing Mode. By selecting this button any existing creation on the CDM message level will be wiped clean.
90 90  To remind you of that eMagiz shows you the following pop-up
91 91  
92 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-setting-up-the-cdm--promote-to-cdm-warning.png]]
113 +<p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--promote-to-cdm-warning.png||]]</p>
93 93  
94 94  When you are confident that this is the right move you can press the Promote button.
95 95  This will promote the system message to the CDM message and in turn, will add the entities and attributes to the CDM.
96 96  This behavior is shown below
97 97  
98 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-setting-up-the-cdm--promote-to-cdm-result.png]]
119 +<p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--promote-to-cdm-result.png||]]</p>
99 99  
121 +===== Practice =====
100 100  
101 101  == 4. Assignment ==
102 102  
... ... @@ -106,12 +106,14 @@
106 106  == 5. Key takeaways ==
107 107  
108 108  * Key considerations when setting up the CDM are:
109 - ** When you throw something away that is already used in Create you also lose that
110 - ** Be careful with promoting to CDM. This can lead to replication of entities (i.e. Order and Order_1)
111 - ** Choose one naming convention and one language
112 - ** Discuss which characteristics (i.e. attributes) belong to which entities
131 + * When you throw something away that is already used in Create you also lose that
132 + * Be careful with promoting to CDM. This can lead to replication of entities (i.e. Order and Order_1)
133 + * Choose one naming convention and one language
134 + * Discuss which characteristics (i.e. attributes) belong to which entities
113 113  * Always take these considerations in mind when maintaining your CDM
114 114  
137 +
138 +
115 115  == 6. Suggested Additional Readings ==
116 116  
117 117  If you are interested in this topic and want more information on it please read the help text provided by eMagiz.
... ... @@ -120,6 +120,10 @@
120 120  
121 121  This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
122 122  
123 -{{video attachment="crashcourse-messaging-setting-up-the-cdm.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
147 +<iframe width="1280" height="720" src="../../vid/microlearning/crashcourse-messaging-setting-up-the-cdm.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
124 124  
125 -)))((({{toc/}}))){{/container}}{{/container}}
149 +</div>
150 +</div>
151 +</div>
152 +
153 +{{/html}}