CREATE-NODE-NAMESPACE( ) method

Creates a namespace-aware XML node whose name can be either a single string y or an x:y combination.

Note: To ensure consistency across all nodes in an XML document, use either the CREATE-NODE-NAMESPACE( ) method or the CREATE-NODE( ) method to build an XML document; do not use both methods within a single document.

Syntax
CREATE-NODE-NAMESPACE ( `x-node-handle` , `namespace-uri` , `qualified-name` , `type` )

A character expression representing the namespace Uniform Resource Identifier (URI). The namespace-uri must be unique and persistent. Although the namespace-uri may be an HTTP URL, there is no guarantee that it points to a retrievable resource. It is only a name and care should be taken if you use this name for other purposes.

If the character expression evaluates to either the empty string ("") or the Unknown value (?), no namespace is associated with the element.

A character expression representing the name of the node, optionally qualified with a prefix including a colon (for example, prefix:node-name). Unless you are using a default namespace, a prefix is required and should be set to the prefix specified when you declared the namespace using the xmlns attribute.

The following code fragment illustrates how to create a namespace-aware node in an XML document using either a specific namespace or the default namespace:

. . . /* 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, and 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. . . .

. . . 
/* 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, and 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. 
. . .