Resolving composition issues

The alwaysDumpIncidentArchive flag can be used to troubleshoot and resolve problems arising from unsuccessful composition of your communications by EngageOne Generate.

When the alwaysDumpIncidentArchive is set to true the following files are created in the incident-archive folder on the active-drive:

  • All template files.
  • All supporting resource files for each template. These are created during Publish for EngageOne processing in EngageOne Designer.

It is important to note that these files are created for both successful and unsuccessful composition; for this reason, setting this flag to true as a default is not recommended.

EngageOne Generate can compose communications either from batch processing requests or via SOAP/UI requests. The alwaysDumpIncidentArchive flag can be used for both types of requests to Generate.

Batch requests to Generate

Depending on the type of batch processing you are working with the alwaysDumpIncidentArchive property must be added to the batch jvm options. Update the appropriate run script, this can be found at:

<engageOneInstallPath>/batch/bin

SOAP/UI requests to Generate

Locate and run eos-compositionw this is found at: <engageOneInstallPath>/composition/bin.

The EngageOne Server composition Service Properties dialog is presented.

Enter -DalwaysDumpIncidentArchive=true in the Java Options entry area.