Skip to Content
Last modified by Erik Bakker on 2025/02/25 16:09
From version 3.2
edited by Erik Bakker
on 2022/06/12 10:00
Change comment: Update document after refactoring.
To version 4.1
edited by Erik Bakker
on 2022/06/12 10:01
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -novice-mendix-connectivity-update-emagiz-mendix-connector
1 +Update an eMagiz Mendix Connector
Content
... ... @@ -1,11 +1,11 @@
1 1  {{container}}{{container layoutStyle="columns"}}(((
2 -In this microlearning, we will focus on installing an eMagiz Mendix Connector.
2 +In this microlearning, we will focus on updating an eMagiz Mendix Connector.
3 3  With the help of this Mendix module created by the eMagiz team, you can easily connect between Mendix and eMagiz for data integration.
4 4  
5 5  Should you have any questions, please contact academy@emagiz.com.
6 6  
7 7  * Last update: January 27th, 2021
8 -* Required reading time: 5 minutes
8 +* Required reading time: 7 minutes
9 9  
10 10  == 1. Prerequisites ==
11 11  * Basic knowledge of the eMagiz platform
... ... @@ -13,19 +13,19 @@
13 13  * Access to the Deploy phase of your eMagiz project
14 14  
15 15  == 2. Key concepts ==
16 -This microlearning centers around installing an eMagiz Mendix Connector
16 +This microlearning centers around updating an eMagiz Mendix Connector
17 17  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.
18 18  
19 -To install an eMagiz Mendix Connector you need the following:
19 +To update an eMagiz Mendix Connector you need the following:
20 20  
21 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 no eMagiz Mendix Connector in it at this moment.
22 +* Access to a Mendix project which has an eMagiz Mendix Connector in it at this moment.
23 23  
24 24  
25 25  
26 -== 3. Install an eMagiz Mendix Connector
26 +== 3. Update an eMagiz Mendix Connector
27 27  
28 -To install 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.
29 29  
30 30  === 3.1 Download the eMagiz Mendix connector
31 31  * The eMagiz Mendix connector can be downloaded via eMagiz. Log in and then go to one of the busses you have access to.
... ... @@ -33,38 +33,65 @@
33 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 34  If you do not do this then the connector will **not** work.
35 35  
36 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-install-emagiz-mendix-connector--emc-download-screen.png]]
36 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-emagiz-mendix-connector--emc-download-screen.png]]
37 37  
38 38  === 3.2 Importing eMagiz Mendix connector
39 +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.
39 39  
40 -Now that we have downloaded the correct eMagiz Mendix connector (the latest version that is available for the Mendix version of our project) we can open Mendix itself.
41 -
42 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 43  In Project Explorer, right-click and choose the option "Import module package..."
44 44  
45 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package.png]]
44 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package.png]]
46 46  
47 47  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)
48 48  
49 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package-selection.png]]
48 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-selection.png]]
50 50  
51 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.
52 52  
53 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package-add-as-new-module.png]]
52 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-replace-existing-module.png]]
54 54  
55 -In the following microlearnings, we will focus on configuring the eMagiz Mendix Connector and updating the eMagiz Mendix Connector.
54 +You may be prompted with a warning pop-up the moment you update to a newer version. Make a screenshot and press OK.
56 56  
56 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-java-update-warning.png]]
57 57  
58 +=== 3.3 Cleaning up the project
58 58  
60 +After you have updated to a new version of the eMagiz Mendix Connector you must clean the project before you do a new commit.
61 +Otherwise, it can happen that the communication between Mendix and eMagiz will take place based on the old instead of the new version.
62 +
63 +==== 3.3.1 Run the eMagiz Cleanup Tool
64 +
65 +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.
66 +
67 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--emagiz-cleanup-tool.png]]
68 +
69 +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
70 +
71 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--emagiz-cleanup-tool-result.png]]
72 +
73 +After you have pressed Cleanup eMagiz will tell you whether or not this has succeeded. Below you see a successful result
74 +
75 +[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--emagiz-cleanup-tool-success.png]]
76 +
77 +==== 3.3.2 Cleanup Deployment Directory
78 +
79 +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.
80 +You can simply do this by navigating to **Project -> Clean Deployment Directory** and selecting that option.
81 +
82 +Congratulations, you have successfully updated your eMagiz Mendix Connector to the latest available version.
83 +
84 +
85 +
59 59  == 4. Assignment ==
60 60  
61 -The assignment is simple this time. Just install an eMagiz Mendix Connector.
88 +The assignment is simple this time. Just update an eMagiz Mendix Connector.
62 62  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.
63 63  
64 64  == 5. Key takeaways ==
65 65  
66 -* The crucial part of installing an eMagiz Mendix Connector is to select the correct version that will work with your Mendix project
67 - ** 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.
93 +* The crucial part of updating an eMagiz Mendix Connector is to select the correct version that will work with your Mendix project
94 + ** 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).
68 68  * The actual installation in Mendix is simply importing a module package and selecting the correct one. As easy as can be.
69 69  
70 70  
... ... @@ -75,8 +75,8 @@
75 75  
76 76  == 7. Silent demonstration video ==
77 77  
78 -This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned. Disclaimer, you don't see the pop-up appearing in Mendix but if you follow the above steps you are good to go!
105 +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!
79 79  
80 -{{video attachment="novice-mendix-connectivity-install-emagiz-mendix-connector.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
107 +{{video attachment="novice-mendix-connectivity-update-update-emagiz-mendix-connector.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
81 81  
82 82  )))((({{toc/}}))){{/container}}{{/container}}