XML Parser and DOM Tree Library/en

Introduction

This library contains action blocks to read and manipulate XML documents.

Library Reference

Parsing

• XMLDocument [ From File ]
  reads XML from a file and provides a DOM tree, representing that document
• XMLDocument [ From Stream ]
  reads XML from a stream and provides a DOM tree, representing that document
• XMLDocument [ From Stream ]
  reads XML from a string and provides a DOM tree, representing that document

Printing

• Convert [ XMLDocument-to-String ]
  Generates a printed string representation from a DOM tree.

Element Extraction

• XML [ Get Root Element ]
  retrieves the root element of a DOM document

• XML [ Get Sub Elements ]
  retrieves the direct DOM child elements from a given DOM element
• XML [ Get Sub Elements Recursive ]
  retrieves all DOM child elements (recursively) of a given DOM element
• XML [ Enumerate Sub Elements ]
  enumerates the direct child elements of a given element
• XML [ Enumerate Sub Elements Recursive ]
  enumerates all child elements (recursively) of a given element
• XML [ Find Sub Elements ]
  Find the immediate subelements of a given element by tag or attribute
• XML [ Find Sub Elements Recursive ]
  Enumerates all subelements of a given element by tag or attribute.

• XML [ Get CData Collection ]
  Retrieves all of an element's CDATA.
• XML [ Get CData Collection ]
  Retrieves an element's single CDATA.

• XML [ Get Attribute Keys ]
  Retrieves an element's attribute names.
• XML [ Get Attribute Value ]
  Retrieves an element's single attribute value.
• XML [ Compare Attribute Value ]
  Compare an element's attribute. Return a boolean.
• XML [ Check for Attribute Value ]
  Compare an element's attribute. Two-way output.

• XML [ Get Tag ]
  Retrieves an element's tag.
• XML [ Set Tag ]
  Changes an element's tag.

XPath Access

• XMLDocument [ XPath Get Element Set ]
  Retrieve a set of matching elements, given an XPath match expression.
• XMLDocument [ XPath Get Element ]
  Retrieve a single matching element, given an XPath match expression.
• XMLDocument [ XPath Get Element CDATA ]
  Retrieve a single matching element's CDATA, given an XPath match expression.
• XMLDocument [ XPath Get Element nonEmpty CDATA ]
  Retrieve a single matching element's non-empty CDATA, given an XPath match expression.
• XMLDocument [ XPath Set Element ]
  Changes a single matching element, given an XPath match expression.
• XMLDocument [ XPath Set Element CDATA ]
  Changes a single matching element's CDATA, given an XPath match expression.

XML Inspector

• XMLDocument [ Inspect DOM ]
  Opens a graphical inspector on a DOM tree
• XMLDocument [ Inspect CML String ]
  Opens a graphical inspector on a parsed XML string

Examples

Example 1

Fetch an XML document (using HTTP) and extract some value from it. In this example, a document containing ISO standard currency codes is retrieved, and the data of a currency is retrieved.

Both an example using action blocks from the standard library and an example using JavaScript elementary code is presented (the later for interested readers - you are not required to do any programming to solve this task).

---

Copyright © 2014-2024 eXept Software AG