JavaScript object: XML

The following JavaScript object is unique to ITSMA Service Management.

The XML() constructor creates an empty XML object where you can store and manipulate XML documents.

This object's methods do not use the Service Management-defined global return codes.

Constructor

new XML();

Arguments

None

Properties

None

Methods

The following methods are valid for this object:

Defined method Description
setContent Creates an XML document from a string or file.
getParentNode Returns an XML object representing the parent node of the current node.
getFirstChildElement Returns an XML object representing the first child node of the current node.
getNextSiblingElement Returns an XML object representing the next node at the same level in the Document Object Model (DOM) tree as the current node.
getFirstAttribute Returns an XML object representing the first attribute of the current node.
getNextAttribute Returns an XML object representing the next attribute of the current node.
getNodeName Returns a string representing the name of the current element or attribute.
getName Returns a string representing the name of the current element or attribute.
getQualifiedName Returns a string representing the name of the current element or attribute including any namespace value.
getPrefix Returns a string representing the namespace value of the current element or attribute.
getNodeValue Returns a string representing the value of the current element.
getValue Returns a string representing the value of the current element.
setNodeValue Adds or updates the value of the current element.
setValue Adds or updates the value of the current element.
getNodeType Evaluates an XML object and returns an integer representing the XML DOM type of the current element or attribute.
isDocumentElement Returns true if the current element is the DOM document element.
getDocumentElement Creates an XML object containing the document element and all child elements from an XML object or XML string.
createNode Creates an XML node from an XML object.
appendNode Inserts an XML node into an XML object.
importNode Copies an XML node from one XML document to another.
addAttribute Inserts an XML attribute and attribute value into the current element.
getAttributeNode Returns an XML object containing an attribute node.
getAttributeValue Returns the value of the target attribute.
setAttributeValue Adds or updates an attribute value.
addElement Inserts an XML element as a child of the current element.
setText Adds or updates the value of the current element.
getText Returns a string representing the value of the current element.
toXMLString Converts an XML object into a valid XML string.
removeAttribute emoves an XML attribute from the current element.

Example

This example does the following:

  • Creates an XML object
  • Sets the content of the XML object to a local XML file

This example requires the following sample data:

  • A local XML file (for example, C:\test.xml which contains <document><parent1><child1 attribute1="a" /><child2 /></parent1><parent2><child3 /><child4 /></parent2></document>)
/* Instantiate an empty XML object */
var xmlObj = new XML();

/* Instantiate a variable containing the path to an XML file */
var xmlFile = "C:\\myxmldoc.xml";

/* Use setContent to make the XML object read and parse the XML file
*  If the setContent method fails, print an error message */
if ( ! xmlObj.setContent( xmlFile, true ) )
{
  print( "setContent failed. Unable to parse xml: " + xmlFile );
}