XML File Data Source
You can use an XML file as a data source for templating. XML file must be well-formed and have one root element.
The system reads your data as a set of rows (read more here: Data Sources). However, for the XML format system always threats all document's structure as one data row. We use simplified XML parsing rules and don't support XML Schema:
- If a tag contains a simple value and doesn't contain other tags, then the value will be treated as a primitive string, number, boolean or ISO 8601 date.
If a tag contains other tags, then there could an ambiguous situation.
<?xml version="1.0" encoding="UTF-8"?> <root> <elem1> <nested>value</nested> </elem1> </root>
elem1tag can be either a list with one element or an entity with just one field. At the moment, this situation is always resolved into the entity with one field.
If a tag contains attributes then it is always treated as an entity with fields. Also, the attributes will be joined with nested tags containing values, that is, it will be one set of named values.
<?xml version="1.0" encoding="UTF-8"?> <root> <object1 attrProp1="value1"> <tagProp1>value2</tagProp1> <tagProp2>value3</tagProp2> </object1> </root>
Will be parsed into entity:
object1: attrProp1: value1, tagProp1: value2, tagProp2: value3
- If a tag has attributes, but contains only simple value and doesn't contain other tags, then it is parsed
into an entity with fields anyway. Also, it's simple value will be accessible through
<?xml version="1.0" encoding="UTF-8"?> <root> <object1 attrProp1="value1">value2</object1> </root>
Here is an example of an XML data file:data.xml