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

From version 7.1
edited by Erik Bakker
on 2022/06/12 10:04
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
Content
... ... @@ -4,15 +4,12 @@
4 4  
5 5  Should you have any questions, please contact academy@emagiz.com.
6 6  
7 -* Last update: January 27th, 2021
8 -* Required reading time: 10 minutes
9 -
10 10  == 1. Prerequisites ==
11 11  * Basic knowledge of the eMagiz platform
12 12  * Access to a Mendix application
13 13  * Access to the Deploy phase of your eMagiz project
14 14  * A connection between Mendix and eMagiz Designed and Created
15 -* 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.
16 16  
17 17  == 2. Key concepts ==
18 18  This microlearning centers around configuring an eMagiz Mendix Connector
... ... @@ -25,13 +25,12 @@
25 25  * Configure the constants
26 26  * Configure the Keystore/Truststore
27 27  
28 -
29 -
30 30  == 3. Configure a eMagiz Mendix Connector
31 31  
32 32  To configure the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed.
33 33  
34 34  === 3.1 Configure the After Startup and Before Shutdown
30 +
35 35  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
36 36  After Startup and Before Shutdown microflow of the project itself.
37 37  
... ... @@ -43,8 +43,9 @@
43 43  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--after-startup-before-shutdown-project.png]]
44 44  
45 45  This configuration only needs to happen **once**.
46 -
42 +
47 47  === 3.2 Configure the Access rights to the eMagiz Mendix Module
44 +
48 48  It is recommended that only the administrator user role has access to the eMagiz Mendix Connector module.
49 49  To do this follow these steps:
50 50  
... ... @@ -63,6 +63,7 @@
63 63  This configuration only needs to happen **once**.
64 64  
65 65  === 3.3 Configure the constants
63 +
66 66  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.
67 67  
68 68  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-constants.png]]
... ... @@ -131,29 +131,28 @@
131 131  
132 132  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.
133 133  
134 -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".
135 135  
136 -[[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]]
137 137  
138 -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.
139 139  
140 -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**
141 141  
142 142  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-project-directory.png]]
143 143  
144 -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**.
145 145  
146 -This configuration only needs to happen **once**.
144 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-app-directory.png]]
147 147  
146 +Simply make sure that the Keystore and Truststore that you have downloaded from eMagiz are placed in this folder.
148 148  
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}}
149 149  
150 -== 4. Assignment ==
150 +This configuration only needs to happen **once**.
151 151  
152 -The assignment is simple this time. Configure your eMagiz Mendix Connector.
153 -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 ==
154 154  
155 -== 5. Key takeaways ==
156 -
157 157  To configure an eMagiz Mendix Connector you need the following:
158 158  
159 159  * Configure the After Startup and Before Shutdown
... ... @@ -163,15 +163,10 @@
163 163  
164 164  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.
165 165  
163 +== 5. Suggested Additional Readings ==
166 166  
167 -
168 -== 6. Suggested Additional Readings ==
169 -
170 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 171  
172 -== 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"]].
173 173  
174 -As most of this configuration takes place in Mendix and not in eMagiz we have chosen not to make a video on this topic.
175 -The pictures and text provided above should give you enough guidance to configure the connection between Mendix and eMagiz.
176 -
177 177  )))((({{toc/}}))){{/container}}{{/container}}