Skip to Content
Last modified by Erik Bakker on 2025/02/28 09:50
From version 24.1
edited by Erik Bakker
on 2022/08/30 15:45
Change comment: There is no comment for this version
To version 11.1
edited by eMagiz
on 2022/05/22 21:04
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,0 @@
1 -Calling an asynchronous web service in Mendix
Parent
... ... @@ -1,1 +1,0 @@
1 -WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.marijn
Default language
... ... @@ -1,1 +1,0 @@
1 -en
Content
... ... @@ -1,8 +1,20 @@
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 += Calling an asynchronous web service in Mendix =
10 +
2 2  With the help of the eMagiz Mendix module created by the eMagiz team, you can easily connect between Mendix and eMagiz for data integration. In this microlearning, we will focus on calling an asynchronous web service in Mendix.
3 3  
4 -Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
13 +Should you have any questions, please get in touch with academy@emagiz.com.
5 5  
15 +* Last update: October 29th, 2021
16 +* Required reading time: 6 minutes
17 +
6 6  == 1. Prerequisites ==
7 7  
8 8  * Intermediate knowledge of the eMagiz platform
... ... @@ -21,6 +21,8 @@
21 21  * Execute microflow (the microflow that will process the incoming data)
22 22  * Optionally, you can define an import mapping and subsequent option
23 23  
36 +
37 +
24 24  == 3. Calling an asynchronous web service in Mendix ==
25 25  
26 26  With the help of the eMagiz Mendix module created by the eMagiz team, you can easily connect between Mendix and eMagiz for data integration. In this microlearning, we will focus on calling an asynchronous web service in Mendix. For sending data to Mendix, we offer two options to send data:
... ... @@ -38,11 +38,11 @@
38 38  
39 39  You will see the following overview within the exit flow, which you can configure (if in "Start Editing" mode). Here, you need to define the import mapping (complete name in Mendix including module name) and the execute microflow (complete name in Mendix including module name).
40 40  
41 -[[image:Main.Images.Microlearning.WebHome@intermediate-mendix-connectivity-calling-an-asynchronous-webservice-in-exit-flow-config.png]]
55 +<p align="center">[[image:intermediate-mendix-connectivity-calling-an-asynchronous-webservice-in-exit-flow-config.png||]]</p>
42 42  
43 43  When selecting the import mapping, several additional options need to be chosen within the exit. What each specific option does is detailed in the accompanying help text. Below you will see an example of how you could configure this.
44 44  
45 -[[image:Main.Images.Microlearning.WebHome@intermediate-mendix-connectivity-calling-an-asynchronous-webservice-in-exit-flow-config-import-mapping-specific.png]]
59 +<p align="center">[[image:intermediate-mendix-connectivity-calling-an-asynchronous-webservice-in-exit-flow-config-import-mapping-specific.png||]]</p>
46 46  
47 47  Note that the Range is a critical piece of the configuration as it defines whether the root of the result of the import mapping is a list (All), a single object (First), or a limited list (Custom). Note that the parameter of your import microflow should match this to prevent errors. So, for example, when your parameter upon the import microflow is an Object, you should select the option First. If the parameter on your import microflow is a List, you should select the option All. In cases where you want to reduce the number of entries in the List, you can use the Custom option to reduce the amount to a predefined limit.
48 48  
... ... @@ -54,10 +54,12 @@
54 54  
55 55  You will see the following overview within the exit flow, which you can configure (if in "Start Editing" mode). Here you need to define the execute microflow (complete name in Mendix including module name).
56 56  
57 -[[image:Main.Images.Microlearning.WebHome@intermediate-mendix-connectivity-calling-an-asynchronous-webservice-in-exit-flow-config-string.png]]
71 +<p align="center">[[image:intermediate-mendix-connectivity-calling-an-asynchronous-webservice-in-exit-flow-config-string.png||]]</p>
58 58  
59 59  When satisfied with this setup, please create a new version of the flow and include it in your latest release. That will allow Mendix to retrieve the newest version upon the next restart of Mendix (or by manually downloading the release in Mendix).
60 60  
75 +===== Practice =====
76 +
61 61  == 4. Assignment ==
62 62  
63 63  The assignment is simple this time. Configure the exit flow to send data to Mendix correctly. Ideally, work on both options.
... ... @@ -71,8 +71,10 @@
71 71  * Optionally, you can define an import mapping and subsequent option
72 72  * Setting the Range option correctly is critical to prevent 'unexpected' errors
73 73  
74 -Note: To make a connection in allowing data to travel between A and B, you need to fill in the correct constants and set up your Keystore and Truststore correctly. For more information check out this [[course>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.WebHome||target="blank"]].
90 +Note: To make a connection in allowing data to travel between A and B, you need to fill in the correct constants and set up your Keystore and Truststore correctly. For more information check out this [course](novice-mendix-connectivity-index.md)
75 75  
92 +
93 +
76 76  == 6. Suggested Additional Readings ==
77 77  
78 78  If you are interested in this topic and want more information, please read the release notes provided by eMagiz that accompany the eMagiz Mendix Connector version you have selected.
... ... @@ -82,4 +82,9 @@
82 82  We have opted not to make a video on this for now.
83 83  The pictures and text provided above should give you enough guidance to configure the connection between Mendix and eMagiz.
84 84  
85 -)))((({{toc/}}))){{/container}}{{/container}}
103 +</div>
104 +
105 +</div>
106 +</div>
107 +
108 +{{/html}}