Contents

# XML Source

Import XML data from arbitrarily structured XML content into cells in an existing spreadsheet document.

The XML Source feature allows XML content to be imported either partially or in full, depending on the structure of the XML content and the map definitions that the user defines. The user can specify multiple non-overlapping sub-structures to be mapped to different cell positions within the same document. The user can import either element contents, attribute values or both.

To access this command...

#### From the menu bar:

Choose Data - XML Source.

#### From the tabbed interface:

Choose Data - XML Source.

#### From toolbars:

XML Source

## XML Source Dialog

The dialog consists of four parts.

### Source file

This lets you specify the path to the XML file that you wish to import into your document.

### Map to Document

This pane shows the structure of the source XML content as a tree. This is initially empty, and gets populated when you specify the source file.

Each element in the tree can be one of three types:

- attribute, represented by the symbol @

- single non-recurring element, represented by the symbol </>, and

- recurring element, represented by the symbol <//>.

A non-recurring element is an element that can only occur once under the same parent. It is mapped to a single cell in the document.

A recurring element is an element that can appear multiple times under the same parent. It serves as an enclosing parent of a single record entry of multiple record entries. These entries are imported into a range those height equals the number of entries plus one additional header row.

### Mapped cell

This field specifies the position of a cell in the document that an element or an attribute is linked to. If it is a non-recurring element or an attribute, it simply points to the cell where the value of the linked element/attribute will get imported. If it is a recurring element, it points to the top-left cell of the range where the whole record entries plus header will get imported.

### Import

Pressing the Import button starts the import process based on the link definitions that the user has provided. Once the import finishes, the dialog will close.

Related Topics

Reading JSON and XML files in LibreOfficeDev Calc

Wiki page on XML Source

Please support us!