Script Functions for XML Elements

XML (Extensible Markup Language) contains information wrapped in tags to store and transport data. For example, in Automic Automation, you can create XML documents by exporting object data. The following script functions can handle, read or modify values stored in XML documents. The source of an XML document in Automic Automation can be Structured Documentation, the report of an SAP job, or an XML string.

Note: The XML parser used for the XML script functions supports XML values with UTF-8 characters. It supports UTF-8 for tag names, attribute names, and their values.

Example:

<xml_tag1>
<xml_tag2 xml_attribute1="attribute-value">any xml value</xml_tag2>
</xml_tag1>

 

• XML_APPEND_BEFORE
  Moves an XML element before another element

• XML_APPEND_CHILD
  Adds a new sub-element to an XML element

• XML_APPEND_CLONE
  Duplicates an XML element and attaches it to another element

• XML_APPEND_ELEMENT
  Attaches an existing XML element to another element

• XML_BEAUTIFY
  Structures and formats an XML document

• XML_CLONE_AND_RENAME
  Duplicates and renames an XML element

• :XML_CLOSE
  Closes an XML document

• XML_DELETE_NODE
  Removes a specific XML element

• XML_GET_ATTRIBUTE
  Retrieves the value of an element's attribute

• XML_GET_CHILD_COUNT
  Counts the sub-elements of an element

• XML_GET_FIRST_CHILD
  Identifies the first sub-element of an element

• XML_GET_LAST_CHILD 
  Identifies the last sub-element of an element

• XML_GET_NEXTSIBLING
  Identifies the succeeding element

• XML_GET_NODE_NAME
  Retrieves the name of an element

• XML_GET_NODE_TEXT
  Retrieves the text of an element

• XML_INSERT_BEFORE
  Creates a new XML element and inserts the new element before another element

• XML_OPEN
  Opens an XML document for processing

• XML_PRINTINTOFILE
  Writes the XML document in a file

• XML_REMOVE_CHILDREN
  Removes all the sub-elements of an XML element

• XML_SELECT_NODE
  Identifies an element

• XML_SET_ATTRIBUTE
  Adds a new attribute to an XML element or changes an existing attribute

• XML_SET_NODE_TEXT
  Changes or sets the value of an XML element

• XML_TO_STRING
  Returns the XML of a specific element as text