Set as mapped in message mapping

{{container}}{{container layoutStyle="columns"}}(((

In this microlearning, we'll cover the concept of setting an attribute as "mapped" during message mapping. This means you're indicating that a specific attribute will be filled with a static input, rather than being mapped from the source data. Essentially, this allows you to enrich the output by adding values where needed. We'll walk you through how to do this and also how to add notes to your mappings, making it easier to communicate decisions and ensure the quality of your integrations.

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 how you can place an attribute on set as mapped while doing the message mapping.

14

15

With set as mapped we mean: Registering that a certain attribute will be filled with a static input

16

17

In other words, enriching the output based on a static input instead of something in the input definition

18

19

== 3. Set as mapped in message mapping ==

20

21

Let us return to where we stopped in the last microlearning by showing the message mapping overview with the lines we drew

22

23

[[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-set-as-mapped-in-message-mapping--message-mapping-overview-drawed-lines.png]]

24

25

As you see, the Description attribute on the Crash Course level is not mapped yet but is mandatory.

26

To register that we want to use a static input we have to press Start Editing to enter the Start Editing Mode.

27

28

After that, we navigate to the attribute in question, right mouse click, and set it as mapped.

29

30

[[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-set-as-mapped-in-message-mapping--message-mapping-set-as-mapped-context-menu.png]]

31

32

To indicate that a certain attribute has been registered set as mapped eMagiz will show a cube icon in front of the attribute

33

34

[[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-set-as-mapped-in-message-mapping--message-mapping-overview-set-as-mapped.png]]

35

36

As you can see, all mandatory elements have been mapped with the help of our message mapping. Therefore we can conclude that the message mapping is done.

37

38

{{info}}In the case that you have made a mistake and did not want to set this specific attribute to set as mapped you can right-click on the attribute to access the context menu and select unset as mapped.{{/info}}

39

40

=== 3.1 Adding notes ===

41

42

A nice addition to the functionality surrounding message mapping is that you can add notes to tell others if a certain mutation on the input field is necessary or what the static input should be.

43

You can add a note by right-clicking on the attribute and selecting the option New/Edit Note

44

45

[[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-set-as-mapped-in-message-mapping--message-mapping-overview-add-note.png]]

46

47

Selecting this option will lead you to the following pop-up. In this pop-up, you can fill in some information that can help others that will create the transformation later on in Create.

48

A example of such an entry would be:

49

50

[[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-set-as-mapped-in-message-mapping--message-mapping-overview-add-note-filled-in.png]]

51

52

After you have saved the note an icon will appear on the attribute letting you and others know that some notation has been made on that attribute that is worth reading.

53

54

[[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-set-as-mapped-in-message-mapping--message-mapping-overview-add-note-icon.png]]

55

56

== 4. Key takeaways ==

57

58

* With the set as mapped functionality you can register for (mandatory) attributes that the input is a static value

59

* Adding notes can help improve the quality of work and help you to explain to others why you have made certain choices

60

61

== 5. Suggested Additional Readings ==

62

63

* [[Crash Courses (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.WebHome||target="blank"]]

64

** [[Crash Course Platform (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.WebHome||target="blank"]]

65

*** [[What is a message mapping (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-design-what-is-a-message-mapping||target="blank"]]

66

*** [[Drawing lines in message mapping (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-design-drawing-lines-in-message-mapping||target="blank"]]

67

* [[Intermediate (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome||target="blank"]]

68

** [[Design your transformations (Navigation) >>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Design your transformations.WebHome||target="blank"]]

69

*** [[Copy entities in your design mapping (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Design your transformations.intermediate-design-transformations-copy-entities||target="blank"]]

70

* [[Message Mapping (Search Result)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&l_space_facet=10&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22api+gateway%22||target="blank"]]

71

72

)))((({{toc/}}))){{/container}}{{/container}}

Wiki source code of Set as mapped in message mapping

Navigation