Troubleshooting DITA Transformation Errors

If a DITA transformation results in errors or warnings, the information is displayed in the message panel at the bottom of the editor. The information includes the severity, description of the problem, the name of the resource, and the path of the resource.

To help prevent and solve DITA transformation problems, follow these steps:
  1. Validate the DITA map by using the Validate and Check for Completeness action that is available on the DITA Maps Manager toolbar and in the DITA Maps menu.
  2. If this action results in validation errors, solve them prior to executing the transformation. Also, you should pay attention to the warning messages because they may identify problems in the transformation.
  3. Execute the DITA transformation scenario.
  4. If the transformation results in errors or warnings, they are displayed in the Transformation problems message panel at the bottom of the editor. The following information is presented to help you troubleshoot the problems:
    • Severity - The first column displays the following icons that indicate the severity of the problem:
      • Informational - The transformation encountered a condition of which you should be aware.
      • Warning - The transformation encountered a problem that should be corrected.
      • Error - The transformation encountered a more severe problem, and the output is affected or cannot be generated.
    • Info - You can click on the See More icon to open a web page that contains details about DITA-OT error messages.
    • Description - A description of the problem.
    • Resource - The name of the transformation resource.
    • System ID - The path of the transformation resource.
  5. Use this information or other resources from the online DITA-OT community to solve the transformation problems before re-executing the transformation scenario.