Page Comparison

local SampleXML = [[
<message>
</message>
]]

There are two methods to adding elements to an existing XML document.

1. With node.append()by providing what you want to create and a name.

X.message:append(xml.ELEMENT,'observation_info')

2. With the XML Library’s node.addElement(), by providing an element name.

X.message:addElement("extra_info")

You should see two new elements added to the XML document in the annotations.

When adding and setting an attribute, you can use the XML library’s node.setAttr() to create and set an attribute in one line:

X.message.extra_info:setAttr("message_id", iguana.messageId())

instead of…

X.message.observation_info:append(xml.ATTRIBUTE,'id') -- add attribute
X.message.observation_info.id:setInner('123')         -- set value

Use node.setText() to create and set text elements.

X.message.extra_info:setText("This is some extra text") 

To add and set CDATA you must use node.append() to specify you are creating a CDATA element and the content to set.

X.message.observation_info:append(xml.CDATA,'Because CDATA is not parsed it allows & and <>')

You can also add an element in s specific location in the XML document using node.insert(), specifying the location, an element node type and the content to set.

X.message:insert(1, xml.ELEMENT, 'first')

Finally, once your XML document is ready, in order to queue it for a downstream component, write it to a file or send it in an HTTP request, it must be serialized as a string!

local XmlString = X:S()