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 logger configuration and set it temporarily to DEBUG as needed (an example is given below).

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

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