From bd71cddd5c343dc894e78bb9809acb94ca1db337 Mon Sep 17 00:00:00 2001 From: Olivier Hallot Date: Tue, 20 Mar 2018 10:42:46 -0300 Subject: tdf#80367 Help page for Calc XML Source With contribution of Kohei, from https://wiki.documentfoundation.org/Development/Calc/XMLSource Change-Id: I363f864069cf42c0893ceb1402f26c9c1dc186a5 Reviewed-on: https://gerrit.libreoffice.org/51645 Reviewed-by: Olivier Hallot Tested-by: Olivier Hallot --- source/text/scalc/01/xml_source.xhp | 122 ++++++++++++++++++++++-------------- 1 file changed, 75 insertions(+), 47 deletions(-) (limited to 'source/text/scalc/01') diff --git a/source/text/scalc/01/xml_source.xhp b/source/text/scalc/01/xml_source.xhp index 665dc92cf4..762a8564db 100644 --- a/source/text/scalc/01/xml_source.xhp +++ b/source/text/scalc/01/xml_source.xhp @@ -1,52 +1,80 @@ - - - - - Live Data Stream - /text/scalc/01/xml_source.xhp - - - - - - -
- - - XML Source;load XML data in spreadsheets - - - -XML Source -Live data stream for spreadsheets -
- -
-Menu Data – XML Source... -
- - -
-XML Source -
+ + + + + XML Data + /text/scalc/01/xml_source.xhp + + + + +
+ + + XML Source;load XML data in spreadsheets + + XML Source + Import XML data in a spreadsheet. +
+ The XML Source feature allows to import data from arbitrarily structured XML content into cells in an existing spreadsheet document. It 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. + +
+ Menu Data – XML Source... +
+ XML Source Dialog + 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's 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's 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. +
+ Wiki page on XML Source +
-- cgit