Skip to Content

Changes for page XSLT Extension Gateway

Last modified by Erik Bakker on 2024/09/02 15:59
From version 20.1
edited by Erik Bakker
on 2022/06/13 06:50
Change comment: Renamed from xwiki:Migrated Pages.XSLT Extension Gateway
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
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.marijn
Content
... ... @@ -1,10 +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 +
2 2  = XSLT Extension Gateway =
3 3  
4 4  In this microlearning, we will focus on the XSLT extension gateway.
5 5  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.
6 6  
7 -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.
8 8  
9 9  * Last update: March 22th, 2021
10 10  * Required reading time: 6 minutes
... ... @@ -35,7 +35,7 @@
35 35  You can do so by dragging the correct component on the canvas, creating the channels and linking the channels to the XSLT Extension Gateway.
36 36  An example of how this will look is shown below:
37 37  
38 -[[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>
39 39  
40 40  === 3.2 Connect to the outside source ===
41 41  
... ... @@ -47,11 +47,11 @@
47 47  
48 48  To make this a reality in eMagiz we first need to add an HTTP Outbound Gateway to the canvas and fill in the details.
49 49  
50 -[[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>
51 51  
52 52  This automatically links the XSLT extension gateway to the HTTP oubound gateway, provided you selected the correct request and response channel.
53 53  
54 -[[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>
55 55  
56 56  === 3.3 Error handling ===
57 57  
... ... @@ -60,11 +60,11 @@
60 60  
61 61  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.
62 62  
63 -[[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>
64 64  
65 65  The result of this action will be that the XSLT extension will send his errors to the standard error handling process of eMagiz.
66 66  
67 -[[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>
68 68  
69 69  === 3.4 Write the XSLT ===
70 70  
... ... @@ -121,20 +121,20 @@
121 121  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.
122 122  In this tab you have the option to Upload new resource
123 123  
124 -[[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>
125 125  
126 126  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
127 127  
128 -[[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>
129 129  
130 130  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
131 131  
132 -[[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>
133 133  
134 134  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).
135 135  The end result will look something like this:
136 136  
137 -[[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>
138 138  
139 139  As you can see the ExtGateway parameter refers to the ID of the XSLT extension gateway component within our flow.
140 140  Now that we have set our XSLT transformer component up correctly the we have automatically linked the XSLT Transformer to the XSLT extension gateway.
... ... @@ -141,8 +141,8 @@
141 141  
142 142  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.
143 143  
151 +===== Practice =====
144 144  
145 -
146 146  == 4. Assignment ==
147 147  
148 148  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.
... ... @@ -166,6 +166,11 @@
166 166  
167 167  This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
168 168  
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>
169 169  
170 -{{video attachment="advanced-data-handling-xslt-extension-gateway.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
171 -)))((({{toc/}}))){{/container}}{{/container}}
178 +</div>
179 +</main>
180 +</div>
181 +</div>
182 +
183 +{{/html}}