Last modified by Erik Bakker on 2025/02/25 16:09

From version 6.1
edited by Erik Bakker
on 2022/06/12 10:03
Change comment: There is no comment for this version
To version 12.1
edited by Erik Bakker
on 2023/07/18 08:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -novice-mendix-connectivity-configure-emagiz-mendix-connector
1 +Configure an eMagiz Mendix Connector
Content
... ... @@ -1,23 +1,15 @@
1 -{{container}}{{container layoutStyle="columns"}}(((
2 -
3 -
4 -
5 -# Configure an eMagiz Mendix Connector
6 -
1 +{{container}}{{container layoutStyle="columns"}}(((
7 7  In this microlearning, we will focus on configuring an eMagiz Mendix Connector.
8 8  With the help of this Mendix module created by the eMagiz team, you can easily connect between Mendix and eMagiz for data integration.
9 9  
10 10  Should you have any questions, please contact academy@emagiz.com.
11 11  
12 -* Last update: January 27th, 2021
13 -* Required reading time: 10 minutes
14 -
15 15  == 1. Prerequisites ==
16 16  * Basic knowledge of the eMagiz platform
17 17  * Access to a Mendix application
18 18  * Access to the Deploy phase of your eMagiz project
19 19  * A connection between Mendix and eMagiz Designed and Created
20 -* Using eMagiz Mendix version 4.2.0 or higher. For legacy configuration please see the user guide **Install guide eMagiz Connector for Mendix**
12 +* Using eMagiz Mendix version 4.2.0 or higher.
21 21  
22 22  == 2. Key concepts ==
23 23  This microlearning centers around configuring an eMagiz Mendix Connector
... ... @@ -30,13 +30,12 @@
30 30  * Configure the constants
31 31  * Configure the Keystore/Truststore
32 32  
33 -
34 -
35 35  == 3. Configure a eMagiz Mendix Connector
36 36  
37 37  To configure the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed.
38 38  
39 39  === 3.1 Configure the After Startup and Before Shutdown
30 +
40 40  The first step of configuring your eMagiz Mendix Connector is to connect the After Startup and the Before Shutdown microflow that eMagiz provides you as part of the Use Me folder to the existing
41 41  After Startup and Before Shutdown microflow of the project itself.
42 42  
... ... @@ -48,8 +48,9 @@
48 48  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--after-startup-before-shutdown-project.png]]
49 49  
50 50  This configuration only needs to happen **once**.
51 -
42 +
52 52  === 3.2 Configure the Access rights to the eMagiz Mendix Module
44 +
53 53  It is recommended that only the administrator user role has access to the eMagiz Mendix Connector module.
54 54  To do this follow these steps:
55 55  
... ... @@ -68,6 +68,7 @@
68 68  This configuration only needs to happen **once**.
69 69  
70 70  === 3.3 Configure the constants
63 +
71 71  The eMagiz Mendix Connector comes with six constants that need to be configured correctly to make sure that a successful and stable connection can be established between the Mendix application and eMagiz.
72 72  
73 73  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-constants.png]]
... ... @@ -136,29 +136,28 @@
136 136  
137 137  To ensure a proper SSL connection between runtime and eMagiz JMS each runtime needs to have a Keystore and Truststore that hold the relevant certificates.
138 138  
139 -For a Mendix application specifically, this has to be done by hand. You can find the correct Keystore and Truststore if you open the infra flow of the Mendix runtime in **Create**
132 +For a Mendix application specifically, this has to be done by hand. You can find the correct Keystore and Truststore if you navigate to **Create -> Resources**. In here you can search for "{technicalnamemodel}-client" in the field "Name".
140 140  
141 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--open-connector-infra.png]]
134 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--find-resources.png]]
142 142  
143 -Under the Resources tab, you will find the key and Truststore. Download these and place them in the resources folder of your Mendix project.
136 +In this overview, you will find the key and Truststore. Download these and place them in the resources folder of your Mendix project.
144 144  
145 -You can access this resources folder in the following manner: **Project -> Show Project Directory in Explorer -> Open the resources folder**
138 +You can access this resources folder in the following manner for Mendix Projects running below version 9.18.0: **Project -> Show Project Directory in Explorer -> Open the resources folder**
146 146  
147 147  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-project-directory.png]]
148 148  
149 -Simply make sure that the Keystore and Truststore that you have downloaded from eMagiz are placed in this folder **including the unique number prefix eMagiz has given the key* and Truststore**
142 +For Mendix projects running version 9.18.0 or higher please go to: **App -> Show App Directory In Explorer**.
150 150  
151 -This configuration only needs to happen **once**.
144 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-app-directory.png]]
152 152  
146 +Simply make sure that the Keystore and Truststore that you have downloaded from eMagiz are placed in this folder.
153 153  
148 +{{warning}}Don't forget to include the unique number prefix eMagiz has given the key- and truststore. Otherwise the connection cannot be established.{{/warning}}
154 154  
155 -== 4. Assignment ==
150 +This configuration only needs to happen **once**.
156 156  
157 -The assignment is simple this time. Configure your eMagiz Mendix Connector.
158 -This assignment can be completed with the help of an associated Mendix project linked to the (Academy) project that you have created/used in the previous assignment.
152 +== 4. Key takeaways ==
159 159  
160 -== 5. Key takeaways ==
161 -
162 162  To configure an eMagiz Mendix Connector you need the following:
163 163  
164 164  * Configure the After Startup and Before Shutdown
... ... @@ -168,15 +168,10 @@
168 168  
169 169  To make a connection in terms of allowing data to travel between A and B you need to fill in the correct constants and setup your Keystore and Truststore correctly.
170 170  
163 +== 5. Suggested Additional Readings ==
171 171  
172 -
173 -== 6. Suggested Additional Readings ==
174 -
175 175  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.
176 176  
177 -== 7. Silent demonstration video ==
167 +If you are interested in migrating towards the latest version of the eMagiz Mendix Connector please check out our [[migration paths>>doc:Main.eMagiz Support.Migration Paths.WebHome||target="blank"]].
178 178  
179 -As most of this configuration takes place in Mendix and not in eMagiz we have chosen not to make a video on this topic.
180 -The pictures and text provided above should give you enough guidance to configure the connection between Mendix and eMagiz.
181 -
182 -)))((({{toc/}}))){{container}}{{/container}}
169 +)))((({{toc/}}))){{/container}}{{/container}}