Copy entities in your design mapping

Last modified by Danniar Firdausy on 2023/09/08 08:55

In this microlearning, we will focus on duplicating specific elements of a target defintion.

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 to overcome specific situations where conditional mapping to fill list entities is required. For instance based on a value in the source entity, the target entity is filled differently based on source value. For instance when the target message definition requires a repeating entity that is duplicated as many times as required and is filled with different values from the source definition (parameter entity repeated with as many parameters as required).

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 modus, 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 is indicated in the Design phase whilst editing the design transformation
  • Adding notes is key to ensure the reasons why are document
  • Copy entities should be peer reviewed to ensure the right solution is implemented

5. Suggested Additional Readings

None