Data Transformation Engine XML Adapter Reference Guide

Chapter 6 - XML DTD Importer Tips for Using the XML DTD Importer (pre 6.7)

XML Data Adapter Reference Guide

Tips for Using the XML DTD Importer (pre 6.7)

The XML DTD Importer uses a particular process for identifying the name of the

root element for the document based on several factors. The following describes

this process:

♦ The importer checks to see if there is an element in the DTD that corresponds

to the name of the DTD file itself.

! If one exists, it is used as the root.

! If one does not exist, the importer builds a list of those elements that are

not referenced by any other element.

! If the list contains a single element, that element is used as the root.

! If the list contains more than one element, the first element in the list is

used as the root. The importer displays the list of possible root types

along with the following message:

warning: Cannot FIND a root element

! If there are no elements in the list, the

UnableToIdentifyRootElement_NeedToChangeManually element

is used as the root element.

Note See Error and Warning Messages (pre 6.7)for information on warning

messages.

♦ A DTD that uses the ENTITY tag to reference definitions in other DTD files will

not import using the importer.

Error and Warning Messages (pre 6.7)

When the XML DTD Importer is unable to identify the root element of the DTD,

errors will occur while importing a .dtd file in the Importer Wizard and then in

the Type Designer when analyzing the newly created type tree.

The following warning can occur while importing a .dtd file in the XML DTD

Importer:

warning: Cannot FIND a root element.

When the root element cannot be identified, the following error code occurs during

type tree analysis:

L186 Type of COMPONENT does not exist – ‘type name’ in

TYPE: ‘type name’