Use and troubleshoot plugins

This page explains how to use and troubleshoot plugins developed for Semarchy xDM.

Use plugins

Plugins designed with the plugin architecture can be used as regular plugins.

Troubleshoot plugins

Troubleshoot deployment issues

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

If a warning icon is displayed, click the Diagnose button in the Plugins editor toolbar.
A dialog appears showing the plugin issues.

Troubleshoot execution issues

When a plugin fails to execute in an integration job, the job is suspended, and the error raised by the plugin is logged in the job’s execution log.

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

To troubleshoot a plugin’s behavior more thoroughly at run-time, you can enable a logger that traces plugin 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