Skip to Content
Last modified by Erik Bakker on 2025/02/25 16:09
Hide last authors
Erik Bakker 19.1 1 {{container}}
2 {{container layoutStyle="columns"}}
3 (((
Carlijn Kokkeler 14.1 4 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.
Erik Bakker 1.1 5
6 Should you have any questions, please contact academy@emagiz.com.
7
8 == 1. Prerequisites ==
Erik Bakker 19.1 9
Erik Bakker 1.1 10 * Basic knowledge of the eMagiz platform
11 * Access to a Mendix application
12 * Access to the Deploy phase of your eMagiz project
Erik Bakker 6.1 13 * A connection between Mendix and eMagiz Designed and Created
Erik Bakker 9.1 14 * Using eMagiz Mendix version 4.2.0 or higher.
Erik Bakker 1.1 15
16 == 2. Key concepts ==
Erik Bakker 19.1 17
Erik Bakker 6.1 18 This microlearning centers around configuring an eMagiz Mendix Connector
Erik Bakker 1.1 19 With eMagiz Mendix Connector we mean: A Mendix module developed and maintained by eMagiz that simplifies connect a Mendix application to an eMagiz project for data traffic between both systems.
20
Erik Bakker 6.1 21 To configure an eMagiz Mendix Connector you need the following:
Erik Bakker 1.1 22
Erik Bakker 6.1 23 * Configure the After Startup and Before Shutdown
24 * Configure the Access rights to the eMagiz Mendix Module
25 * Configure the constants
26 * Configure the Keystore/Truststore
Erik Bakker 1.1 27
Erik Bakker 19.1 28 == 3. Configure a eMagiz Mendix Connector ==
Erik Bakker 1.1 29
Erik Bakker 6.1 30 To configure the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed.
Erik Bakker 1.1 31
Erik Bakker 19.1 32 === 3.1 Configure the After Startup and Before Shutdown ===
Erik Bakker 8.1 33
Erik Bakker 6.1 34 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
35 After Startup and Before Shutdown microflow of the project itself.
Erik Bakker 1.1 36
Erik Bakker 6.1 37 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--after-startup-before-shutdown-emagiz.png]]
Erik Bakker 5.1 38
Erik Bakker 6.1 39 After you have linked them to the project after startup and the project before shutdown ensure that these microflows are indeed triggered on the Project level.
40 You can verify this by navigating to **Project Settings -> Runtime**
Erik Bakker 5.1 41
Erik Bakker 6.1 42 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--after-startup-before-shutdown-project.png]]
Erik Bakker 3.1 43
Erik Bakker 6.1 44 This configuration only needs to happen **once**.
Erik Bakker 8.1 45
Erik Bakker 19.1 46 === 3.2 Configure the Access rights to the eMagiz Mendix Module ===
Erik Bakker 8.1 47
Erik Bakker 6.1 48 It is recommended that only the administrator user role has access to the eMagiz Mendix Connector module.
49 To do this follow these steps:
Erik Bakker 1.1 50
Erik Bakker 6.1 51 * Navigate to **Project Security**
52 * Validate that the security of your project is set to Production. If not please select the Production option
53 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--security-settings.png]]
54 * Navigate to **User Roles**
55 * Edit the Administrator role
56 * Edit the Module roles
57 * Check the box of the eMagiz Mendix Connector module and press OK
Erik Bakker 1.1 58
Erik Bakker 6.1 59 The configuration before you press OK should look as follows
Erik Bakker 1.1 60
Erik Bakker 6.1 61 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--security-admin-result.png]]
Erik Bakker 1.1 62
Erik Bakker 6.1 63 This configuration only needs to happen **once**.
Erik Bakker 2.1 64
Erik Bakker 19.1 65 === 3.3 Configure the constants ===
Erik Bakker 8.1 66
Erik Bakker 6.1 67 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.
Erik Bakker 2.1 68
Erik Bakker 6.1 69 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-constants.png]]
Erik Bakker 2.1 70
Erik Bakker 19.1 71 ==== 3.3.1 eMagizCustomerPassword ====
Erik Bakker 2.1 72
Erik Bakker 6.1 73 The first constant you need to configure is the password that connects the eMagiz Mendix Connector to the accompanying eMagiz Project.
74 The correct password can be retrieved from eMagiz. Simply navigate to **Deploy -> On-premises -> Runtime connection settings** and copy-paste the value for the Customer Password.
75 This is the value that you need to fill in for the eMagizCustomerPassword. The password in the below picture is removed for security reasons.
Erik Bakker 2.1 76
Erik Bakker 6.1 77 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-runtime-connection-settings.png]]
Erik Bakker 4.1 78
Erik Bakker 6.1 79 This configuration only needs to happen **once**.
Erik Bakker 4.1 80
Erik Bakker 19.1 81 ==== 3.3.2 eMagizCustomerUsername ====
Erik Bakker 4.1 82
Erik Bakker 6.1 83 The second constant you need to configure is the username that connects the eMagiz Mendix Connector to the accompanying eMagiz Project.
84 The correct username can be retrieved from eMagiz. Simply navigate to **Deploy -> On-premises -> Runtime connection settings** and copy-paste the value for the Customer Username.
85 This is the value that you need to fill in for the eMagizCustomerUsername. The username in the below picture is removed for security reasons.
Erik Bakker 4.1 86
Erik Bakker 6.1 87 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-runtime-connection-settings.png]]
Erik Bakker 4.1 88
Erik Bakker 6.1 89 This configuration only needs to happen **once**.
Erik Bakker 4.1 90
Erik Bakker 19.1 91 ==== 3.3.3 eMagizRuntimeEnvironment ====
Erik Bakker 4.1 92
Erik Bakker 6.1 93 The third constant you need to configure is a dynamic configuration that depends on the environment (Test, Acceptance, or Production) of your eMagiz project you want to connect your Mendix project.
94 When running the project locally it stands to reason that the Test environment (if available) would be the most logical choice.
95 When you deploy your Mendix application to Acceptance or Production make sure to change the value of this constant via the option Mendix offers you for it.
Erik Bakker 4.1 96
Erik Bakker 6.1 97 The correct value can either be prod, accp or test.
Erik Bakker 4.1 98
Erik Bakker 19.1 99 ==== 3.3.4 eMagizRuntimeName ====
Erik Bakker 4.1 100
Erik Bakker 6.1 101 The fourth constant defines which runtime in eMagiz relates to the Mendix application.
102 To correctly connect your Mendix application to your eMagiz project you need to fill in the technical name of the runtime that you have set up in eMagiz.
Erik Bakker 4.1 103
Erik Bakker 6.1 104 To find out the technical name of this runtime simply navigate to **Deploy -> Containers**.
105 Here you can see the technical name of all of your runtimes including the one that connects to your Mendix application.
106 The technical name is build up as follows: <busname>.connector.<technical_name of the Mendix system in eMagiz>
Erik Bakker 4.1 107
Erik Bakker 6.1 108 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-container-overview.png]]
Erik Bakker 4.1 109
Erik Bakker 6.1 110 If you have found your runtime name you can fill it in for the constant eMagizRuntimeName. This configuration only needs to happen **once**.
111
Erik Bakker 19.1 112 ==== 3.3.5 eMagizWsUrl ====
Erik Bakker 6.1 113
114 The fifth constant you need to configure is the URL from which you can retrieve the property configuration made in eMagiz that you need to successfully connect to eMagiz and exchange data with eMagiz.
115 The correct URL can be retrieved from eMagiz. Simply navigate to **Deploy -> On-premises -> Runtime connection settings** and copy-paste the value for the eMagiz WS URL.
116 This is the value that you need to fill in for the eMagizWsUrl. You can find the URL in the picture below.
117
118 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-runtime-connection-settings.png]]
119
120 This configuration only needs to happen **once**.
121
Erik Bakker 19.1 122 ==== 3.3.6 StartupDelay ====
Erik Bakker 6.1 123
124 The sixth and last constant that needs to be filled in is the startup delay.
125 This constant indicates how many milliseconds the process will wait before starting up the infra flow and registering the exit queues.
126 In case Mendix has not fully started up yet but the flows have already started up could lead to unexpected behavior and data loss.
127 Therefore we advise a setting of 30000ms for this constant.
128
129 This configuration only needs to happen **once**.
130
Erik Bakker 19.1 131 === 3.4 Configure the keystore/truststore ===
Erik Bakker 6.1 132
133 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.
134
Erik Bakker 12.1 135 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".
Erik Bakker 6.1 136
Erik Bakker 12.1 137 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--find-resources.png]]
Erik Bakker 6.1 138
Erik Bakker 12.1 139 In this overview, you will find the key and Truststore. Download these and place them in the resources folder of your Mendix project.
Erik Bakker 6.1 140
Erik Bakker 12.1 141 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**
Erik Bakker 6.1 142
143 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-project-directory.png]]
144
Erik Bakker 12.1 145 For Mendix projects running version 9.18.0 or higher please go to: **App -> Show App Directory In Explorer**.
146
147 [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-app-directory.png]]
148
Erik Bakker 10.1 149 Simply make sure that the Keystore and Truststore that you have downloaded from eMagiz are placed in this folder.
Erik Bakker 6.1 150
Erik Bakker 19.1 151 {{warning}}
152 Don't forget to include the unique number prefix eMagiz has given the key- and truststore. Otherwise the connection cannot be established.
153 {{/warning}}
Erik Bakker 10.1 154
Erik Bakker 6.1 155 This configuration only needs to happen **once**.
156
Eva Torken 11.1 157 == 4. Key takeaways ==
Erik Bakker 1.1 158
Erik Bakker 6.1 159 To configure an eMagiz Mendix Connector you need the following:
Erik Bakker 1.1 160
Erik Bakker 6.1 161 * Configure the After Startup and Before Shutdown
162 * Configure the Access rights to the eMagiz Mendix Module
163 * Configure the constants
164 * Configure the Keystore/Truststore
Erik Bakker 1.1 165
Erik Bakker 6.1 166 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.
Erik Bakker 1.1 167
Eva Torken 11.1 168 == 5. Suggested Additional Readings ==
Erik Bakker 1.1 169
Carlijn Kokkeler 13.1 170 * [[Novice (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Novice.WebHome||target="blank"]]
171 ** [[Mendix Connectivity (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.WebHome||target="blank"]]
172 *** [[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"]]
173 *** [[Install an eMagiz Mendix Connector (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.novice-mendix-connectivity-install-emagiz-mendix-connector.WebHome||target="blank"]]
Erik Bakker 19.1 174 *** [[Update an eMagiz Mendix Connector (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Legacy Functionality.novice-mendix-connectivity-update-emagiz-mendix-connector.WebHome||target="blank"]]
Erik Bakker 16.1 175 * [[Support (Menu)>>doc:Main.eMagiz Support.WebHome||target="blank"]]
176 ** [[Migration Paths (Navigation)>>doc:Main.eMagiz Support.Migration Paths.WebHome||target="blank"]]
Erik Bakker 19.1 177 *** [[eMagiz Mendix Connector 3.0.0 -~> 5.0.0 (Explanation)>>doc:Main.eMagiz Support.Migration Paths.migration-path-emagiz-mendix-connector-300-to-500||target="blank"]]
178 *** [[eMagiz Mendix Connector 4.2.0 -~> 5.0.0 (Explanation)>>doc:Main.eMagiz Support.Migration Paths.migration-path-emagiz-mendix-connector-420-to-500||target="blank"]]
Erik Bakker 15.1 179 * [[Mendix (Search Result)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22mendix%22||target="blank"]]
Erik Bakker 19.1 180 )))
Erik Bakker 1.1 181
Erik Bakker 19.1 182 (((
183 {{toc/}}
184 )))
185 {{/container}}
186 {{/container}}