Skip to Content
Last modified by Danniar Firdausy on 2023/08/11 11:14
From version 3.2
edited by Erik Bakker
on 2022/08/23 09:57
Change comment: Update document after refactoring.
To version 12.1
edited by Danniar Firdausy
on 2023/08/09 15:42
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -intermediate-key-concepts-emagiz-messaging-messaging-synchronous
1 +Create Synchronous Messaging
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.dfirdausy
Default language
... ... @@ -1,0 +1,1 @@
1 +en
Content
... ... @@ -1,81 +1,26 @@
1 1  {{container}}
2 -{{container layoutStyle="columns"}}
3 -(((
4 -In this microlearning, we will explore what the function of the entry is within the message engine. Furthermore, we will explain why there is no entry queue.
2 +{{container layoutStyle="columns"}}(((
3 +In this exercise, we will guide create a simple synchronous messaging pattern based on the previous microlearnings.
5 5  
6 6  Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
7 7  
8 -* Last update: August 5th, 2021
9 -* Required reading time: 5 minutes
10 -
11 11  == 1. Prerequisites ==
12 12  
13 -* Intermediate knowledge of the eMagiz platform
9 +* Completed the previous microlearnings of this intermediate course.
14 14  
15 -== 2. Key concepts ==
11 +== 2. Exercise ==
16 16  
17 -This microlearning centers on the concept of entry, not a queue.
13 +Below, the exercise for this part of the intermediate course, which centers around the synchronous messaging pattern in eMagiz, is given.
14 +By synchronous, we mean The process that processes data and subsequently informs the caller what the status is.
18 18  
19 -* The key aspects are:
20 - * Entry is the starting point of the integration process in messaging
21 - * Queues are an internal resource of eMagiz
22 - * Outside parties are not allowed to write on eMagiz queues directly
23 - * eMagiz facilitates various connectivity methods (i.e., REST, SOAP, Database, File)
16 +=== 2.1. Creating Synchronous Messaging ===
17 +
18 +== 3. Solution ==
24 24  
20 +...
25 25  
22 +{{video attachment="Exercises - Intermediate - Key Concepts eMagiz Messaging [Create].mp4" reference="Main.Videos.Microlearning.WebHome"/}}
26 26  
27 -== 3. Entry, not a queue ==
28 -
29 -In this microlearning, we will explore what the function of the entry is within the message engine. Furthermore, we will explain why there is no entry queue.
30 -
31 -* The key aspects are:
32 - * Entry is the starting point of the integration process in messaging
33 - * Queues are an internal resource of eMagiz
34 - * Outside parties are not allowed to write on eMagiz queues directly
35 - * eMagiz facilitates various connectivity methods (i.e., REST, SOAP, Database, File)
36 -
37 -As you learned from the introductory course on messaging, we use a five-layer approach to handle data within the messaging engine. The first layer the data encounters is the entry. The goal of the entry is twofold. One is to establish a connection with an external system. The other is to place data on a queue. There are two ways to establish connectivity. The first method is via a pull mechanism. This pull mechanism means that eMagiz will initiate the communication to retrieve data. The second method is a push mechanism. This push mechanism means that eMagiz will patiently wait till the external system offers data to eMagiz. The push mechanism will typically be realized with the help of a hosted web service (REST or SOAP) within your eMagiz solution.
38 -
39 -Since the goal of the entry is connectivity between the external system and eMagiz, you could argue that it would be easy to let them place the data on the queue. However, things are not that easy. There are several reasons why this is not a best practice:
40 -
41 -* This would mean that the external system directly needs to connect to the infra layer (the JMS) and will have the option to read and write on other queues as well
42 -* This would mean that the external system can only push data to eMagiz (so no polling of data)
43 -* This would mean that the external system can directly place data on a queue
44 -* This would create a tightly coupled dependency between the external system and eMagiz
45 -
46 -The above arguments concluded that the connectivity between eMagiz and the external system and the internal queue mechanism of eMagiz should be considered two separate things. This conclusion did raise a question on how eMagiz can guarantee message delivery. The messaging engine uses queues to ensure message delivery. But what if the first queue (the onramp queue) cannot be reached? What happens then.
47 -
48 -The H2 database is introduced to safeguard against any problems within the entry. This component is generated in every entry in eMagiz. This H2 database will temporarily store data and act as a bridge between the entry and the onramp queue. This way, eMagiz can guarantee message delivery. If you want to learn more about the function of the H2 database, please check out this [microlearning](intermediate-solution-architecture-function-of-h2-database.md).
49 -
50 -To summarize:
51 -
52 -* Entry is the starting point of the integration process in messaging
53 -* Queues are an internal resource of eMagiz
54 -* Outside parties are not allowed to write on eMagiz queues directly
55 -* eMagiz facilitates various connectivity methods (i.e., REST, SOAP, Database, File)
56 -
57 -== 4. Assignment ==
58 -
59 -No assignment accompanies this microlearning.
60 -
61 -== 5. Key takeaways ==
62 -
63 -* The key aspects are:
64 - * Entry is the starting point of the integration process in messaging
65 - * Queues are an internal resource of eMagiz
66 - * Outside parties are not allowed to write on eMagiz queues directly
67 - * eMagiz facilitates various connectivity methods (i.e., REST, SOAP, Database, File)
68 -
69 -
70 -
71 -== 6. Suggested Additional Readings ==
72 -
73 -If you are interested in this topic, please boost your knowledge with the help of the internet.
74 -
75 -== 7. Silent demonstration video ==
76 -
77 -As this is a more theoretical microlearning, we have no video for this.
78 -
79 79  )))
80 80  
81 81  ((({{toc/}}))){{/container}}