Wiki source code of Install an eMagiz Mendix Connector
Version 2.1 by Erik Bakker on 2022/06/12 10:00
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | {{container}}{{container layoutStyle="columns"}}((( |
| |
2.1 | 2 | In this microlearning, we will focus on installing 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. | ||
| |
1.1 | 4 | |
| 5 | Should you have any questions, please contact academy@emagiz.com. | ||
| 6 | |||
| |
2.1 | 7 | * Last update: January 27th, 2021 |
| 8 | * Required reading time: 5 minutes | ||
| |
1.1 | 9 | |
| 10 | == 1. Prerequisites == | ||
| 11 | * Basic knowledge of the eMagiz platform | ||
| 12 | * Access to a Mendix application | ||
| 13 | * Access to the Deploy phase of your eMagiz project | ||
| 14 | |||
| 15 | == 2. Key concepts == | ||
| |
2.1 | 16 | This microlearning centers around installing an eMagiz Mendix Connector |
| |
1.1 | 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 | |||
| |
2.1 | 19 | To install an eMagiz Mendix Connector you need the following: |
| |
1.1 | 20 | |
| |
2.1 | 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. | ||
| |
1.1 | 23 | |
| 24 | |||
| 25 | |||
| |
2.1 | 26 | == 3. Install an eMagiz Mendix Connector |
| |
1.1 | 27 | |
| |
2.1 | 28 | To install the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed. |
| |
1.1 | 29 | |
| |
2.1 | 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. | ||
| |
1.1 | 35 | |
| |
2.1 | 36 | [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-install-emagiz-mendix-connector--emc-download-screen.png]] |
| 37 | |||
| 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) we can open Mendix itself. | ||
| |
1.1 | 40 | |
| |
2.1 | 41 | 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. |
| 42 | In Project Explorer, right-click and choose the option "Import module package..." | ||
| |
1.1 | 43 | |
| |
2.1 | 44 | [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package.png]] |
| |
1.1 | 45 | |
| |
2.1 | 46 | 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) |
| |
1.1 | 47 | |
| |
2.1 | 48 | [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package-selection.png]] |
| |
1.1 | 49 | |
| |
2.1 | 50 | 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. |
| 51 | |||
| 52 | [[image:Main.Images.Microlearning.WebHome@novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package-add-as-new-module.png]] | ||
| 53 | |||
| 54 | In the following microlearnings, we will focus on configuring the eMagiz Mendix Connector and updating the eMagiz Mendix Connector. | ||
| 55 | |||
| 56 | |||
| 57 | |||
| |
1.1 | 58 | == 4. Assignment == |
| 59 | |||
| |
2.1 | 60 | The assignment is simple this time. Just install an eMagiz Mendix Connector. |
| 61 | 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. | ||
| |
1.1 | 62 | |
| 63 | == 5. Key takeaways == | ||
| 64 | |||
| |
2.1 | 65 | * The crucial part of installing an eMagiz Mendix Connector is to select the correct version that will work with your Mendix project |
| 66 | ** 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. | ||
| 67 | * The actual installation in Mendix is simply importing a module package and selecting the correct one. As easy as can be. | ||
| |
1.1 | 68 | |
| 69 | |||
| 70 | |||
| 71 | == 6. Suggested Additional Readings == | ||
| 72 | |||
| 73 | 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. | ||
| 74 | |||
| 75 | == 7. Silent demonstration video == | ||
| 76 | |||
| |
2.1 | 77 | 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! |
| |
1.1 | 78 | |
| |
2.1 | 79 | {{video attachment="novice-mendix-connectivity-install-emagiz-mendix-connector.mp4" reference="Main.Videos.Microlearning.WebHome"/}} |
| 80 | |||
| |
1.1 | 81 | )))((({{toc/}}))){{/container}}{{/container}} |