Skip to Content

Changes for page XSLT Extension Gateway

Last modified by Erik Bakker on 2024/09/02 15:59
From version 28.1
edited by Erik Bakker
on 2022/06/13 06:51
Change comment: Deleted image "advanced-data-handling-xslt-extension-gateway--xslt-transformer-advanced.png"
To version 18.1
edited by eMagiz
on 2022/05/05 10:04
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,0 @@
1 -XSLT Extension Gateway
Parent
... ... @@ -1,1 +1,0 @@
1 -WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.marijn
Content
... ... @@ -1,8 +1,17 @@
1 -{{container}}{{container layoutStyle="columns"}}(((
1 +{{html wiki="true"}}
2 +<div class="ez-academy">
3 + <div class="ez-academy_body">
4 +
5 +<div class="doc">
6 +
7 +
8 +
9 += XSLT Extension Gateway =
10 +
2 2  In this microlearning, we will focus on the XSLT extension gateway.
3 3  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.
4 4  
5 -Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
14 +Should you have any questions, please contact academy@emagiz.com.
6 6  
7 7  * Last update: March 22th, 2021
8 8  * Required reading time: 6 minutes
... ... @@ -33,7 +33,7 @@
33 33  You can do so by dragging the correct component on the canvas, creating the channels and linking the channels to the XSLT Extension Gateway.
34 34  An example of how this will look is shown below:
35 35  
36 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-added-to-canvas.png]]
45 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-added-to-canvas.png||]]</p>
37 37  
38 38  === 3.2 Connect to the outside source ===
39 39  
... ... @@ -45,11 +45,11 @@
45 45  
46 46  To make this a reality in eMagiz we first need to add an HTTP Outbound Gateway to the canvas and fill in the details.
47 47  
48 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension.png]]
57 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension.png||]]</p>
49 49  
50 50  This automatically links the XSLT extension gateway to the HTTP oubound gateway, provided you selected the correct request and response channel.
51 51  
52 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension-result.png]]
61 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension-result.png||]]</p>
53 53  
54 54  === 3.3 Error handling ===
55 55  
... ... @@ -58,11 +58,11 @@
58 58  
59 59  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.
60 60  
61 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel.png]]
70 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel.png||]]</p>
62 62  
63 63  The result of this action will be that the XSLT extension will send his errors to the standard error handling process of eMagiz.
64 64  
65 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel-result.png]]
74 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel-result.png||]]</p>
66 66  
67 67  === 3.4 Write the XSLT ===
68 68  
... ... @@ -119,20 +119,20 @@
119 119  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.
120 120  In this tab you have the option to Upload new resource
121 121  
122 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--upload-new-resource.png]]
131 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--upload-new-resource.png||]]</p>
123 123  
124 124  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
125 125  
126 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--upload-new-resource-filled-in.png]]
135 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--upload-new-resource-filled-in.png||]]</p>
127 127  
128 128  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
129 129  
130 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-transformer-basic.png]]
139 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-transformer-basic.png||]]</p>
131 131  
132 132  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).
133 133  The end result will look something like this:
134 134  
135 -[[image:Main.Images.Microlearning.WebHome@advanced-data-handling-xslt-extension-gateway--xslt-transformer-advanced.png]]
144 +<p align="center">[[image:advanced-data-handling-xslt-extension-gateway--xslt-transformer-advanced.png||]]</p>
136 136  
137 137  As you can see the ExtGateway parameter refers to the ID of the XSLT extension gateway component within our flow.
138 138  Now that we have set our XSLT transformer component up correctly the we have automatically linked the XSLT Transformer to the XSLT extension gateway.
... ... @@ -139,8 +139,8 @@
139 139  
140 140  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.
141 141  
151 +===== Practice =====
142 142  
143 -
144 144  == 4. Assignment ==
145 145  
146 146  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.
... ... @@ -164,6 +164,11 @@
164 164  
165 165  This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
166 166  
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>
167 167  
168 -{{video attachment="advanced-data-handling-xslt-extension-gateway.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
169 -)))((({{toc/}}))){{/container}}{{/container}}
178 +</div>
179 +</main>
180 +</div>
181 +</div>
182 +
183 +{{/html}}
advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension-result.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marijn
Size
... ... @@ -1,0 +1,1 @@
1 +6.6 KB
Content
advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marijn
Size
... ... @@ -1,0 +1,1 @@
1 +46.0 KB
Content
advanced-data-handling-xslt-extension-gateway--upload-new-resource-filled-in.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marijn
Size
... ... @@ -1,0 +1,1 @@
1 +25.7 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-added-to-canvas.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marijn
Size
... ... @@ -1,0 +1,1 @@
1 +2.6 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel-result.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marijn
Size
... ... @@ -1,0 +1,1 @@
1 +7.9 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marijn
Size
... ... @@ -1,0 +1,1 @@
1 +39.0 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-transformer-advanced.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marijn
Size
... ... @@ -1,0 +1,1 @@
1 +59.0 KB
Content