Use and Troubleshoot your Plug-ins
This document explains how to use and troubleshoot plug-ins developed for Semarchy xDM.
When you deploy a plug-in, 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 Manage Job Execution 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 plug-in execution in the application server log files.
To activate this logger:
Open the Logging Configuration in the Administration view (in the Administration Console perspective).
Add or modify the
log4j.logger.com.semarchy.platform.engine.PluginExecutionlogger configuration and set it temporarily to
DEBUGas needed (an example is given below).
Press CTRL-S to save the new configuration.
DEBUG mode is very verbose. Make sure to revert the configuration after the troubleshooting phase.
With the explicit declaration of the parameters and input/output types, checks are enforced on the data types, including in Data Entry forms. To disable such checks, set the following system property for the application server environment:
com.semarchy.engine.disableDataRowenforceType = true