Skip to Content
Version 8.1 by eMagiz on 2022/05/10 11:16
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 = Setting Up the CDM =
10
11 In the last microlearning, we learned what the CDM is and how you should use it when building messaging integrations.
12 In this microlearning how you should go about whilst setting up the CDM.
13
14 Should you have any questions, please contact academy@emagiz.com.
15
16 * Last update: February 26th, 2021
17 * Required reading time: 7 minutes
18
19 == 1. Prerequisites ==
20
21 * Basic knowledge of the eMagiz platform
22
23 == 2. Key concepts ==
24
25 This microlearning centers around setting up the CDM via eMagiz.
26 By setting up we mean: Creating the CDM for the first time and maintaining it when changes occur
27
28 Key considerations when setting up the CDM are:
29
30 * When you throw something away that is already used in Create you also lose that
31 * Be careful with promoting to CDM. This can lead to replication of entities (i.e. Order and Order_1)
32 * Choose one naming convention and one language
33 * Discuss which characteristics (i.e. attributes) belong to which entities
34
35
36
37 == 3. Setting Up the CDM ==
38
39 In the last microlearning, we learned what the CDM is and what it represents within the context of eMagiz.
40 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.
41
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
49 === 3.1 Delete behavior ===
50
51 Before we start discussing how you should create the first contours of the CDM and how you can manage the CDM
52 properly we would like to first address the fact that when you delete something in the CDM it can impact a lot of integrations within your landscape.
53
54 So before deleting anything from the CDM always consult with at least one colleague before proceeding.
55
56 === 3.2 Promoting to CDM ===
57
58 An easy way to start building your CDM is to use the Promote to CDM functionality.
59 However, this functionality has two downsides you need to be aware of before thinking of using this functionality:
60
61 * If you already have a CDM message for the message type for which you press Promote to CDM it will overwrite that CDM Message (which could lead to loss of data across your integration landscape)
62 * If a certain entity already exists in the CDM the Promote to CDM **won't** override it but will create a new entity with a \_1 behind it. So Order will become Order_1
63
64 Having said that, when the CDM is still empty and you have a dominant system within your integration landscape that feeds most data this is a useful method to quickly start building your CDM.
65
66 === 3.3 One naming convention ===
67
68 A third consideration before adding entities and attributes to the canvas is the naming convention that will be used.
69 This naming convention consists of two aspects:
70
71 * The language (choose one language and don't mix languages)
72 * The notation of the names of entities and attributes. Do you start each word with a capital for example (i.e. PaymentCompensation)? Or do you start each new word with capital with exception of the first word (i.e. paymentCompensation)
73
74 === 3.4 What belongs to what ===
75
76 The fourth consideration you should take into account when setting up and maintaining your CDM is how you are going to assign certain attributes to certain entities.
77 For example, if you have an Order with the following attributes there are two distinct ways of creating this in your CDM:
78
79 * ID
80 * Name
81 * Description
82 * ExecutionDateTime
83 * ReceivedDateTime
84
85 The first option would be to add all these characteristics to the Order entity which will result in the following solution in your CDM.
86
87 <p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--first-option.png||]]</p>
88
89 A second option would be to create a separate entity for DateTime which has a Type and a Value.
90
91 <p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--second-option.png||]]</p>
92
93 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.
94
95 === 3.5 Building the CDM ===
96
97 Now that we have discussed the key considerations let us turn our attention to actually learning how to build the CDM. There are two distinct methods of adding information to the CDM:
98
99 * Drag and drop entities to the canvas and manually add attributes (as we learned in the crash course platform)
100 * Use the promote CDM button on the message level
101
102 In this microlearning, we will not explain the dragging and dropping of entities and adding attributes again.
103 Instead, we will explain a new piece of functionality we have not explained yet called the Promote to CDM.
104
105 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.
106 If it is filled in you can promote the structure that is represented in the system message to the CDM
107
108 <p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--promote-to-cdm.png||]]</p>
109
110 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.
111 To remind you of that eMagiz shows you the following pop-up
112
113 <p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--promote-to-cdm-warning.png||]]</p>
114
115 When you are confident that this is the right move you can press the Promote button.
116 This will promote the system message to the CDM message and in turn, will add the entities and attributes to the CDM.
117 This behavior is shown below
118
119 <p align="center">[[image:crashcourse-messaging-setting-up-the-cdm--promote-to-cdm-result.png||]]</p>
120
121 ===== Practice =====
122
123 == 4. Assignment ==
124
125 Add the content of a system message to the CDM via the drag and drop functionality eMagiz offers on the CDM level.
126 This assignment can be completed with the help of your (Academy) project you have created/used in the previous assignment.
127
128 == 5. Key takeaways ==
129
130 * Key considerations when setting up the CDM are:
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
135 * Always take these considerations in mind when maintaining your CDM
136
137
138
139 == 6. Suggested Additional Readings ==
140
141 If you are interested in this topic and want more information on it please read the help text provided by eMagiz.
142
143 == 7. Silent demonstration video ==
144
145 This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
146
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>
148
149 </div>
150 </div>
151 </div>
152
153 {{/html}}