Skip to Content

Copy entities in your design mapping

Last modified by Danniar Firdausy on 2024/09/16 14:05

In this microlearning, we will explore how to duplicate specific elements within a target definition. By the end of this session, you'll understand how to copy entities during the Design phase and how this can be applied to meet transformation requirements in eMagiz.

Should you have any questions, please get in touch with academy@emagiz.com.

1. Prerequisites

  • Basic knowledge of the eMagiz platform

2. Key concepts

Copying entities in the Design phase can help address situations where conditional mapping is needed to populate list entities. For example, depending on a value in the source entity, the target entity can be filled differently. This is especially useful when the target message definition requires a repeating entity, which is duplicated as many times as necessary and filled with varying values from the source definition (such as a parameter entity being repeated with the required number of parameters).

3. Copy entities in the transformation

Navigate in the Design phase to the specific message mapping, topic mapping, request or response mapping. In the edit mode, you can right click on the specific target entity and press Copy.

intermediate-design-transformations-copy-entities_2.png

Once that option is clicked, the following view appears. There is a (+1) added to the entity level field, which indicates that there is one copy of this entity avalilable for specific transformation requirements. Pressing the Copy option once more indicates that there are 2 extra copies of that entity available. The mapping of source and target remains (and needs to be) exactly the same.

intermediate-design-transformations-copy-entities_3.png

The net result in the Create phase transformation is that there are as many additional entities available as configured in the Design phase. Which makes it possible to make specific transformations that allows to make conditional mapping possible of the attributes in that entity. For instance, based on the value of an attribute another attribute is giving different values.

intermediate-design-transformations-copy-entities_5.png

4. Key takeaways

  • Copying entities in the Design phase simplifies complex transformations, such as conditional mappings based on source values.
  • Copying entities allows for flexibility in the transformation process, enabling you to create multiple versions of an entity to meet specific requirements.
  • Documenting design decisions through notes during the message mapping process is essential for clarity and future reference.
  • Copy entities should be peer reviewed to ensure that the right solution is implemented

5. Suggested Additional Readings

If you are interested in this topic and want more information on it please read the help text provided by eMagiz and read the following links: