Skip to Content

Changes for page XSLT Extension Gateway

Last modified by Erik Bakker on 2024/09/02 15:59
From version 18.1
edited by eMagiz
on 2022/05/05 10:04
Change comment: There is no comment for this version
To version 37.1
edited by Carlijn Kokkeler
on 2024/08/29 10:34
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +XSLT Extension Gateway
Parent
... ... @@ -1,0 +1,1 @@
1 +WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.marijn
1 +XWiki.CarlijnKokkeler
Default language
... ... @@ -1,0 +1,1 @@
1 +en
Content
... ... @@ -1,21 +1,8 @@
1 -{{html wiki="true"}}
2 -<div class="ez-academy">
3 - <div class="ez-academy_body">
1 +{{container}}{{container layoutStyle="columns"}}(((
2 +To effectively work with eMagiz and enhance your data transformation processes, it's crucial to understand the XSLT Extension Gateway. This microlearning will guide you through the key concepts and practical steps needed to utilize this powerful component. The XSLT Extension Gateway allows you to retrieve additional data from various external sources in real-time during the transformation process, enabling more dynamic and enriched output messages. This overview will provide a clear understanding of how to set up, connect, and effectively manage an XSLT Extension Gateway in your eMagiz flows.
4 4  
5 -<div class="doc">
4 +Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
6 6  
7 -
8 -
9 -= XSLT Extension Gateway =
10 -
11 -In this microlearning, we will focus on the XSLT extension gateway.
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 -
14 -Should you have any questions, please contact academy@emagiz.com.
15 -
16 -* Last update: March 22th, 2021
17 -* Required reading time: 6 minutes
18 -
19 19  == 1. Prerequisites ==
20 20  
21 21  * Advanced knowledge of the eMagiz platform
... ... @@ -28,8 +28,6 @@
28 28  
29 29  Via the XSLT extension gateway you can retrieve data from multiple sources (REST Webservice, SOAP Webservice, Database, etc.) as long as the outside source can supply a response in near real-time.
30 30  
31 -
32 -
33 33  == 3. XSLT Extension Gateway ==
34 34  
35 35  An XSLT Extension Gateway is a component within eMagiz that gives you the option to retrieve additional data while executing the transformation from an outside source.
... ... @@ -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>
30 +[[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>
42 +[[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>
46 +[[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>
55 +[[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>
59 +[[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  
... ... @@ -85,6 +85,7 @@
85 85  
86 86  An example of such an XSLT is depicted below. Within the XSLT we have described which part is responsible for what exactly.
87 87  
73 +{{code}}
88 88  <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
89 89  xmlns:ezx="http://www.emagiz.com/ns/xml/1.0/"
90 90  version="2.0">
... ... @@ -120,6 +120,7 @@
120 120  </xsl:if>
121 121  </xsl:variable>
122 122  </xsl:stylesheet>
109 +{{/code}}
123 123  
124 124  Now that we have an example of a custom XSLT that we can use we now need to make sure that this XSLT will work within the context of our flow.
125 125  
... ... @@ -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>
118 +[[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>
122 +[[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>
126 +[[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>
131 +[[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,15 +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 =====
138 +== 4. Key takeaways ==
152 152  
153 -== 4. Assignment ==
154 -
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.
156 -This assignment can be completed with the help of the (Academy) project that you have created/used in the previous assignment.
157 -
158 -== 5. Key takeaways ==
159 -
160 160  * An XSLT Extension Gateway is a component within eMagiz that gives you the option to retrieve additional data while executing the transformation from an outside source.
161 161  * Via the XSLT extension gateway you can retrieve data from multiple sources (REST Webservice, SOAP Webservice, Database, etc.) as long as the outside source can supply a response in near real-time.
162 162  * This response is in turn used to enrich your output message with the correct information.
... ... @@ -163,21 +163,14 @@
163 163  * Setting up an XSLT extension gateway means several components need to work in perfect unison
164 164  * Don't forget about the error handling
165 165  
146 +== 5. Suggested Additional Readings ==
166 166  
148 +* [[Novice (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Novice.WebHome||target="blank"]]
149 +** [[Create your transformations (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Create your transformations.WebHome||target="blank"]]
150 +*** [[XSLT Snippet (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Create your transformations.novice-create-your-transformations-xslt-snippet||target="blank"]]
151 +*** [[XSLT Parameters (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Create your transformations.novice-create-your-transformations-xslt-parameters||target="blank"]]
152 +* [[Intermediate (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome||target="blank"]]
153 +** [[Create your transformations (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Create your transformations.WebHome||target="blank"]]
154 +*** [[Default eMagiz XSLT Functions (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Create your transformations.intermediate-create-your-transformations-emagiz-xslt-functions||target="blank"]]
167 167  
168 -== 6. Suggested Additional Readings ==
169 -
170 -If you are interested in this topic and want more information on it please read the release notes provided by eMagiz that accompany the eMagiz Mendix Connector version you have selected.
171 -
172 -== 7. Silent demonstration video ==
173 -
174 -This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
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 -
178 -</div>
179 -</main>
180 -</div>
181 -</div>
182 -
183 -{{/html}}
156 +)))((({{toc/}}))){{/container}}{{/container}}
advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension-result.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.marijn
Size
... ... @@ -1,1 +1,0 @@
1 -6.6 KB
Content
advanced-data-handling-xslt-extension-gateway--http-outbound-gateway-xslt-extension.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.marijn
Size
... ... @@ -1,1 +1,0 @@
1 -46.0 KB
Content
advanced-data-handling-xslt-extension-gateway--upload-new-resource-filled-in.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.marijn
Size
... ... @@ -1,1 +1,0 @@
1 -25.7 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-added-to-canvas.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.marijn
Size
... ... @@ -1,1 +1,0 @@
1 -2.6 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel-result.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.marijn
Size
... ... @@ -1,1 +1,0 @@
1 -7.9 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-extension-gateway-error-channel.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.marijn
Size
... ... @@ -1,1 +1,0 @@
1 -39.0 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-transformer-advanced.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.marijn
Size
... ... @@ -1,1 +1,0 @@
1 -59.0 KB
Content
advanced-data-handling-xslt-extension-gateway--xslt-transformer-basic.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.marijn
Size
... ... @@ -1,1 +1,0 @@
1 -49.0 KB
Content