Changes for page novice-mendix-connectivity-configure-emagiz-mendix-connector
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
on 2022/06/12 10:03
Change comment:
There is no comment for this version
To version 5.1
edited by Erik Bakker
on 2022/06/12 10:01
on 2022/06/12 10:01
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - novice-mendix-connectivity-configure-emagiz-mendix-connector1 +Update an eMagiz Mendix Connector - Content
-
... ... @@ -1,175 +1,102 @@ 1 -{{container}}{{container layoutStyle="columns"}}((( 2 - 3 - 4 - 5 -# Configure an eMagiz Mendix Connector 6 - 7 -In this microlearning, we will focus on configuring an eMagiz Mendix Connector. 1 +{{container}}{{container layoutStyle="columns"}}((( 2 +In this microlearning, we will focus on updating 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 12 * Last update: January 27th, 2021 13 -* Required reading time: 10minutes8 +* Required reading time: 7 minutes 14 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 -* 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** 21 21 22 22 == 2. Key concepts == 23 -This microlearning centers around configuring an eMagiz Mendix Connector16 +This microlearning centers around updating an eMagiz Mendix Connector 24 24 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. 25 25 26 -To configure an eMagiz Mendix Connector you need the following:19 +To update an eMagiz Mendix Connector you need the following: 27 27 28 -* Configure the After Startup and Before Shutdown 29 -* Configure the Access rights to the eMagiz Mendix Module 30 -* Configure the constants 31 -* Configure the Keystore/Truststore 21 +* The Mendix Module called the eMagiz Mendix Connector (available in eMagiz under Deploy of your project) 22 +* Access to a Mendix project which has an eMagiz Mendix Connector in it at this moment. 32 32 33 33 34 34 35 -== 3. Configure a eMagiz Mendix Connector26 +== 3. Update an eMagiz Mendix Connector 36 36 37 -To configure the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed.28 +To update the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed. 38 38 39 -=== 3.1 Configure the After Startup and Before Shutdown 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 -After Startup and Before Shutdown microflow of the project itself. 30 +=== 3.1 Download the eMagiz Mendix connector 31 +* The eMagiz Mendix connector can be downloaded via eMagiz. Log in and then go to one of the busses you have access to. 32 +* Go to **Deploy -> On Premises -> Runtime Downloads** the eMagiz Mendix connector can be downloaded. 33 +You must look at the column Mendix version. It must correspond to the Mendix version of the project where you want to use the eMagiz Mendix Connector. 34 +If you do not do this then the connector will **not** work. 42 42 43 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity- configure-emagiz-mendix-connector--after-startup-before-shutdown-emagiz.png]]36 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-emagiz-mendix-connector--emc-download-screen.png]] 44 44 45 -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. 46 -You can verify this by navigating to **Project Settings -> Runtime** 38 +=== 3.2 Importing eMagiz Mendix connector 47 47 48 - [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--after-startup-before-shutdown-project.png]]40 +Now that we have downloaded the correct eMagiz Mendix connector (the latest version that is available for the Mendix version of our project and newer compared to the current one) we can open Mendix itself. 49 49 50 -This configuration only needs to happen **once**. 51 - 52 -=== 3.2 Configure the Access rights to the eMagiz Mendix Module 53 -It is recommended that only the administrator user role has access to the eMagiz Mendix Connector module. 54 -To do this follow these steps: 42 +If you open your Project in Mendix you can navigate to the left-hand panel called "Project Explorer". In this panel, you see all modules (box icons) that are currently in the project. 43 +In Project Explorer, right-click and choose the option "Import module package..." 55 55 56 -* Navigate to **Project Security** 57 -* Validate that the security of your project is set to Production. If not please select the Production option 58 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--security-settings.png]] 59 -* Navigate to **User Roles** 60 -* Edit the Administrator role 61 -* Edit the Module roles 62 -* Check the box of the eMagiz Mendix Connector module and press OK 45 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package.png]] 63 63 64 - Theconfigurationbeforeyoupress OKshouldlookas follows47 +In the pop-up that follows select the correct eMagiz Mendix Connector version and press Open / Openen (depending on the language settings of your PC) 65 65 66 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity- configure-emagiz-mendix-connector--security-admin-result.png]]49 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-selection.png]] 67 67 68 - Thisconfigurationonlyneeds to happen**once**.51 +As a result, Mendix will show you the following pop-up. In this pop-up you press Import and Mendix will import the eMagiz Mendix Connector for you. 69 69 70 -=== 3.3 Configure the constants 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. 53 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-replace-existing-module.png]] 72 72 73 - [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-constants.png]]55 +You may be prompted with a warning pop-up the moment you update to a newer version. Make a screenshot and press OK. 74 74 75 - ==== 3.3.1eMagizCustomerPassword57 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-java-update-warning.png]] 76 76 77 -The first constant you need to configure is the password that connects the eMagiz Mendix Connector to the accompanying eMagiz Project. 78 -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. 79 -This is the value that you need to fill in for the eMagizCustomerPassword. The password in the below picture is removed for security reasons. 59 +=== 3.3 Cleaning up the project 80 80 81 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-runtime-connection-settings.png]] 61 +After you have updated to a new version of the eMagiz Mendix Connector you must clean the project before you do a new commit. 62 +Otherwise, it can happen that the communication between Mendix and eMagiz will take place based on the old instead of the new version. 82 82 83 - Thisconfigurationonly needstohappen**once**.64 +==== 3.3.1 Run the eMagiz Cleanup Tool 84 84 85 - ====3.3.2eMagizCustomerUsername66 +When you navigate to **Project -> Show Project Directory in Explorer -> resources** you will see one Jar file which you can run called the emagiz-cleanup-tool. 86 86 87 -The second constant you need to configure is the username that connects the eMagiz Mendix Connector to the accompanying eMagiz Project. 88 -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. 89 -This is the value that you need to fill in for the eMagizCustomerUsername. The username in the below picture is removed for security reasons. 68 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--emagiz-cleanup-tool.png]] 90 90 91 - [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-runtime-connection-settings.png]]70 +Run this cleanup tool by double-clicking on it to make sure that all ties to the old eMagiz Mendix Connector version are cut. In the pop-up that follows select the button Cleanup 92 92 93 - Thisfigurationlyneedsto happen**once**.72 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--emagiz-cleanup-tool-result.png]] 94 94 95 - ====3.3.3eMagizRuntimeEnvironment74 +After you have pressed Cleanup eMagiz will tell you whether or not this has succeeded. Below you see a successful result 96 96 97 -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. 98 -When running the project locally it stands to reason that the Test environment (if available) would be the most logical choice. 99 -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. 76 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--emagiz-cleanup-tool-success.png]] 100 100 101 - Thecorrectvaluecan either beprod,accp ortest.78 +==== 3.3.2 Cleanup Deployment Directory 102 102 103 -==== 3.3.4 eMagizRuntimeName 80 +As the pop-up states, the next step to finish up the update of your eMagiz Mendix Connector is to clean up your deployment directory. 81 +You can simply do this by navigating to **Project -> Clean Deployment Directory** and selecting that option. 104 104 105 -The fourth constant defines which runtime in eMagiz relates to the Mendix application. 106 -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. 83 +Congratulations, you have successfully updated your eMagiz Mendix Connector to the latest available version. 107 107 108 -To find out the technical name of this runtime simply navigate to **Deploy -> Containers**. 109 -Here you can see the technical name of all of your runtimes including the one that connects to your Mendix application. 110 -The technical name is build up as follows: <busname>.connector.<technical_name of the Mendix system in eMagiz> 111 111 112 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-container-overview.png]] 113 113 114 -If you have found your runtime name you can fill it in for the constant eMagizRuntimeName. This configuration only needs to happen **once**. 115 - 116 -==== 3.3.5 eMagizWsUrl 117 - 118 -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. 119 -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. 120 -This is the value that you need to fill in for the eMagizWsUrl. You can find the URL in the picture below. 121 - 122 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--emagiz-mendix-runtime-connection-settings.png]] 123 - 124 -This configuration only needs to happen **once**. 125 - 126 -==== 3.3.6 StartupDelay 127 - 128 -The sixth and last constant that needs to be filled in is the startup delay. 129 -This constant indicates how many milliseconds the process will wait before starting up the infra flow and registering the exit queues. 130 -In case Mendix has not fully started up yet but the flows have already started up could lead to unexpected behavior and data loss. 131 -Therefore we advise a setting of 30000ms for this constant. 132 - 133 -This configuration only needs to happen **once**. 134 - 135 -=== 3.4 Configure the keystore/truststore 136 - 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 - 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** 140 - 141 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--open-connector-infra.png]] 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. 144 - 145 -You can access this resources folder in the following manner: **Project -> Show Project Directory in Explorer -> Open the resources folder** 146 - 147 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-configure-emagiz-mendix-connector--show-project-directory.png]] 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** 150 - 151 -This configuration only needs to happen **once**. 152 - 153 - 154 - 155 155 == 4. Assignment == 156 156 157 -The assignment is simple this time. ConfigureyoureMagiz Mendix Connector.89 +The assignment is simple this time. Just update an eMagiz Mendix Connector. 158 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. 159 159 160 160 == 5. Key takeaways == 161 161 162 -To configure an eMagiz Mendix Connector you need the following: 94 +* The crucial part of updating an eMagiz Mendix Connector is to select the correct version that will work with your Mendix project 95 + ** To select the correct eMagiz Mendix Connector version look at the Mendix version your app is running in (8.0.0+,7.0.0+, etc.) and look at which of the versions eMagiz has released is the newest version (that is newer compared to the current version). 96 +* The actual installation in Mendix is simply importing a module package and selecting the correct one. As easy as can be. 163 163 164 -* Configure the After Startup and Before Shutdown 165 -* Configure the Access rights to the eMagiz Mendix Module 166 -* Configure the constants 167 -* Configure the Keystore/Truststore 168 168 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 171 - 172 - 173 173 == 6. Suggested Additional Readings == 174 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,7 +176,8 @@ 176 176 177 177 == 7. Silent demonstration video == 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. 106 +This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned. Disclaimer, you only see the eMagiz part but if you follow the above steps you are good to go! 181 181 182 -)))((({{toc/}}))){{container}}{{/container}} 108 +{{video attachment="novice-mendix-connectivity-update-update-emagiz-mendix-connector.mp4" reference="Main.Videos.Microlearning.WebHome"/}} 109 + 110 +)))((({{toc/}}))){{/container}}{{/container}}