Creating a custom handler for address standardization
If your business needs require that you use a custom address standardization handler, use this procedure.
- Make sure that the IBM® WebSphere® Application Server is
running and the operational server-side applications are deployed
- Open the IBM WebSphere Application Server administrative console.
- Select .
- Select the applications and select Start from the menu.
- Select Submit Action.
- In InfoSphere® MDM Workbench, create a new configuration project.
- In the Configuration editor, select Member Types and go to the Attributes tab.
- Add new attributes to store the standardized address for the selected member type.
- In the Configuration editor, select Handlers.
- In the Handler editor, click Add.
- Type a handler name.
- Use the sequence number default.
- In the Callback field, select pre-interaction.
- In the Interaction code field, select MEMPUT.
- Enter your handler arguments. Input must in the format of attrCode1:attrCode2, attrCode1:attrCode2,…. The format is case-sensitive and must not have any spaces in between.
- Click Generate to generate the OSGi bundle and CBA projects for this new handler. The Java source file for the interaction handler, inside the bundle project, is automatically opened.
- Deploy the operational server configuration (with the new attribute codes and handler definition) to the MDM database.
- In the Java™ source file, write the code to perform the address standardization. You can use the Java source for the prepackaged default handler for reference. If is turned on, your Java source file compiles automatically. Verify that your code compiles without errors.
- Right-click the CBA project and click Export.
- Select the export destination
.Verify that the bundles you are exporting include your operational server module bundle.
- Click Browse and choose a location to save the CBA file, then click Finish.
- Open the IBM WebSphere Application Server admin console and, in the navigation frame, click , then click New.
- Select the local file system and browse to where you saved the CBA you exported from the MDM Workbench, then click OK, then click Save directly to the master configuration.
- In the navigation frame, click InfoSphere MDM application
(com.ibm.mdm.hub.server.app) and select the EBA
deployed asset (com.ibm.mdm.hub.server.app_CU.eba).
and click on the This step can take several minutes.
- Click Extensions for this composition unit, then click Add.
- Select the check box next to the imported CBA, then click Add.
It can take a few minutes to load the next page
- Click Save directly to the master configuration.
Completing this action returns you to the composition unit page.
- Click the button labelled Update to latest
deployment to examine the preview of changes and then
click OK. For your extension CBA, it should show it changing from Not deployed to a version number.
- Click Next through the options wizard, accepting the default options on each page, then click Finish.
- Click Save directely to the master configuration.
- Restart the server.
- Add the URL for the IBM Information
Server location where the InfoSphere QualityStage® job runs.
- Use a database client to view the contents of the CONFIGELEMENT table.
- Locate the record with the NAME field
/IBM/ThirdPartyAdapters/IIS/providerURL. A default value for this name is set in the DEFAULT_VALUE field. Add the IIS server URL in the VALUE field.You can modify this sample SQL statement to add the URL:
UPDATE configelement SET value = 'http://<<IIS server host name>>:<<portnumber>>', last_update_dt = current timestamp WHERE name = '/IBM/ThirdPartyAdapters/IIS/providerURL'
- Confirm that the input and output attribute mappings in
the CONFIGELEMENT table are correctly set.
- Use a database client and view the contents of the CONFIGELEMENT table.
- Locate the records for which NAME starts with
- Make sure that the input and output attribute maps are set correctly to match the handler arguments in the handler definition.
- IBM WebSphere Application Server and
the operational server must be restarted to use the new configuration
and CONFIGELEMENT table updates.
- Open IBM WebSphere Application Server administrative console and select Servers.
- Select the name of your MDM operational server.
- Click Stop.
- Click Start.