Skip to Content
Last modified by Erik Bakker on 2025/02/25 16:09
From version 14.1
edited by Carlijn Kokkeler
on 2024/08/23 14:25
Change comment: There is no comment for this version
To version 8.1
edited by Erik Bakker
on 2022/06/12 10:04
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.CarlijnKokkeler
1 +XWiki.ebakker
Content
... ... @@ -1,14 +1,18 @@
1 1  {{container}}{{container layoutStyle="columns"}}(((
2 -In this microlearning, we'll cover how to configure the eMagiz Mendix Connector for your Mendix application. The eMagiz Mendix Connector is a module that facilitates seamless integration between Mendix and eMagiz projects. We’ll walk you through the essential configuration steps, including setting up startup and shutdown processes, configuring access rights, defining key constants, and properly setting up the Keystore and Truststore. By the end, you'll be ready to ensure a stable and secure connection between your Mendix application and eMagiz.
2 +In this microlearning, we will focus on configuring an eMagiz Mendix Connector.
3 +With the help of this Mendix module created by the eMagiz team, you can easily connect between Mendix and eMagiz for data integration.
3 3  
4 4  Should you have any questions, please contact academy@emagiz.com.
5 5  
7 +* Last update: January 27th, 2021
8 +* Required reading time: 10 minutes
9 +
6 6  == 1. Prerequisites ==
7 7  * Basic knowledge of the eMagiz platform
8 8  * Access to a Mendix application
9 9  * Access to the Deploy phase of your eMagiz project
10 10  * A connection between Mendix and eMagiz Designed and Created
11 -* Using eMagiz Mendix version 4.2.0 or higher.
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 12  
13 13  == 2. Key concepts ==
14 14  This microlearning centers around configuring an eMagiz Mendix Connector
... ... @@ -21,6 +21,8 @@
21 21  * Configure the constants
22 22  * Configure the Keystore/Truststore
23 23  
28 +
29 +
24 24  == 3. Configure a eMagiz Mendix Connector
25 25  
26 26  To configure the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed.
... ... @@ -128,28 +128,29 @@
128 128  
129 129  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.
130 130  
131 -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".
137 +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 132  
133 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--find-resources.png]]
139 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--open-connector-infra.png]]
134 134  
135 -In this overview, you will find the key and Truststore. Download these and place them in the resources folder of your Mendix project.
141 +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 136  
137 -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**
143 +You can access this resources folder in the following manner: **Project -> Show Project Directory in Explorer -> Open the resources folder**
138 138  
139 139  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-project-directory.png]]
140 140  
141 -For Mendix projects running version 9.18.0 or higher please go to: **App -> Show App Directory In Explorer**.
147 +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 142  
143 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-app-directory.png]]
149 +This configuration only needs to happen **once**.
144 144  
145 -Simply make sure that the Keystore and Truststore that you have downloaded from eMagiz are placed in this folder.
146 146  
147 -{{warning}}Don't forget to include the unique number prefix eMagiz has given the key- and truststore. Otherwise the connection cannot be established.{{/warning}}
148 148  
149 -This configuration only needs to happen **once**.
153 +== 4. Assignment ==
150 150  
151 -== 4. Key takeaways ==
155 +The assignment is simple this time. Configure your eMagiz Mendix Connector.
156 +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 152  
158 +== 5. Key takeaways ==
159 +
153 153  To configure an eMagiz Mendix Connector you need the following:
154 154  
155 155  * Configure the After Startup and Before Shutdown
... ... @@ -159,14 +159,15 @@
159 159  
160 160  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.
161 161  
162 -== 5. Suggested Additional Readings ==
163 163  
164 -* [[Novice (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Novice.WebHome||target="blank"]]
165 -** [[Mendix Connectivity (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.WebHome||target="blank"]]
166 -*** [[What is an eMagiz Mendix Connector (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.novice-mendix-connectivity-what-is-an-emagiz-mendix-connector.WebHome||target="blank"]]
167 -*** [[Install an eMagiz Mendix Connector (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.novice-mendix-connectivity-install-emagiz-mendix-connector.WebHome||target="blank"]]
168 -*** [[Update an eMagiz Mendix Connector (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.novice-mendix-connectivity-update-emagiz-mendix-connector.WebHome||target="blank"]]
169 169  
170 -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"]].
171 +== 6. Suggested Additional Readings ==
171 171  
173 +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.
174 +
175 +== 7. Silent demonstration video ==
176 +
177 +As most of this configuration takes place in Mendix and not in eMagiz we have chosen not to make a video on this topic.
178 +The pictures and text provided above should give you enough guidance to configure the connection between Mendix and eMagiz.
179 +
172 172  )))((({{toc/}}))){{/container}}{{/container}}