Calyx RIM Data Exchange

Data Exchange Web Service

InSight Data Exchange  6.2 includes the Data Exchange Web Service.

The Data Exchange Web Service provides a convenient way for an application to import data into the InSight Data Exchange database.

An application can still import data by using the InSight Data Exchange client API to format messages and by using the Data Exchange Web Service to post the messages to a JMS queue. Posting to the queue directly requires dataExchange-examples.jar Implementation-Version: 1.0.0.141 or earlier and is not supported in Calyx RIM 6.2.

Benefits of using the Data Exchange Web Service:
  • RESTful Web Service. The Data Exchange functionality is exposed as a RESTful Web service. An application can use an external system such as Message-Orientated Middleware (MOM) to post messages to the Data Exchange Web Service.
  • Exposed Message Format. To post a message to the web service, messages can be constructed and sent via the Data Exchange client API or use the provided grammar to construct the messages manually.
  • HTTP/HTTPS. An application can use HTTP to send messages to the Data Exchange Web Service. Calyx RIM supports SSL, enabling an application to send messages by using HTTPS, which provides more security and control.
  • Status Reporting. If an application posts messages to a JMS queue via a legacy Data Exchange client API, the application writes errors to a log file on the Calyx RIM server. If an application posts messages to the Data Exchange Web Service, the application writes log messages to a transaction ledger. The application can issue GET requests remotely to retrieve these messages.

Same Data Exchange Functionality

InSight Data Exchange import functionality is the same regardless whether the application posts to the Data Exchange Web Service or to a JMS queue. The Data Exchange Web Service does not currently support Data Exchange export functionality.