What causes errors during the import process?

During the import process, different kinds of errors are likely to occur at different phases.

Import process

IXIA CCMS processes files in the following phases during an import:

  1. Validate the DITA XML in the files
  2. Validate the references in files
  3. Import the content and check it in

Errors related to file validation

Errors in this phase happen because files are either not well-formed DITA, or their structure does not match the DTDs in IXIA CCMS. If any of the files cannot be validated against the DTDs in IXIA CCMS, the import is canceled and an error message is displayed.

Errors related to reference validation

Errors in this phase happen because files that are referenced are not included in the content uploaded, nor are they already in IXIA CCMS. If any links or references are broken, the import is canceled and an error message is displayed. IXIA CCMS also checks for duplicate IDs and key definitions.
Note: These errors also occur as a consequence of file validation errors. If a file could not be validated against a DTD, it is dropped from the import. Any file that referenced the invalid file is then considered to have a broken link because the invalid file is 'missing'.

These errors resolve themselves once the invalid files are fixed and pass validation.

Errors related to importing

Errors in this phase often happen because of configuration issues or the import process was interrupted. For example, if the configuration for locking and releasing imported files is not properly configured, the new content is not checked in properly after the import.

IXIA CCMS can sometimes detect these errors and try to roll back the import by deleting the imported content. However, this rollback might not completely reverse the import. There is no guarantee IXIA CCMS can return the docbase to its initial state. If the connection is lost during the import process, IXIA CCMS might fail to import the content and then also fail when rolling back the import.

In some cases, IXIA CCMS might not detect any errors. Users might only find the full scope of the errors later.