Install an eMagiz Mendix Connector

Last modified by Eva Torken on 2023/06/20 16:20

In this microlearning, we will focus on installing an eMagiz Mendix Connector.
With the help of this Mendix module created by the eMagiz team, you can easily connect between Mendix and eMagiz for data integration.

Should you have any questions, please contact academy@emagiz.com.

1. Prerequisites

  • Basic knowledge of the eMagiz platform
  • Access to a Mendix application
  • Access to the Deploy phase of your eMagiz project

2. Key concepts

This microlearning centers around installing an eMagiz Mendix Connector
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.

To install an eMagiz Mendix Connector you need the following:

  • The Mendix Module called the eMagiz Mendix Connector (available in eMagiz under Deploy of your project)
  • Access to a Mendix project which has no eMagiz Mendix Connector in it at this moment.

3. Install an eMagiz Mendix Connector

To install the eMagiz Mendix Connector in a Mendix app, the following steps need to be performed.

3.1 Download the eMagiz Mendix connector

  • The eMagiz Mendix connector can be downloaded via eMagiz. Log in and then go to one of the busses you have access to.    
  • Go to Deploy -> On Premises -> Runtime Downloads the eMagiz Mendix connector can be downloaded.
    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.
    If you do not do this then the connector will not work.

novice-mendix-connectivity-install-emagiz-mendix-connector--emc-download-screen.png 
 

3.2 Importing eMagiz Mendix connector

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.

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.
In Project Explorer, right-click and choose the option "Import module package..."

novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package.png

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)

novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package-selection.png

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.

novice-mendix-connectivity-install-emagiz-mendix-connector--import-module-package-add-as-new-module.png

In the following microlearnings, we will focus on configuring the eMagiz Mendix Connector and updating the eMagiz Mendix Connector.

4. Key takeaways

  • The crucial part of installing an eMagiz Mendix Connector is to select the correct version that will work with your Mendix project
    • 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.
  • The actual installation in Mendix is simply importing a module package and selecting the correct one. As easy as can be.

5. Suggested Additional Readings

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.