Event Receiver

Configuring WSO2Event Event Receiver

This will convert the events which coming from Siddhi in to wso2Events according to the mapping configurations.

Hence WSO2Event has three data types (Meta, Correlation and Payload), the CEP back end runtime event attributes can be mapped to any one of them by adding the mapping configuration under their type names.

Configuring through the Management Console UI

1. Log in to the CEP management console and select the Main menu in the left hand side of the screen. Then select the Add menu item under Event Receiver menu.

2. The Create a New Event Receiver window opens, using which you can configure new event receivers. Enter the following details in the form to create a wso2Event mapping based event receiver as shown in the screenshot below.


Create Event Receiver

Here, there are several properties that need to be filled when creating a event receiver. User interface is divided in to 3 main components (From, Mapping and To) except the event receiver name to give more understanding to the user.

WSO2Event Mapping

WSO2Event contains three types of data properties. They are Meta Data, Correlation Data and Payload Data. Each data property needs to have

3. After adding details click the Add Event Receiver button. The Available Event Receiver page will open. To view event receiver configurations, click on the event receiver name. To delete event receiver, click the Delete button.


Create Event Receiver


Editing Event Receiver Configuration through the Management Console

By Clicking the Edit button of the relevant event receiver, you will able to edit the event receiver configuration and redeploy it. When you click the Edit button, it will redirect to a xml based editor window which allow you to edit the event receiver configuration from UI without opening the configuration file in the file system.


Create Event Receiver

Configuring through a xml File

You can specify a event receiver configuration through in a xml file and deploy it in the deployment directory in the server. Event Receiver deployment directory is available at <CARBON_HOME>/repository/deployment/server/eventreceivers . This is an hot deployment directory, then it is easy to deploy and undeploy an event receiver configuration.

1. Create a xml file and enter the following WSO2Event mapping event receiver configurations inside the above mentioned hot deployment directory. Event receiver implementation needs to be start with "eventreceiver" root element.

<eventReceiver name="StatisticsReceiver" xmlns="http://wso2.org/carbon/eventreceiver">
        <from streamName="statisticsStream" version="1.0.0"/>
        <mapping type="wso2event">
            <metaData>
                <property>
                    <from name="ipAddress"/>
                    <to name="ipAdd" type="string"/>
                </property>
            </metaData>
            <payloadData>
                <property>
                    <from name="user"/>
                    <to name="username" type="string"/>
                </property>
            </payloadData>
        </mapping>
        <to eventAdapterType="wso2EventSender" eventAdapterType="wso2event">
            <property name="stream">statisticsOutStream</property>
            <property name="version">1.0.0</property>
            </to>
    </eventReceiver>

For more details on creating different types of event receivers, Please refer the official documentation Here.