Wiki source code of What is a message mapping
Last modified by Martijn Woudstra on 2022/08/08 15:31
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{container}}{{container layoutStyle="columns"}}((( | ||
| 2 | |||
| 3 | In this microlearning, we will educate you on what we mean when we talk about message mapping | ||
| 4 | |||
| 5 | Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]]. | ||
| 6 | |||
| 7 | == 1. Prerequisites == | ||
| 8 | |||
| 9 | * Basic knowledge of the eMagiz platform | ||
| 10 | |||
| 11 | == 2. Key concepts == | ||
| 12 | |||
| 13 | This microlearning centers around understanding the concept of message mapping | ||
| 14 | |||
| 15 | With message mapping we mean: Drawing lines, making notes, and defining static inputs between two message definitions to identify how data elements will be transformed from the source to the target definition | ||
| 16 | |||
| 17 | In other words, the art of good message mapping lies within your ability to correctly translate between two definitions. eMagiz will help you to make that art a reality. | ||
| 18 | |||
| 19 | == 3. What is a message mapping == | ||
| 20 | |||
| 21 | A message mapping is a visual representation of how data is translated from the source definition to the target definition. | ||
| 22 | In all integration patterns (Messaging, API Gateway, and Event Streaming) you can translate data elements between definitions. | ||
| 23 | |||
| 24 | You can access a message mapping when you navigate to the Design phase of eMagiz. | ||
| 25 | |||
| 26 | [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-what-is-a-message-mapping--design-overview.png]] | ||
| 27 | |||
| 28 | In this phase, you can open the context menu on the integration level (remember, that is a line between eMagiz and an external system). | ||
| 29 | The context menu will look slightly different for each integration pattern. These differ as the use case for each pattern differs slightly. | ||
| 30 | |||
| 31 | [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-what-is-a-message-mapping--context-menu-messaging-mapping.png]] | ||
| 32 | |||
| 33 | [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-what-is-a-message-mapping--context-menu-api-mapping.png]] | ||
| 34 | |||
| 35 | [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-what-is-a-message-mapping--context-menu-es-mapping.png]] | ||
| 36 | |||
| 37 | Selecting one of the above options will lead you to an overview similar to the one shown below. | ||
| 38 | |||
| 39 | [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-what-is-a-message-mapping--message-mapping-overview.png]] | ||
| 40 | |||
| 41 | In this overview, you can actualize the message mapping between the system (identifiable by the blue bar above the definition) and eMagiz (identifiable by the green bar above the definition). | ||
| 42 | In the next microlearning, we will continue to actualize the message mapping so we can transform the data between the external system and eMagiz. | ||
| 43 | |||
| 44 | |||
| 45 | |||
| 46 | == 4. Assignment == | ||
| 47 | |||
| 48 | Navigate to Design and open the message mapping option of at least one integration within your project. | ||
| 49 | This assignment can be completed within the (Academy) project that you have created/used in the previous assignment. | ||
| 50 | |||
| 51 | == 5. Key takeaways == | ||
| 52 | |||
| 53 | With message mapping we mean: Drawing lines, making notes, and defining static inputs between two message definitions to identify how data elements will be transformed from the source to the target definition | ||
| 54 | In other words, the art of good message mapping lies within your ability to correctly translate between two definitions. eMagiz will help you to make that art a reality. | ||
| 55 | |||
| 56 | |||
| 57 | |||
| 58 | == 6. Suggested Additional Readings == | ||
| 59 | |||
| 60 | If you are interested in this topic and want more information on it please read the help text provided by eMagiz. | ||
| 61 | |||
| 62 | == 7. Silent demonstration video == | ||
| 63 | |||
| 64 | This video demonstrates a working solution and how you can validate whether you have successfully completed the assignment. | ||
| 65 | |||
| 66 | {{video attachment="crashcourse-platform-design-what-is-a-message-mapping.mp4" reference="Main.Videos.Microlearning.WebHome"/}} | ||
| 67 | |||
| 68 | )))((({{toc/}}))){{/container}}{{/container}} |