IMS support for on-premises installations

The ION Messaging Service (IMS) is part of Infor Local Technology Runtime.

IMS allows applications to integrate with ION through REST/JSON APIs.

From version 10.7.0, Connector for Web Services supports multiple IMS requests, version 2, that are required to enable "Data Lake Publishing" in LN. This table shows those IMS requests:


Name	Type	URL
ping	GET	api/ion/messaging/service/ping
protocol	GET	api/ion/messaging/service/protocol
discovery	POST	api/ion/messaging/service/v2/discovery

You must append the URLs to the "base URL" of Connector for Web Services. This base URL is similar to http://server.example.com:8312/c4ws/.

From version 12.2.2, Connector for Web Services additionally supports BOD publishing in LN through the multipartMessage request of IMS. This table shows the multipartMessage request:


Name	Type	URL
multipartMessage	POST	api/ion/messaging/service/v2/multipartMessage
multipartMessage (company-specific)	POST	api/ion/messaging/service/{company_nr}/v2/multipartMessage

You can send the BODs to a specific LN company. To do so, insert a company number in the URL, between service and v2. This way you can define a company-specific connection in ION Desk. If no company number has been specified in the URL, then company 0 is used.

Note: In ION Desk, the "IMS Endpoint URL" of a connection point must be specified as follows: you must specify the base URL of Connector for Web Services extended with api/ion/messaging/service or api/ion/messaging/service/{company_nr}.

Connector for Web Services supports IMS requests to only one LN environment, that is, "ERP Server". You can select the environment in the IMS Environment group on the ERP Servers administration page.

An IMS environment must use "baanlogin_ssl" activation. For the SSL communication, keystores that contain certificates with public and private keys are required. These keystores must be present on both the Connector for Web Services server and the LN server. The configuration page of Connector for Web Services does not have the functionality to generate and exchange such certificates. Instead, you can use the LN Environments (uigwt0010m000) session in the LN UI Administration Webapp. If LN UI is not installed yet on the Connector for Web Services server, then you can install LN UI through the same installer that installed Connector for Web Services.