Wiki source code of Exercises
Version 17.1 by Carlijn Kokkeler on 2022/10/19 12:31
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. | ||
| |
9.1 | 16 | |
| |
10.1 | 17 | * Creating a CDM |
| |
14.1 | 18 | Please import the file Order.xsd in your CDM. The code for this file can be found in section 4. Code for xsd files. |
| |
12.1 | 19 | * Creating a CDM message |
| |
13.1 | 20 | Now, go to your CDM message and select Order as root entity. |
| 21 | Add all other entities and attributes from Order.xsd, which were imported into the CDM, to your CDM message definition. | ||
| |
12.1 | 22 | * Creating a system message |
| |
14.1 | 23 | In one of your System messages, import the file TransportOrder.xsd. The code for this file can be found at the bottom of this page. |
| 24 | * Creating a CDM message | ||
| |
13.1 | 25 | Select CreateOrder as root entity and add all other entities and attributes to your system definition. |
| 26 | * Complete message mapping | ||
| 27 | Now that you have completed these steps, go to Message mapping and complete the mapping. | ||
| |
10.1 | 28 | |
| |
9.1 | 29 | The solutions to these exercises can be found [[here>>doc:Main.eMagiz Academy.Use Cases.Data modeling in Design.Exercises.Solutions.WebHome||target="blank"]]. |
| |
1.1 | 30 | |
| |
14.1 | 31 | == 4. Code for xsd files == |
| |
17.1 | 32 | === 4.1 Code for Order.xsd === |
| |
16.1 | 33 | {{code language="xml"}} |
| |
14.1 | 34 | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" |
| 35 | xmlns="http://www.carlijnsplatform.com/ns/capetms/cdm/1.0/" | ||
| 36 | attributeFormDefault="unqualified" | ||
| 37 | elementFormDefault="qualified" | ||
| 38 | targetNamespace="http://www.carlijnsplatform.com/ns/capetms/cdm/1.0/"> | ||
| 39 | <xs:complexType name="Order"> | ||
| 40 | <xs:sequence> | ||
| 41 | <xs:element name="Date" type="xs:dateTime"/> | ||
| 42 | <xs:element name="OrderId" type="nonEmptyString"/> | ||
| 43 | <xs:element name="Customer" type="Customer"/> | ||
| 44 | <xs:element name="PickupAddress" type="PickupAddress"/> | ||
| 45 | <xs:element name="DeliveryAddress" type="DeliveryAddress"/> | ||
| 46 | <xs:element maxOccurs="unbounded" name="OrderLine" type="OrderLine"/> | ||
| 47 | </xs:sequence> | ||
| 48 | </xs:complexType> | ||
| 49 | <xs:complexType name="Customer"> | ||
| 50 | <xs:sequence> | ||
| 51 | <xs:element name="Name" type="nonEmptyString"/> | ||
| 52 | <xs:element name="Email" type="nonEmptyString"/> | ||
| 53 | </xs:sequence> | ||
| 54 | </xs:complexType> | ||
| 55 | <xs:complexType name="PickupAddress"> | ||
| 56 | <xs:sequence> | ||
| 57 | <xs:element name="Name" type="nonEmptyString"/> | ||
| 58 | <xs:element name="Street" type="nonEmptyString"/> | ||
| 59 | <xs:element name="StreetNumber" type="nonEmptyString"/> | ||
| 60 | <xs:element name="PostalCode" type="nonEmptyString"/> | ||
| 61 | <xs:element name="City" type="nonEmptyString"/> | ||
| 62 | <xs:element name="Country" type="nonEmptyString"/> | ||
| 63 | </xs:sequence> | ||
| 64 | </xs:complexType> | ||
| 65 | <xs:complexType name="DeliveryAddress"> | ||
| 66 | <xs:sequence> | ||
| 67 | <xs:element name="Name" type="nonEmptyString"/> | ||
| 68 | <xs:element name="Street" type="nonEmptyString"/> | ||
| 69 | <xs:element name="StreetNumber" type="nonEmptyString"/> | ||
| 70 | <xs:element name="PostalCode" type="nonEmptyString"/> | ||
| 71 | <xs:element name="City" type="nonEmptyString"/> | ||
| 72 | <xs:element name="Country" type="nonEmptyString"/> | ||
| 73 | </xs:sequence> | ||
| 74 | </xs:complexType> | ||
| 75 | <xs:complexType name="OrderLine"> | ||
| 76 | <xs:sequence> | ||
| 77 | <xs:element name="PackageUnit" type="nonEmptyString"/> | ||
| 78 | <xs:element name="Quantity" type="xs:long"/> | ||
| 79 | <xs:element name="Description" type="nonEmptyString"/> | ||
| 80 | <xs:element name="Weight" type="xs:decimal"/> | ||
| 81 | </xs:sequence> | ||
| 82 | </xs:complexType> | ||
| 83 | <xs:simpleType name="nonEmptyString"> | ||
| 84 | <xs:restriction base="xs:string"> | ||
| 85 | <xs:minLength value="1"/> | ||
| 86 | </xs:restriction> | ||
| 87 | </xs:simpleType> | ||
| 88 | <xs:element name="Order" type="Order"/> | ||
| 89 | </xs:schema> | ||
| 90 | {{/code}} | ||
| |
16.1 | 91 | |
| |
17.1 | 92 | === 4.2 Code for TransportOrder.xsd === |
| |
16.1 | 93 | {{code language="xml"}} |
| 94 | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" | ||
| 95 | xmlns="https://transportinc.nl/ns/tms/1.0/" | ||
| 96 | attributeFormDefault="unqualified" | ||
| 97 | elementFormDefault="unqualified" | ||
| 98 | targetNamespace="https://transportinc.nl/ns/tms/1.0/"> | ||
| 99 | <xs:complexType name="CreateOrder"> | ||
| 100 | <xs:sequence> | ||
| 101 | <xs:element name="Order" type="Order"/> | ||
| 102 | </xs:sequence> | ||
| 103 | </xs:complexType> | ||
| 104 | <xs:complexType name="Order"> | ||
| 105 | <xs:sequence> | ||
| 106 | <xs:element name="OrderID"> | ||
| 107 | <xs:simpleType> | ||
| 108 | <xs:restriction base="xs:string"> | ||
| 109 | <xs:maxLength value="200"/> | ||
| 110 | </xs:restriction> | ||
| 111 | </xs:simpleType> | ||
| 112 | </xs:element> | ||
| 113 | <xs:element name="OrderDate" type="xs:dateTime"/> | ||
| 114 | <xs:element minOccurs="0" name="Order_Customer" type="Order_Customer"/> | ||
| 115 | <xs:element name="Address" type="Address"/> | ||
| 116 | <xs:element name="PartnerInfo_Order" type="PartnerInfo_Order"/> | ||
| 117 | <xs:element name="OrderLine_Order" type="OrderLine_Order"/> | ||
| 118 | </xs:sequence> | ||
| 119 | </xs:complexType> | ||
| 120 | <xs:complexType name="Order_Customer"> | ||
| 121 | <xs:sequence> | ||
| 122 | <xs:element minOccurs="0" name="Customer" type="Customer"/> | ||
| 123 | </xs:sequence> | ||
| 124 | </xs:complexType> | ||
| 125 | <xs:complexType name="Customer"> | ||
| 126 | <xs:sequence> | ||
| 127 | <xs:element name="Name"> | ||
| 128 | <xs:simpleType> | ||
| 129 | <xs:restriction base="xs:string"> | ||
| 130 | <xs:maxLength value="200"/> | ||
| 131 | </xs:restriction> | ||
| 132 | </xs:simpleType> | ||
| 133 | </xs:element> | ||
| 134 | <xs:element minOccurs="0" name="Contact_Customer" type="Contact_Customer"/> | ||
| 135 | </xs:sequence> | ||
| 136 | </xs:complexType> | ||
| 137 | <xs:complexType name="Contact_Customer"> | ||
| 138 | <xs:sequence> | ||
| 139 | <xs:element maxOccurs="unbounded" | ||
| 140 | minOccurs="0" | ||
| 141 | name="Contact" | ||
| 142 | type="Contact"/> | ||
| 143 | </xs:sequence> | ||
| 144 | </xs:complexType> | ||
| 145 | <xs:complexType name="Contact"> | ||
| 146 | <xs:sequence> | ||
| 147 | <xs:element name="eMail"> | ||
| 148 | <xs:simpleType> | ||
| 149 | <xs:restriction base="xs:string"> | ||
| 150 | <xs:maxLength value="200"/> | ||
| 151 | </xs:restriction> | ||
| 152 | </xs:simpleType> | ||
| 153 | </xs:element> | ||
| 154 | <xs:element minOccurs="0" name="Name"> | ||
| 155 | <xs:simpleType> | ||
| 156 | <xs:restriction base="xs:string"> | ||
| 157 | <xs:maxLength value="200"/> | ||
| 158 | </xs:restriction> | ||
| 159 | </xs:simpleType> | ||
| 160 | </xs:element> | ||
| 161 | </xs:sequence> | ||
| 162 | </xs:complexType> | ||
| 163 | <xs:complexType name="Address"> | ||
| 164 | <xs:sequence> | ||
| 165 | <xs:element name="Type" type="nonEmptyString"/> | ||
| 166 | <xs:element name="Name" type="nonEmptyString"/> | ||
| 167 | <xs:element name="Street" type="nonEmptyString"/> | ||
| 168 | <xs:element name="PostalCode" type="nonEmptyString"/> | ||
| 169 | <xs:element name="City" type="nonEmptyString"/> | ||
| 170 | <xs:element name="Country" type="nonEmptyString"/> | ||
| 171 | </xs:sequence> | ||
| 172 | </xs:complexType> | ||
| 173 | <xs:complexType name="PartnerInfo_Order"> | ||
| 174 | <xs:sequence> | ||
| 175 | <xs:element maxOccurs="unbounded" | ||
| 176 | minOccurs="0" | ||
| 177 | name="PartnerInfo" | ||
| 178 | type="PartnerInfo"/> | ||
| 179 | </xs:sequence> | ||
| 180 | </xs:complexType> | ||
| 181 | <xs:complexType name="PartnerInfo"> | ||
| 182 | <xs:sequence> | ||
| 183 | <xs:element name="UUID"> | ||
| 184 | <xs:simpleType> | ||
| 185 | <xs:restriction base="xs:string"> | ||
| 186 | <xs:maxLength value="64"/> | ||
| 187 | </xs:restriction> | ||
| 188 | </xs:simpleType> | ||
| 189 | </xs:element> | ||
| 190 | </xs:sequence> | ||
| 191 | </xs:complexType> | ||
| 192 | <xs:complexType name="OrderLine_Order"> | ||
| 193 | <xs:sequence> | ||
| 194 | <xs:element maxOccurs="unbounded" | ||
| 195 | minOccurs="0" | ||
| 196 | name="OrderLine" | ||
| 197 | type="OrderLine"/> | ||
| 198 | </xs:sequence> | ||
| 199 | </xs:complexType> | ||
| 200 | <xs:complexType name="OrderLine"> | ||
| 201 | <xs:sequence> | ||
| 202 | <xs:element name="Description"> | ||
| 203 | <xs:simpleType> | ||
| 204 | <xs:restriction base="xs:string"> | ||
| 205 | <xs:maxLength value="200"/> | ||
| 206 | </xs:restriction> | ||
| 207 | </xs:simpleType> | ||
| 208 | </xs:element> | ||
| 209 | <xs:element name="Quantity" type="xs:long"/> | ||
| 210 | <xs:element name="Unit" type="Enum"/> | ||
| 211 | <xs:element minOccurs="0" name="Weight" type="xs:double"/> | ||
| 212 | </xs:sequence> | ||
| 213 | </xs:complexType> | ||
| 214 | <xs:simpleType name="nonEmptyString"> | ||
| 215 | <xs:restriction base="xs:string"> | ||
| 216 | <xs:minLength value="1"/> | ||
| 217 | </xs:restriction> | ||
| 218 | </xs:simpleType> | ||
| 219 | <xs:simpleType name="Enum"> | ||
| 220 | <xs:restriction base="xs:string"> | ||
| 221 | <xs:enumeration value="COLLI"/> | ||
| 222 | <xs:enumeration value="EURO"/> | ||
| 223 | <xs:enumeration value="BOX"/> | ||
| 224 | <xs:enumeration value="SACK"/> | ||
| 225 | </xs:restriction> | ||
| 226 | </xs:simpleType> | ||
| 227 | <xs:element name="CreateOrder" type="CreateOrder"/> | ||
| 228 | </xs:schema> | ||
| 229 | {{/code}} | ||
| |
14.1 | 230 | == 5. Key takeaways == |
| |
1.1 | 231 | |
| |
8.1 | 232 | * The CDM holds all entities and attributes that are relevant within the context of your complete integration landscape. |
| 233 | * The CDM message is tailor-made for a specific piece of data and only holds the entities and attributes relevant for that piece of data. | ||
| 234 | * A system message is specific to a system. | ||
| |
1.1 | 235 | |
| 236 | |||
| |
14.1 | 237 | == 6. Suggested Additional Readings == |
| |
1.1 | 238 | |
| |
8.1 | 239 | If you are interested in this topic and want more information on it please read the help text provided by eMagiz. |
| |
1.1 | 240 | |
| 241 | |||
| 242 | |||
| 243 | )))((({{toc/}}))){{/container}}{{/container}} |