Copy Entities and Add Notes in Design Transformation
In this microlearning, we will guide you to apply what we have seen in the previous microlearning, duplicating specific elements of a target definition and documenting your transformations in the Design phase.
Should you have any questions, please get in touch with academy@emagiz.com.
1. Prerequisites
- Completed the previous microlearnings of this intermediate course.
2. Exercise
Below, the exercise for this part of the intermediate course, which centers around duplicating specific elements of a target definition and documenting your transformations in eMagiz's Design phase, is given.
2.1. Copy entities and adding a note in your design mapping
In the previous microlearnings, we have learned what copying entities in the Design phase means, how to get there, and how copying entities here influences the transformation of the flow under concern in the Create phase. In addition, we have also learned how to add a note in Design Transformation to document the design choices that have been made. In this exercise, we will practice these two functionalities within eMagiz. To work on this exercise, first, try to construct a message mapping with the integration pattern of your choice (i.e., Messaging, API Gateway, or Event Streaming) and integration direction of your preference (i.e., system to CDM, CDM to system, gateway to system, or topic in to topic out). To apply what we have learned in this module, we will follow the sample case illustrated below.
Within the output is a list of which the number of elements is independent of the source message. The desired solution transforms the example message into the expected message below. On the left side, we have a source message of a Transport Order that needs to be mapped into the target Transport Order message shown on the right side, which contains a list of Actor and a list of Location. These lists are comprised of two elements that refer to the Sender (and its Location) and Receiver (and its Location). Try to solve this challenge by copying the entities under these two lists in Design Transformation. To better inform other stakeholders within the team of your design decision, please also attach a note describing this in your design mapping. You can use the following message definitions to kickstart you for creating the mapping and the sample messages for testing it later.
3. Solution
In this short movie, you will find the workout of this exercise. Take a moment to review this one and compare it to your solution. As an example, in this exercise, we use the Messaging pattern and apply these concepts in an onramp flow towards the CDM. More on how to work with Messaging pattern can be found in this microlearning. Similarly, you can also apply these concepts in other patterns, such as Event Streaming and API Gateway. We used XML message format here, but you can also use other message format such as JSON.