Skip to Content
Last modified by Erik Bakker on 2025/02/25 16:09
From version 14.1
edited by Erik Bakker
on 2024/06/06 09:17
Change comment: There is no comment for this version
To version 6.1
edited by Erik Bakker
on 2022/06/12 10:03
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -5,6 +5,9 @@
5 5  
6 6  Should you have any questions, please contact academy@emagiz.com.
7 7  
8 +* Last update: January 27th, 2021
9 +* Required reading time: 7 minutes
10 +
8 8  == 1. Prerequisites ==
9 9  * Basic knowledge of the eMagiz platform
10 10  * Access to a Mendix application
... ... @@ -19,20 +19,21 @@
19 19  * The Mendix Module called the eMagiz Mendix Connector (available in eMagiz under Deploy of your project)
20 20  * Access to a Mendix project which has an eMagiz Mendix Connector in it at this moment.
21 21  
22 -== 3. Update an eMagiz Mendix Connector ==
23 23  
24 -=== 3.1 Download the eMagiz Mendix connector via eMagiz ===
25 -To update the eMagiz Mendix Connector in a Mendix app you first have to download it. You can download it from the eMagiz portal or via the Mendix marketplace.
26 26  
27 -==== 3.1.1 Download the eMagiz Mendix connector ====
28 - * To retrieve the eMagiz Mendix connector from the portal execute the following steps.
29 - ** Log in at eMagiz and then go to one of the busses you have access to.
30 - ** Go to **Deploy -> On Premises -> Runtime Downloads**. Here you can download the eMagiz Mendix connector.
27 +== 3. Update an eMagiz Mendix Connector
31 31  
29 +To update the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed.
30 +
31 +=== 3.1 Download the eMagiz Mendix connector
32 +* The eMagiz Mendix connector can be downloaded via eMagiz. Log in and then go to one of the busses you have access to.
33 +* Go to **Deploy -> On Premises -> Runtime Downloads** the eMagiz Mendix connector can be downloaded.
34 +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.
35 +If you do not do this then the connector will **not** work.
36 +
32 32  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-emagiz-mendix-connector--emc-download-screen.png]]
33 33  
34 -{{info}}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.
35 -If you do not do this then the connector will **not** work.{{/info}}
39 +=== 3.2 Importing eMagiz Mendix connector
36 36  
37 37  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.
38 38  
... ... @@ -45,18 +45,6 @@
45 45  
46 46  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-selection.png]]
47 47  
48 -==== 3.1.2 Download the eMagiz Mendix connector via Mendix ====
49 - * To retrieve the eMagiz Mendix connector from the Mendix Marketplace execute the following steps.
50 - ** Open your Mendix model via Mendix Studio Pro and then select the "Marketplace" option in the right panel
51 - ** Search for "eMagiz Mendix" and select the item called "eMagiz Mendix Connector"
52 - ** In the screen that follows press the "Download" button.
53 -
54 -[[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-emagiz-mendix-connector--mendix-marketplace-download-screen.png]]
55 -
56 -Once downloaded, the following steps need to be performed.
57 -
58 -=== 3.2 Importing eMagiz Mendix connector ===
59 -
60 60  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.
61 61  
62 62  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-replace-existing-module.png]]
... ... @@ -65,7 +65,7 @@
65 65  
66 66  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--import-module-package-java-update-warning.png]]
67 67  
68 -=== 3.3 Cleaning up the project ===
60 +=== 3.3 Cleaning up the project
69 69  
70 70  After you have updated to a new version of the eMagiz Mendix Connector you must clean the project before you do a new commit.
71 71  Otherwise, it can happen that the communication between Mendix and eMagiz will take place based on the old instead of the new version.
... ... @@ -84,8 +84,6 @@
84 84  
85 85  [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-update-update-emagiz-mendix-connector--emagiz-cleanup-tool-success.png]]
86 86  
87 -{{warning}}Note that the eMagiz cleanup tool may not clean up all relevant user libraries, especially when using other Marketplace modules or when the user library is outdated. You can experience this when running the new version for the first time. If this happens, please use the list provided by the Cleanup tool when nothing needs to be removed (according to the cleanup tool).{{/warning}}
88 -
89 89  ==== 3.3.2 Cleanup Deployment Directory
90 90  
91 91  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.
... ... @@ -93,14 +93,29 @@
93 93  
94 94  Congratulations, you have successfully updated your eMagiz Mendix Connector to the latest available version.
95 95  
96 -== 4. Key takeaways ==
97 97  
87 +
88 +== 4. Assignment ==
89 +
90 +The assignment is simple this time. Just update an eMagiz Mendix Connector.
91 +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.
92 +
93 +== 5. Key takeaways ==
94 +
98 98  * The crucial part of updating an eMagiz Mendix Connector is to select the correct version that will work with your Mendix project
99 99   ** 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).
100 100  * The actual installation in Mendix is simply importing a module package and selecting the correct one. As easy as can be.
101 101  
102 -== 5. Suggested Additional Readings ==
103 103  
100 +
101 +== 6. Suggested Additional Readings ==
102 +
104 104  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.
105 105  
105 +== 7. Silent demonstration video ==
106 +
107 +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!
108 +
109 +{{video attachment="novice-mendix-connectivity-update-update-emagiz-mendix-connector.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
110 +
106 106  )))((({{toc/}}))){{/container}}{{/container}}