Using Your Plug-ins | ||
---|---|---|
Previous | Next | |
Releasing the Plug-in | Appendices |
Plug-ins designed with the Plug-in Architecture can be used as regular plug-ins.
See the
"Integration Process Design" chapter
"Semarchy Convergence for MDM Developer’s Guide" for more information.
You can use the sample plug-in example created with this guide in the demonstration environment provided for the "Semarchy Convergence for MDM Getting Started Guide", or in your own projects.
Note: Before using your plug-in in the demonstration environment, it is recommended that you first get comfortable with the Semarchy Workbench and the demonstration environment by running the entire Getting Started.
To set up a Getting Started environment for testing the plug-in:
Note: In this example, we will use the International Phone Standardizer enricher to standardize the phone numbers from the Phone1 attribute in the Contact entity. Note that we set the Nullify On Error parameter to false in order to preserve the original phone numbers that cannot be standardized.
To use the enricher in the model:
false
.
Phone1
.
Phone1
attribute and then click
Finish.
To deploy the updated model:
Note: In a development environment only, it is possible to update existing deployment without creating a version of the model edition. In addition, only the integration processes need to be updated, as the data structure is not modified by the addition of the enricher.
To run the enricher:
When you deploy a plugin, it appears in the list of plug-ins with an
Available status and a green icon.
If your plug-in appears with a warning icon, click the
Diagnose button in the
Plug-ins editor toolbar. A dialog appears showing the plug-in issues.
When a plug-in fails to execute in an integration job, the job is suspended, and the error raised by the plug-in is displayed in the job’s execution log.
See the
Managing Execution chapter in the
Semarchy Convergence for MDM Administration Guide for more information about jobs and logs.
To troubleshoot with more details a plug-in behavior at run-time, it is possible activate a logger that traces plugin execution in the application server log files.
To activate this logger:
log4j.logger.com.semarchy.platform.engine.PluginExecution
logger configuration and set it temporarily to
DEBUG
as needed (an example is given below).
log4j.logger.com.semarchy.platform.engine.PluginExecution=DEBUG
Warning! The
DEBUG
mode is very verbose. Make sure to revert the configuration after the troubleshooting phase.
Previous | Top | Next |
Releasing the Plug-in | Appendices |