Skip to Content

Changes for page XSLT Extension Gateway

Last modified by Erik Bakker on 2024/09/02 15:59
From version 30.1
edited by Erik Bakker
on 2022/10/03 11:18
Change comment: There is no comment for this version
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,9 +1,21 @@
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  
16 +* Last update: March 22th, 2021
17 +* Required reading time: 6 minutes
18 +
7 7  == 1. Prerequisites ==
8 8  
9 9  * Advanced knowledge of the eMagiz platform
... ... @@ -16,6 +16,8 @@
16 16  
17 17  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.
18 18  
31 +
32 +
19 19  == 3. XSLT Extension Gateway ==
20 20  
21 21  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.
... ... @@ -28,7 +28,7 @@
28 28  You can do so by dragging the correct component on the canvas, creating the channels and linking the channels to the XSLT Extension Gateway.
29 29  An example of how this will look is shown below:
30 30  
31 -[[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>
32 32  
33 33  === 3.2 Connect to the outside source ===
34 34  
... ... @@ -40,11 +40,11 @@
40 40  
41 41  To make this a reality in eMagiz we first need to add an HTTP Outbound Gateway to the canvas and fill in the details.
42 42  
43 -[[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>
44 44  
45 45  This automatically links the XSLT extension gateway to the HTTP oubound gateway, provided you selected the correct request and response channel.
46 46  
47 -[[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>
48 48  
49 49  === 3.3 Error handling ===
50 50  
... ... @@ -53,11 +53,11 @@
53 53  
54 54  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.
55 55  
56 -[[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>
57 57  
58 58  The result of this action will be that the XSLT extension will send his errors to the standard error handling process of eMagiz.
59 59  
60 -[[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>
61 61  
62 62  === 3.4 Write the XSLT ===
63 63  
... ... @@ -71,7 +71,6 @@
71 71  
72 72  An example of such an XSLT is depicted below. Within the XSLT we have described which part is responsible for what exactly.
73 73  
74 -{{code}}
75 75  <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
76 76  xmlns:ezx="http://www.emagiz.com/ns/xml/1.0/"
77 77  version="2.0">
... ... @@ -107,7 +107,6 @@
107 107  </xsl:if>
108 108  </xsl:variable>
109 109  </xsl:stylesheet>
110 -{{/code}}
111 111  
112 112  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.
113 113  
... ... @@ -116,20 +116,20 @@
116 116  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.
117 117  In this tab you have the option to Upload new resource
118 118  
119 -[[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>
120 120  
121 121  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
122 122  
123 -[[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>
124 124  
125 125  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
126 126  
127 -[[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>
128 128  
129 129  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).
130 130  The end result will look something like this:
131 131  
132 -[[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>
133 133  
134 134  As you can see the ExtGateway parameter refers to the ID of the XSLT extension gateway component within our flow.
135 135  Now that we have set our XSLT transformer component up correctly the we have automatically linked the XSLT Transformer to the XSLT extension gateway.
... ... @@ -136,6 +136,8 @@
136 136  
137 137  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.
138 138  
151 +===== Practice =====
152 +
139 139  == 4. Assignment ==
140 140  
141 141  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.
... ... @@ -159,6 +159,11 @@
159 159  
160 160  This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
161 161  
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>
162 162  
163 -{{video attachment="advanced-data-handling-xslt-extension-gateway.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
164 -)))((({{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
advanced-data-handling-xslt-extension-gateway--xslt-transformer-basic.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marijn
Size
... ... @@ -1,0 +1,1 @@
1 +49.0 KB
Content