ToXml(#table)

The ToXml() function takes a reference to a table to be converted to XML. It returns a string.

The table needs to be structured in a specific way for the conversion to be successful:

• There is one element per row.
• The outermost elements begin in the first column.
• Nested elements are one column to the right of their parent element.
• The element tag is first.
• If the element contains a value, the column following the tag contains "=" and the column after that contain the value.
• If the element has attributes, they appear after the value, if present, and take the form of "attributeName=" (the "=" is mandatory) in the next column, with the value of the attribute in the following column.

This can best be demonstrated visually with the image below. On the left, the table #xml contains a simple XML file laid out in cells. On the right is that same XML in the format ToXml() expects. It is generated by calling FromXml() on the concatenated strings in the #xml table. Note the indenting of child elements, the layout of attributes, and how the value of the tag c is represented.

Calling ToXml() with the table generated by FromXml() re-encodes the data in the table back into an XML string. Cells in Planarly do not currently display line breaks, so it is shown as a linear string. The string is now ready to be used in a call to an API or for other purposes.