Automatically mapping configurations for EDA events

With EPL event type definitions for the EDA events you want to use in your application, you can use Software AG Designer to automatically create sender and receiver mapping configurations in a correlator-integrated adapter for JMS.

1. If you have not already done so, add a correlator-integrated messaging adapter for JMS to your project.

2. In the Project Explorer pane, in the project that uses EDA events, expand the Adapters folder and double-click the correlator-integrated adapter for JMS instance to open it in the JMS Connections editor.

4. In the Sender Mapping Configuration tab, click the down-pointing carat to the right of the plus sign

and select Add EDA Event.

The Event Type Selection dialog appears with *_EDA in the filter field and a list of the EPL event type definitions that correspond to EDA event types.

5. Select one or more event types for which you want to configure sender mappings and click OK.

For each selected event, Software AG Designer generates three mappings from Apama EPL event type definitions to JMS messages that will publish EDA events:

Convert to XML is mapped to JMS Body. Apply EDA rules is automatically turned on for the Convert to XML node. This means that Software AG Designer applies a defined set of conventions for mappings between EPL event types that represent EDA events and the JMS messages that publish and consume the EDA events. See Rules that govern automatic conversion between of EDA events and Apama events and Rules that govern EPL name generation.

Constant node item JNDI DESTINATION is mapped to Destination. The Destination is the JNDI name, which follows the convention of the EDA event.

Important: You should use the administrative tools of your JMS provider to create a JMS topic, and map it to the JNDI name (according to EDA naming conventions) before using Apama to send or receive an EDA event.

Software AG Designer automatically specifies that the $Event$Type property of the JMS message should match the expected name of the EDA event. When the expression evaluates to true for the JMS property value of an incoming event it triggers the mapping of the incoming JMS message to an Apama EPL event type. Software AG Designer also automatically generates two mappings from JMS messages that consume EDA events to Apama EPL event type definitions:

JMS Body to the main text node in the event type definition. This mapping converts the EDA XML to Apama events according to the conventions of EDA mapping. For details, see Rules that govern automatic conversion between of EDA events and Apama events and Rules that govern EPL name generation.