Wiki source code of Manage Message Redelivery

Last modified by Danniar Firdausy on 2024/09/18 21:26

version	line-number	content
2.1	1	{{container}}
	2	{{container layoutStyle="columns"}}
	3	(((
8.1	4	{{warning}}
	5	Please note that this microlearning is for the new monitoring stack only.
	6	{{/warning}}
	7
16.6	8	In the previous [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Message Redelivery.intermediate-message-redelivery-configuration-gen3.WebHome\|\|target="blank"]], we have learned how to configure Message Redelivery functionality for a specific flow towards a system. In this microlearning, we will learn how you can view the messages that are currently waiting for message redelivery. On top of that, we will learn how you can perform actions on these messages. The primary step we will be focusing on is the redelivery of the message itself.
1.1	9
	10	Should you have any questions, please get in touch with academy@emagiz.com.
	11
	12	== 1. Prerequisites==
7.1	13	* Basic knowledge of the eMagiz platform
1.1	14
	15	== 2. Key concepts==
	16	This microlearning is about redelivering messages from the message redelivery overview in Manage.
	17
9.1	18	* The message redelivery overview shows the following:
	19	** The queue on which the error occurred.
	20	** The payload of the message as it arrived on this queue
	21	** The header information of the message as it arrived on this queue
	22	** Metadata about the message
	23	* Via the "Show error message" button you can see the accompanying error for a period of four weeks
	24	* With the help of the "Retry" button you can redeliver a specific message
	25	* With the help of the "Delete message" button you can remove a specific message
	26	* With the help of the "Retry all" button you can redeliver all messages
	27	* With the help of the "Delete all" button you can remove all messages waiting to be redelivered
	28	* With the help of the "Save as test message" button you can save the test message and link it to the flow in which error occurred.
	29	* You can access this overview in two ways:
	30	** Via Manage -> Explore -> Redelivery
	31	** Via Manage -> Dashboard -> Select Flow -> Select Error -> "Redelivery" button
1.1	32
11.1	33	== 3. Manage Message Redelivery ==
1.1	34
12.1	35	The message redelivery overview can be found in the Manage phase of eMagiz. Within Manage you can navigate to Explore -> Redelivery to access the overview. In this overview you can search on the queue name or on the original ID (as can be found in the error message under the header called jms_messageId).
1.1	36
12.1	37	{{info}}Note that the overview is sorted ascending on date. This means that the oldest message is shown on top and the latest message is shown at the bottom of the list.{{/info}}
1.1	38
12.1	39	[[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage-gen3--message-redelivery-overview.png]]
1.1	40
16.2	41	On top of that you have the option to "Retry all", "Delete all" messages or "Refresh" the view. As the naming implies the "Retry all" button will retry all messages that are currently available in the message redelivery functionality. Note that for each message that generates a new error, a new entry will be created in the message redelivery functionality. The "Delete all" button removes all messages from the message redelivery functionality. With the "Refresh" button you can refresh the overview to see whether new messages arrived on the queue.
1.1	42
12.1	43	By selecting a specific message your view changes as detail information of your selected message will be shown. In this additional overview you see the message, its headers, some metadata, and various options to execute on message level.
1.1	44
12.1	45	[[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage-gen3--message-redelivery-overview-detailed-view.png]]
	46
	47	After you have selected the specific message you have several additional buttons available. On message level you have the "Retry" and "Delete message" button. They work in a similar fashion as the retry and delete buttons on the overview level only these buttons work on message level.
	48
	49	By pressing the "Show error message" button you can view the accompanying error message that caused the message to end up in the message redelivery functionality.
	50
	51	[[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage-gen3--message-redelivery-overview-show-error-message.png]]
	52
16.1	53	{{warning}}
	54	* Error messages are only kept for a period of four weeks (when the limit on a hourly basis is not exceeded within this time period). Should eMagiz not be able to retrieve the error message you will be notified on this.
	55	* Should you have exceeded your error messages limit the message will be available in message redelivery but the accompanying error won't be visible.{{/warning}}
13.1	56
12.1	57	On top of that we have functionality that allows you to save the test message and link it to the correct flow so you can use it as a test message in your flow testing functionality. For this the button "Save as test message" is used. On top of that you can also "Download" your message if there is a need for it.
	58
15.1	59	[[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage-gen3--error-message-details.png]]
1.1	60
	61	Note that there is not always an accompanying error message to be found. In those cases eMagiz will show you an empty error messages pop-up.
	62
13.1	63	=== 3.1 Alternative view ===
1.1	64
13.1	65	When you are in the Manage -> Dashboard you can show the error messages on flow level. After you select a flow for which there are error message and for which the message redelivery functionality is configured you can redeliver the message via this overview. This can be done by pressing the button "Redelivery".
1.1	66
15.1	67	[[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage-gen3--error-message-dashboard-redelivery.png]]
1.1	68
13.1	69	Once you press this button a pop-up appears showing you the detailed view of that particular message. From here you have the same options available as when you would have selected the error message via Manage -> Explore -> Redelivery.
1.1	70
15.1	71	[[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage-gen3--error-message-dashboard-redelivery-pop-up.png]]
1.1	72
13.1	73	== 4. Key takeaways==
1.1	74
9.1	75	* The message redelivery overview shows the following:
	76	** The queue on which the error occurred.
	77	** The payload of the message as it arrived on this queue
	78	** The header information of the message as it arrived on this queue
	79	** Metadata about the message
	80	* Via the "Show error message" button you can see the accompanying error for a period of four weeks
	81	* With the help of the "Retry" button you can redeliver a specific message
	82	* With the help of the "Delete message" button you can remove a specific message
	83	* With the help of the "Retry all" button you can redeliver all messages
	84	* With the help of the "Delete all" button you can remove all messages waiting to be redelivered
	85	* With the help of the "Save as test message" button you can save the test message and link it to the flow in which error occurred.
	86	* You can access this overview in two ways:
	87	** Via Manage -> Explore -> Redelivery
	88	** Via Manage -> Dashboard -> Select Flow -> Select Error -> "Redelivery" button
1.1	89
13.1	90	== 5. Suggested Additional Readings ==
1.1	91
16.3	92	If you are interested in this topic please read the help text eMagiz provides you and see the following link:
1.1	93
16.4	94	* [[Intermediate Level (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome\|\|target="blank"]]
	95	** [[Message Redelivery (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Message Redelivery.WebHome\|\|target="blank"]]
	96	*** [[Configure Message Redelivery (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Message Redelivery.intermediate-message-redelivery-configuration-gen3.WebHome\|\|target="blank"]]
16.3	97	* [[Message Redelivery (Search Results)>>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=%22message+redelivery%22\|\|target="blank"]]
13.1	98	)))
3.1	99	((({{toc/}}))){{/container}}
	100	{{/container}}
1.1	101

Wiki source code of Manage Message Redelivery

Navigation