Skip to Content

Changes for page XSLT Extension Gateway

Last modified by Erik Bakker on 2024/09/02 15:59
From version 17.1
edited by eMagiz
on 2022/05/05 10:04
Change comment: There is no comment for this version
To version 19.1
edited by Erik Bakker
on 2022/06/10 08:38
Change comment: Imported from XAR

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.marijn
1 +XWiki.ebakker
Content
... ... @@ -1,17 +1,10 @@
1 -{{html wiki="true"}}
2 -<div class="ez-academy">
3 - <div class="ez-academy_body">
4 -
5 -<div class="doc">
6 -
7 -
8 -
1 +{{container}}{{container layoutStyle="columns"}}(((
9 9  = XSLT Extension Gateway =
10 10  
11 11  In this microlearning, we will focus on the XSLT extension gateway.
12 12  The XSLT extension gateway is a component in eMagiz that helps you to enrich your output XML message by retrieving data from an outside source.
13 13  
14 -Should you have any questions, please contact academy@emagiz.com.
7 +Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
15 15  
16 16  * Last update: March 22th, 2021
17 17  * Required reading time: 6 minutes
... ... @@ -42,7 +42,7 @@
42 42  You can do so by dragging the correct component on the canvas, creating the channels and linking the channels to the XSLT Extension Gateway.
43 43  An example of how this will look is shown below:
44 44  
45 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-added-to-canvas.png||]]</p>
38 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-added-to-canvas.png]]
46 46  
47 47  === 3.2 Connect to the outside source ===
48 48  
... ... @@ -54,11 +54,11 @@
54 54  
55 55  To make this a reality in eMagiz we first need to add an HTTP Outbound Gateway to the canvas and fill in the details.
56 56  
57 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension.png||]]</p>
50 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension.png]]
58 58  
59 59  This automatically links the XSLT extension gateway to the HTTP oubound gateway, provided you selected the correct request and response channel.
60 60  
61 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension-result.png||]]</p>
54 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension-result.png]]
62 62  
63 63  === 3.3 Error handling ===
64 64  
... ... @@ -67,11 +67,11 @@
67 67  
68 68  You can easily do so by opening the XSLT Extension Gateway component, navigating to the Advanced tab, selecting the correct Error channel and setting the Reply timeout.
69 69  
70 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel.png||]]</p>
63 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel.png]]
71 71  
72 72  The result of this action will be that the XSLT extension will send his errors to the standard error handling process of eMagiz.
73 73  
74 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel-result.png||]]</p>
67 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel-result.png]]
75 75  
76 76  === 3.4 Write the XSLT ===
77 77  
... ... @@ -128,20 +128,20 @@
128 128  The first step we need to take is to link the resource to the flow. To do so you navigate to the tab Resources on flow level, while in "Start Editing" mode.
129 129  In this tab you have the option to Upload new resource
130 130  
131 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--upload-new-resource.png||]]</p>
124 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--upload-new-resource.png]]
132 132  
133 133  When you select this option you can upload your custom XSLT. Ensure that you select the correct resource type and give the resource a good descriptive name
134 134  
135 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--upload-new-resource-filled-in.png||]]</p>
128 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--upload-new-resource-filled-in.png]]
136 136  
137 137  Now that we have added the resource to the flow we can return to the flow overview and add a XSLT transformer component to the canvas and fill in the details
138 138  
139 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-transformer-basic.png||]]</p>
132 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-transformer-basic.png]]
140 140  
141 141  When you are finished with the basic config you can move to the Advanced section. In this section we need to define the values for our parameter(s).
142 142  The end result will look something like this:
143 143  
144 -<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-transformer-advanced.png||]]</p>
137 +[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-transformer-advanced.png]]
145 145  
146 146  As you can see the ExtGateway parameter refers to the ID of the XSLT extension gateway component within our flow.
147 147  Now that we have set our XSLT transformer component up correctly the we have automatically linked the XSLT Transformer to the XSLT extension gateway.
... ... @@ -148,8 +148,8 @@
148 148  
149 149  With these steps you can successfully use the XSLT extension gateway component in eMagiz. Based on your use case the details of the configuration can differ.
150 150  
151 -===== Practice =====
152 152  
145 +
153 153  == 4. Assignment ==
154 154  
155 155  Create within your flow an XSLT extension gateway setup as depicted above. The linking of the XSLT transformer to the XSLT extension gateway can be skipped in the exercise.
... ... @@ -173,11 +173,6 @@
173 173  
174 174  This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
175 175  
176 -<iframe width="1280" height="720" src="../../vid/microlearning/advanced-data-handling-xslt-extension-gateway.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
177 177  
178 -</div>
179 -</main>
180 -</div>
181 -</div>
182 -
183 -{{/html}}
170 +{{video attachment="advanced-data-handling-xslt-extension-gateway.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
171 +)))((({{toc/}}))){{/container}}{{/container}}