Creates a new XML document, initializes the document based on the referenced DTD, and creates its root node.

Return type: LOGICAL

Applies to: X-document object handle

Syntax

INITIALIZE-DOCUMENT-TYPE ( namespace-uri , root-node-name , public-id ,
  system-id )
namespace-uri
A character expression representing the namespace Uniform Resource Identifier (URI) you want associated with the root node of the XML document. The namespace-uri must be unique and persistent.
root-node-name
A character expression representing the name of the root node as defined in the XML document. If you are using namespaces and you want to associate a prefix with the namespace, you must qualify this node name with the namespace-uri and a colon character prefix (for example, namespace-uri:root-node-name). You must explicitly set the xmlns attribute on the root node.
public-id
An optional character expression representing the public ID of the DTD. Currently, there is no way to retrieve a DTD based on a public ID.
system-id
A required character expression representing the system ID of the DTD. This contains the path to the DTD which is either a file system path or an HTTP URL. The ABL parser uses this information to retrieve the DTD when parsing the document.

The following example initializes an X-DOCUMENT with a DTD reference and adds the proper namespace declaration, if the namespace URI is not empty:

DEFINE INPUT  PARAMETER namespaceURI AS CHARACTER NO-UNDO.
DEFINE INPUT  PARAMETER rootNodeName AS CHARACTER NO-UNDO.
DEFINE INPUT  PARAMETER publicId     AS CHARACTER NO-UNDO.
DEFINE INPUT  PARAMETER systemId     AS CHARACTER NO-UNDO.
DEFINE OUTPUT PARAMETER hDocument    AS HANDLE    NO-UNDO.

DEFINE VARIABLE hNsDecl   AS HANDLE  NO-UNDO.
DEFINE VARIABLE hRootNode AS HANDLE  NO-UNDO.
DEFINE VARIABLE errStat   AS LOGICAL NO-UNDO.
DEFINE VARIABLE found     AS INTEGER NO-UNDO.

/* Create X-DOCUMENT and intialize it. */
CREATE X-DOCUMENT hDocument.
errStat = hDocument:INITIALIZE-DOCUMENT-TYPE
  (namespaceURI, rootNodeName, publicId, systemId).
IF NOT errStat THEN DO:
  DELETE OBJECT hDocument.
  LEAVE.
END.

/* If using namespaces, create X-NODEREF for namespace declaration. */
IF LENGTH(namespaceURI) > 0 THEN DO:
  CREATE X-NODEREF hNsDecl.
  CREATE X-NODEREF hRootNode.

  /* Look for a colonized name in rootNodeName. */
  found = INDEX(rootNodeName, ":").
 IF found > 0 THEN DO:
  /* Namespace declarations are special kinds of attributes that belong in
      the http://www.w3.org/2000/xmlns/ namespace.*/
  errStat = hDocument:CREATE-NODE-NAMESPACE(hNsDecl,
   "http://www.w3.org/2000/xmlns/", "xmlns:" + 
   SUBSTRING(rootNodeName, 1, found - 1), "attribute").
 END.
 ELSE DO:
    /* Use the default namespace, which does not need a namespace declaration
       prefix, assign it to the http://www.w3.org/2000/xmlns/ namespace.*/
  errStat = hDocument:CREATE-NODE-NAMESPACE(hNsDecl,
   "http://www.w3.org/2000/xmlns/", "xmlns", "attribute").
 END.
 IF NOT errStat THEN LEAVE.

 /* Set the value of the namespace attribute to the namespace URI. */
 hNsDecl:NODE-VALUE = namespaceURI.

 /* Retrieve the root node and add the namespace declaration to it. */
 errStat = hDocument:GET-DOCUMENT-ELEMENT(hRootNode).
 IF NOT errStat THEN LEAVE.
 errStat = hRootNode:SET-ATTRIBUTE-NODE(hNsDecl).
END.

/* Free up the temporary X-NODEREFS. */
IF VALID-HANDLE(hNsDecl) THEN
 DELETE OBJECT hNsDecl.
IF VALID-HANDLE(hRootNode) THEN
 DELETE OBJECT hRootNode.

/* If an error occurred, free up the X-DOCUMENT. */
IF NOT errStat THEN
 DELETE OBJECT hDocument.