Matching Plugin Development

Creating a matching plugin in MirthMatch is fairly simple. Just follow these steps:

1. Implement the BaseMatchingModulePlugin class as shown in the SimpleMatcher example below.
2. The matching module depends on MirthMatch-lib.jar, kana-lib.jar, and javax.persistence_1.0.0.jar. You can get these from MirthMatch.ear. Just rename it to MirthMatch.zip and you'll find them in the lib directory.
3. Create a jar out of your plugin.
   1. Make sure the jar includes a file called "com.mirth.match.lib.search.MatchingModulePlugin" in a directory called "META-INF/services". The file should contain just one line: the fully qualified name of your matcher class (e.g. "com.mirth.match.simpleMatcher.SimpleMatcher"). The META-INF folder should be in the same folder as the source code.
   2. When naming the package for the plugin, use the convention: com.mirth.match.XXXXX where XXXXX is a unique name for the package.
4. Place the jar into the plugins (e.g., C:\opt\mirthmatch\plugins) directory discussed in Installation Notes.
5. Restart glassfish and log into MirthMatch: http://localhost:8080/MirthMatch.
6. You should now see your matching module listed under Administration -> Setup -> Matching Modules.
7. If you encounter any problems, please check your server.log for any errors.