Use and troubleshoot plug-ins

This page 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 deployment issues

Upon deployment, a plug-in appears in the plug-in list with an Available status and a green icon.

If a warning icon is displayed, click the Diagnose button in the Plug-ins editor toolbar.
A dialog appears showing the plug-in issues.

Troubleshoot execution 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 logged in the job’s execution log.

For more information on jobs and logs, see Manage job execution.

To troubleshoot a plug-in’s behavior more thoroughly at run-time, you can enable a logger that traces plug-in execution in the application server log files. To activate the logger:

  1. In the navigation drawer of the Configuration module, select Logging Configuration.

  2. Adjust the logger level and root logger configuration, temporarily setting it to DEBUG, as illustrated below:

<!-- Root Logger -->
<Root level="DEBUG">
    <AppenderRef ref="PDE"/>
    <AppenderRef ref="CONSOLE"/>
</Root>
.
.
.
<Logger level="DEBUG" name="com.semarchy.platform.engine.PluginExecution"/>

  1. Press Control+S (or Command+S on macOS) to save the updated configuration.

The DEBUG mode is particularly verbose. Remember to restore the configuration to its previous state after the troubleshooting phase.

Disable type-checking

Explicitly declaring the parameters and input/output types, enforces data type checks, including in data entry forms. To disable these checks, configure the following system property for the application server environment:

com.semarchy.engine.disableDataRowenforceType = true