JavaScript method: XML.getQualifiedName()

This method returns a string representing the name of the current element or attribute, including any namespace value. You must use the other XML get methods to navigate through an XML document.

Syntax

XML.getQualifiedName();

Arguments

There are no arguments for this method.

Return values

A string or null.

The method returns a string representing the name of the current element or attribute. It returns null if the current node has no name.

Example

This example displays the qualified names of the elements and attributes in an XML document.

This example requires the following sample data:

  • A local XML file (for example, C:\namespace.xml which contains <?xml version="1.0" encoding="UTF-8" standalone="yes" ?><document xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:ns="http://servicemanager.hp.com/PWS"><http:element1 /><ns:element2 /></document>)
/* Create variables to store XML objects and strings.
*  Use XMLObject to store a valid XML object such as an XML file.
*  The script assigns values to the empty variables later on */
var XMLFile = new XML();
XMLFile = XMLFile.setContent( "C:\\namespace.xml", true );
var XMLSource;

function nsXMLWalk( elem )
{
 print( "Element " + elem.getQualifiedName() );
 var node = elem.getFirstAttribute();
 while( node != null )
 {
   var attrName  = node.getQualifiedName();
   var attrValue = node.getNodeValue();
   print( "Attribute " + attrName + " = " + attrValue );
   node = elem.getNextAttribute();
 }
 var nodeValue = elem.getNodeValue();
 if ( typeof nodeValue == "string" && nodeValue.length > 0 )
 {
  print( "Element value of " + elem.getQualifiedName() + " is: " + nodeValue );
 }

 var child = elem.getFirstChildElement();
 while( child != null )
 {
   var nodeName  = child.getQualifiedName();
   var nodeValue = child.getNodeValue();
   nsXMLWalk( child );
   child = child.getNextSiblingElement();
 }
}

function walkXML( elem )
{
 print( "Element " + elem.getName() );
 var node = elem.getFirstAttribute();
 while( node != null )
 {
   var attrName  = node.getName();
   var attrValue = node.getNodeValue();
   print( "Attribute " + attrName + " = " + attrValue );
   node = elem.getNextAttribute();
 }
 var nodeValue = elem.getNodeValue();
 if ( typeof nodeValue == "string" && nodeValue.length > 0 )
 {
  print( "Element value of " + elem.getName() + " is: " + nodeValue );
 }

 var child = elem.getFirstChildElement();
 while( child != null )
 {
   var nodeName  = child.getName();
   var nodeValue = child.getNodeValue();
   walkXML( child );
   child = child.getNextSiblingElement();
 }
}

print( "Now printing the structure of an XML file with qualified names...\n" );
XMLSource = XMLFile
nsXMLWalk( XMLSource );

print( "Now printing the structure of an XML file without qualified names...\n" );
XMLSource = XMLFile
walkXML( XMLSource );