Use and Troubleshoot your Plug-ins

This document explains how to use and troubleshoot plug-ins developed for Semarchy xDM.

Use Plug-ins

Plug-ins designed with the Plug-in Architecture can be used as regular plug-ins.

Troubleshoot Plug-ins

Troubleshoot the Deployment

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.

Troubleshoot the Execution

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:

  1. Open the Logging Configuration in the Administration view (in the Administration Console perspective).

  2. Add or modify the log4j.logger.com.semarchy.platform.engine.PluginExecution logger configuration and set it temporarily to DEBUG as needed (an example is given below).

  3. Press CTRL-S to save the new configuration.

log4j.logger.com.semarchy.platform.engine.PluginExecution=DEBUG

The DEBUG mode is very verbose. Make sure to revert the configuration after the troubleshooting phase.

Disable Type Checking

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