Enabling event notification for hybrid MDM

After you have loaded the data, enable event notifications.

About this task

Event notification allows your implementation to detect changes to member records on the virtual MDM, which cause changes to the composite view for the corresponding entity. Those changes generate events that notify the persistEntity service to make the corresponding change to the data persisted within the physical MDM database. Enable event notification after the initial data load.

Note: Hybrid MDM supports only the transitive linking style. The non-transitive, best match, and trusted source linking styles are not available.

IBM® InfoSphere® MDM includes an event handler pre-configured for hybrid MDM implementations. The following steps describe how to enable the handler to process events.

The steps describe setting up event notification in the InfoSphere MDM Workbench (in the Configuration perspective). The steps also describe setting up the security context and enabling of entity events for the event handler

Procedure

In the InfoSphere MDM Workbench workspace, open the hybrid MDM configuration project and double-click the .imm file. The configuration editor opens.
In the configuration editor, select the Events view.
In the Event Notification tab, click Add and set the Destination name to MDMLinkDest.
Set the Handler name to MDMLink.
Set Entity to Person.
For the Event type, select ENTITY CREATED, ENTITY DELETED, and ENTITY UPDATED.
For each event type, set the View to HybridPerson.
Also, for each event type, set Enable change detection to true.
Next, set Entity to Organization.
Again, for the Event type, select ENTITY CREATED, ENTITY DELETED, and ENTITY UPDATED.
For each event type, set the View to HybridOrg.
For each event type, set Enable change detection to true.
Click Add to add the new event notification.
Set up the security context for the event handler worker manager.
1. On the server where InfoSphere MDM is installed, navigate in the file system to the application server deployment directory for the installation: mad.root.dir/conf.
2. If it does not exist already, create a configuration file named com.ibm.mdm.mds.event.manager.cfg. You use this file to set the user account for running the event handlers.
3. Create a user with the MDM "ServiceConsumer" role, for example: workManagerPassword=cusadmin and workManagerUserName=cusadmin.
  Note: Optionally, you can use an encrypted password.
Enable staging of entity events in the event manager.
1. In the same com.ibm.mdm.mds.event.manager.cfg configuration file, set enableEntityEventStaging=true and enableGroupProcessing=false. Also update the stagingWaitSeconds property if you are not using the default value.
2. Save and close the configuration file.
If you already enabled the hybrid MDM composite view, you can deploy the event handler and the composite view. After you deploy, restart the server.
Note: You can customize the event notification handler. For example, you can customize it to conditionally persist entities based on your own logic by modifying an external rule. See MDMLinkRule.java (registered as rule #210). At the end of this topic, see the link about managing external rules.

Last updated: 23 October 2014