Skip to Content
Last modified by Erik Bakker on 2025/02/25 16:09
From version 24.1
edited by Erik Bakker
on 2024/09/09 12:23
Change comment: There is no comment for this version
To version 25.1
edited by Erik Bakker
on 2025/02/25 16:09
Change comment: Renamed back-links.

Summary

Details

Page properties
Content
... ... @@ -1,5 +1,6 @@
1 -{{container}}{{container layoutStyle="columns"}}(((
2 -
1 +{{container}}
2 +{{container layoutStyle="columns"}}
3 +(((
3 3  This document describes the difference between the 3.0 version of the eMagiz Mendix Connector and the 4.X and onwards versions of the eMagiz Mendix Connector. On top of that it describes the checks and balances one has to go through while migrating from the 3.0 version to a newer version.
4 4  
5 5  == 1. Positioning ==
... ... @@ -8,22 +8,24 @@
8 8  
9 9  To take benefit from this, eMagiz has released this version to take the first steps in this direction. Below are some more details and instructions to use this new version. Please read these carefully.
10 10  
11 -{{warning}}This version removes the web service layer from the eMagiz Mendix Connector. Mendix now connects to the eMagiz bus directly using Java Actions in microflows. The first upgrade to this new version may take more time for development and testing than previous updates of the eMagiz Mendix Connector. After that, however, it should be easier in use for both Mendix and eMagiz developers.{{/warning}}
12 +{{warning}}
13 +This version removes the web service layer from the eMagiz Mendix Connector. Mendix now connects to the eMagiz bus directly using Java Actions in microflows. The first upgrade to this new version may take more time for development and testing than previous updates of the eMagiz Mendix Connector. After that, however, it should be easier in use for both Mendix and eMagiz developers.
14 +{{/warning}}
12 12  
13 13  Please find the package on the usual location: Under Deploy --> On-premise --> Runtime downloads tab
14 14  
15 15  == 2. Comparison ==
16 16  
17 -| Mendix V6/V7 Connector| Mendix V8 Connector|
18 -| ------ | ------ |
19 -| Messages received in XML | Messages received in XML, JSON or Data Model|
20 -| Web service required to receive messages. For sending messages, a Request Handler in the Mendix model is required | Direct connection to the eMagiz queue (onramp/offramp) made via Java Action|
21 -| Each flow (exit, entry and infra) needs to be deployed | Only infra flow needs to be deployed once, microflows connected to the queues directly|
20 +| Mendix V6/V7 Connector| Mendix V8 Connector|\\
21 +| -- --| -- --|\\
22 +| Messages received in XML | Messages received in XML, JSON or Data Model|\\
23 +| Web service required to receive messages. For sending messages, a Request Handler in the Mendix model is required | Direct connection to the eMagiz queue (onramp/offramp) made via Java Action|\\
24 +| Each flow (exit, entry and infra) needs to be deployed | Only infra flow needs to be deployed once, microflows connected to the queues directly|\\
22 22  |Incoming webservice|Microflow - Java action details |
23 23  
24 24  == 3. Migration Path ==
25 25  
26 -* Download the package and update the eMagiz Mendix Connector. If you are unsure how, please check out this [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.novice-mendix-connectivity-update-emagiz-mendix-connector.WebHome||target="blank"]]
29 +* Download the package and update the eMagiz Mendix Connector. If you are unsure how, please check out this [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Legacy Functionality.novice-mendix-connectivity-update-emagiz-mendix-connector.WebHome||target="blank"]]
27 27  * Locate the name of the queue that interacts with Mendix web service currently in place
28 28  * Remove the Web service components in the Mendix model
29 29  * At the point where this web service component was called, replace it with the appropriate Java action from the Connector module. Use the queue name located in the first step.
... ... @@ -31,6 +31,7 @@
31 31  * Test if the messages are properly working
32 32  
33 33  **Key considerations**
37 +
34 34  * Check if [%CurrentUser%] is not used in the microflow when processing incoming messages. Mendix loses this value when using a Java action microflow. An error message is generated and the message is not processed.
35 35  * Understand the impact of the user that is updating/creating the domain model object. The web service user is no longer used to update/create the domain model object
36 36  * A best practice can be to store the XSDs of the various integrations into the resources folder of the mendix project so that the entire team has access to the latest
... ... @@ -39,10 +39,11 @@
39 39  == 4. Key takeaways ==
40 40  
41 41  Please take care of the following items when you start to use this version of the Connector to ensure you can use it properly
46 +
42 42  * Use supplied Java actions in the eMagiz Mendix connector to set up the connections
43 43  * These 2 libraries could cause issues with the current version of the Connector - please evaluate the necessity of these before deleting them
44 - ** xerces.xercesImpl.2.8.1.jar
45 - ** xmlbeans-3.0.1.jar.ExcelImporter.jar
49 +** xerces.xercesImpl.2.8.1.jar
50 +** xmlbeans-3.0.1.jar.ExcelImporter.jar
46 46  * Make sure that you configure the exits in eMagiz correctly when using the latest version of the eMagiz Mendix Connector.
47 47  
48 48  == 5. Addendum eMagiz Mendix Connector 5.1.0 ==
... ... @@ -50,13 +50,15 @@
50 50  With the release of the newewst version of the eMagiz Mendix Connector a couple of things have changed.
51 51  
52 52  * On project startup the connector-infra configuration is downloaded, installed, and started automatically.
53 - ** When it is not possible to retrieve the active release, the previous connector-infra will be used.
54 - ** The Configuration Overview snippet is back so you can download the release if needed.
58 +** When it is not possible to retrieve the active release, the previous connector-infra will be used.
59 +** The Configuration Overview snippet is back so you can download the release if needed.
55 55  * Improved exception handling for synchronous entry integrations.
56 - ** Standard eMagiz bus exceptions are recognized and converted into Mendix exceptions.
61 +** Standard eMagiz bus exceptions are recognized and converted into Mendix exceptions.
57 57  ** Improved way of working with synchronous exits and entries in combination with the import and export mapping (or the absence of them)
58 58  
59 -{{info}}Note that this is a brief description of how to migrate from 3.0.0 to a higher version of the eMagiz Mendix Connector. For a full migration path from 4.2.0 towards 5.X.0 please see this [[migration path>>doc:Main.eMagiz Support.Migration Paths.migration-path-emagiz-mendix-connector-420-to-500||target="blank"]]{{/info}}
64 +{{info}}
65 +Note that this is a brief description of how to migrate from 3.0.0 to a higher version of the eMagiz Mendix Connector. For a full migration path from 4.2.0 towards 5.X.0 please see this [[migration path>>doc:Main.eMagiz Support.Migration Paths.migration-path-emagiz-mendix-connector-420-to-500||target="blank"]]
66 +{{/info}}
60 60  
61 61  === 5.1 Infra download, installation and starting ===
62 62  
... ... @@ -73,8 +73,14 @@
73 73  == 6. Suggested Additional Readings ==
74 74  
75 75  * [[Migration Paths (Navigation)>>doc:Main.eMagiz Support.Migration Paths.WebHome||target="blank"]]
76 -** [[eMagiz Mendix Connector 4.2.0 -> 5.0.0 (Explanation)>>doc:Main.eMagiz Support.Migration Paths.migration-path-emagiz-mendix-connector-420-to-500||target="blank"]]
83 +** [[eMagiz Mendix Connector 4.2.0 -~> 5.0.0 (Explanation)>>doc:Main.eMagiz Support.Migration Paths.migration-path-emagiz-mendix-connector-420-to-500||target="blank"]]
77 77  * [[Novice Level (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Novice.WebHome||target="blank"]]
78 78  ** [[Mendix Connectivity (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Mendix Connectivity.WebHome||target="blank"]]
79 79  * [[eMagiz Mendix Connector (Search Result)>>url:https://docs.emagiz.com/bin/view/Main/Search?text=%22emagiz%20mendix%20connector%22&f_type=DOCUMENT&f_space_facet=0%2FMain.&f_locale=en&f_locale=&f_locale=en&r=1||target="blank"]]
80 -)))((({{toc/}}))){{/container}}{{/container}}
87 +)))
88 +
89 +(((
90 +{{toc/}}
91 +)))
92 +{{/container}}
93 +{{/container}}