Changes for page Custom Error Handling

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-Custom Error Handling
	1	+Custom Error Handling - 3rd generation runtime

Content

...	...	@@ -1,10 +1,6 @@
1	1	{{container}}{{container layoutStyle="columns"}}(((
2		-{{warning}}
3		-Please note that this migration path is for the new monitoring stack only.
4		-{{/warning}}
	2	+Below you will find a document describing the migration path to migrate your custom error handling on flow level to the latest generation runtime. Note that this functionality is not yet generally available and can only be executed after consulting your partner manager. For the key aspects of the new generation compared to the current generation, please read this [[fundamental>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3.WebHome||target="blank"]].
5	5
6		-Below you will find a document describing the migration path to migrate your custom error handling on flow level to the latest generation runtime. For the key aspects of the new generation compared to the current generation, please read this [[fundamental>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]].
7		-
8	8	Should you have any questions, please get in touch with academy@emagiz.com.
9	9
10	10	== 1. Prerequisites ==
...	...	@@ -15,16 +15,16 @@
15	15	== 2. Key concepts ==
16	16
17	17	* This migration path allows you to maintain custom error handling on flow level
18		-* The error flow of your model needs to be resetted (when using no custom error handling) or adapted when using custom error handling
	14	+* Additionaly the error flow of your model needs to be changed to process the messages accordingly
19	19
20	20
21		-== 3. Technical Migration Path ==
	17	+== 4. Technical Migration Path ==
22	22
23	23	As part of the "Transfer Settings from Design" step in the general migration path on migrating to the 3rd generation runtime you need to select for which flows in your runtime you want the custom error handling to be maintained. Apart from that you also need to rebuild your error flow in such a way that it receives the errors and processes the messages as you desire.
24	24
25	25	[[image:Main.Images.Migrationpath.WebHome@migration-path-migration-path-emagiz-runtime-generation-3--transfer-settings-from-design-custom-error-handling.png]]
26	26
27		-Before diving into the error process flow and how to rebuild it to make it work for you let us first explain how the error handling will change when migrating. In the 3rd runtime generation any inbound component in any flow can put data on the errorChannel by selecting "errorChannel" as the channel of choice to handle exceptions. This is the default in any asynchronous flow that starts with an inbound component. If you want to make use of this same functionality when adding an inbound channel adapter to your flow you simply select the "errorChannel" option as channel on your exception channel and you are done.
	23	+Before diving into the error process flow and how to rebuild it to make it work for you let us first explain how the error handling will change when migrating. In the 3rd runtime generation any inbound component in any flow can put data on the errorChannel by selecting "errorChannel" as the channel of choice to handle exceptions. This is the default in any asynchronous flow that starts with an inbound component. If you want to make use of this same functionality when adding an inbound channel adpater to your flow you simply select the "errorChannel" option as channel on your exception channel and you are done.
28	28
29	29	As a result, the error will directly be sent to the eMagiz infrastructure to be analyzed and processed. This is a stark difference compared to the current solution that places the error on the error flow of your own model (if reachable) and from there places it on a seperate eMagiz model maintained by eMagiz and from there it is processed further throughout the portal.
30	30
...	...	@@ -38,13 +38,13 @@
38	38
39	39	[[image:Main.Images.Migrationpath.WebHome@migration-path-custom-error-handling--difference-to-models.png]]
40	40
41		-=== 3.1 Error flow configuration ===
	37	+=== 4.1 Error flow configuration ===
42	42
43		-Before resetting your error process flow you should identify which part of your error process flow were added by you to support your custom error handling. When you have identified these components select and copy them. Subsequently reset the error process so you end up with a blank slate in which you can then copy the custom components. Last thing to do is to make sure that the channels are connected properly and from that moment on the error process flow will only be used to handle custom errors.
	39	+Before resetting your error process flow you should identify which part of your error process flow were added to you to support your custom error handling. When you have identified these components select and copy them. Subsequently reset the error process so you end up with a blank slate in which you can then copy the custom components. Last thing to do is to make sure that the channels are connected properly and from that moment on the error process flow will only be used to handle custom errors.
44	44
45		-== 4. Key takeaways ==
	41	+== 5. Key takeaways ==
46	46
47		-* Part of the migration path consists of determining whether you want to keep "custom error handling".
48		-* When "custom error handling" is used you need to redesign your error process flow accordingly.
	43	+* Part of the migration path consists of determining whether you want to keep "custom error handling"
	44	+* When "custom error handling" is used you need to redesign your error process flow accordingly
49	49
50	50	)))((({{toc/}}))){{/container}}{{/container}}