Skip to Content
Version 1.1 by eMagiz on 2022/05/05 16:16
Show last authors
1 {{html wiki="true"}}
2 <div class="ez-academy">
3 <div class="ez-academy_body">
4
5 <div class="doc">
6
7
8
9 = Sending data to a custom queue =
10
11 In some cases, there is a need to listen on a 'custom' queue for data. For example, when retrieving large amounts of data, you might need to place parts of the data on the queue to free up memory to process the complete batch of data. For those (and other) situations, it could be helpful to create 'custom' in-between queues. We need an additional writer on that 'custom' queue to ensure that data will be placed on the queue.
12
13 Should you have any questions, please get in touch with academy@emagiz.com.
14
15 * Last update: November 1st, 2021
16 * Required reading time: 5 minutes
17
18 == 1. Prerequisites ==
19
20 * Advanced knowledge of the eMagiz platform
21 * Intermediate course on Orchestration of data packets
22
23 == 2. Key concepts ==
24
25 This microlearning centers around sending data to a custom queue
26 With a custom queue, we mean: A queue that is manually defined by an eMagiz user instead of eMagiz itself as a result of an automated process
27
28 To send data to a custom queue, you need:
29
30 * A JMS outbound channel adapter within your flow that sends data to the 'custom' queue
31 * The fully qualified name of the 'custom' queue on which to listen
32
33
34
35 == 3. Sending data to a custom queue ==
36
37 In some cases, there is a need to listen on a 'custom' queue for data. For example, when retrieving large amounts of data, you might need to place parts of the data on the queue to free up memory to process the complete batch of data. For those (and other) situations, it could be helpful to create 'custom' in-between queues. We need an additional writer on that 'custom' queue to ensure that data will be placed on the queue.
38
39 To send data to a custom queue, you need:
40
41 * A JMS outbound channel adapter within your flow that sends data to the 'custom' queue
42 * The fully qualified name of the 'custom' queue on which to listen
43
44 === 3.1 Setting up the outbound channel adapter ===
45
46 To set up the outbound channel adapter, navigate to the flow in Create in which you want to listen for messages on the 'custom' queue and enter "Start Editing" mode. After doing so, add the JMS outbound channel adapter to the canvas by dragging it on the canvas. Subsequently, double-click on the component to open it so you can edit it.
47
48 <p align="center">[[image:advanced-orchestration-of-data-packets-sending-data-to-a-custom-queue--jms-outbound-channel-adapter-empty.png||]]</p>
49
50 Here, you need to define the channel from which you retrieve the messages that need to be placed on the queue, the connection factory, the queue name you want to send data to, and deselect the option Extract payload.
51
52 <p align="center">[[image:advanced-orchestration-of-data-packets-sending-data-to-a-custom-queue--jms-outbound-channel-adapter-filled-in.png||]]</p>
53
54 The moment you are satisfied, you can press Save on the component. Now you have successfully ensured that you send messages to a 'custom' queue.
55
56 ===== Practice =====
57
58 == 4. Assignment ==
59
60 Set up functionality to send messages to a 'custom' queue from an eMagiz flow. This assignment can be completed with the help of the (Academy) project that you have created/used in the previous assignment.
61
62 == 5. Key takeaways ==
63
64 * A JMS outbound channel adapter within your flow that sends data to the 'custom' queue
65 * The fully qualified name of the 'custom' queue on which to listen
66
67
68
69 == 6. Suggested Additional Readings ==
70
71 If you are interested in this topic and want more information, please read the release notes provided by eMagiz.
72
73 == 7. Silent demonstration video ==
74
75 This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
76
77 <iframe width="1280" height="720" src="../../vid/microlearning/advanced-orchestration-of-data-packets-sending-data-to-a-custom-queue.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
78
79 </div>
80 </main>
81 </div>
82 </div>
83
84 {{/html}}