Last modified by Erik Bakker on 2023/08/23 15:22
Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 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 listener on that 'custom' queue to ensure that data will be processed.
3
4 Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
5
6 == 1. Prerequisites ==
7
8 * Advanced knowledge of the eMagiz platform
9 * Intermediate course on Orchestration of data packets
10
11 == 2. Key concepts ==
12
13 This microlearning centers around listening for data on a custom queue
14 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
15
16 To start listening for data on a custom queue, you need:
17
18 * A JMS message-driven channel adapter within your flow that listens for data on the 'custom' queue
19 * The fully qualified name of the 'custom' queue on which to listen
20
21 == 3. listening for data on a custom queue ==
22
23 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 listener on that 'custom' queue to ensure that data will be processed.
24
25 To start listening for data on a custom queue, you need:
26
27 * A JMS message-driven channel adapter within your flow that listens for data on the 'custom' queue
28 * The fully qualified name of the 'custom' queue on which to listen
29
30 === 3.1 Setting up the listener ===
31
32 To set up the listener 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 message-driven 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.
33
34 [[image:Main.Images.Microlearning.WebHome@advanced-orchestration-of-data-packets-listening-for-data-on-a-custom-queue--jms-message-listener-empty.png]]
35
36 Here, you need to define the channel you want to place the messages you receive, the connection factory, and the queue name you want to listen on. Note that when there is no bus-connection-plain support object available within the context of your flow, copy + paste this component from another flow in which it is available.
37
38 [[image:Main.Images.Microlearning.WebHome@advanced-orchestration-of-data-packets-listening-for-data-on-a-custom-queue--jms-message-listener-filled-in.png]]
39
40 The moment you are satisfied, you can press Save on the component. Now you have successfully ensured that you listen for messages on a 'custom' queue.
41
42 == 4. Key takeaways ==
43
44 * A JMS message-driven channel adapter within your flow that listens for data on the 'custom' queue
45 * The fully qualified name of the 'custom' queue on which to listen
46 * When the support object named bus-connection-plain is missing, please add it via a copy+paste action
47
48 == 5. Suggested Additional Readings ==
49
50 If you are interested in this topic and want more information, please read the release notes provided by eMagiz.)))((({{toc/}}))){{/container}}{{/container}}