Ready for review

Convert the Live Data Exporter Application documentation

Last modified by Michael Hamann (non-admin) on 2026/11/12 17:46

Moves the documentation of the Live Data Exporter Application from its extensions.xwiki.org page into the new documentation tree (a topic Explanation and an Export Live Data to CSV How-to).

Companion of the change request https://www.xwiki.org/xwiki/bin/view/ChangeRequest/Data/convert-live-data-exporter--ad0ef4dc-e6ad-4690-88c4-1a6ceab4babc/: merge them together.

All changes

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.ThomasMortagne
1 +xwiki:XWiki.MichaelHamannNoAdmin
Default language
... ... @@ -1,0 +1,1 @@
1 +en
ExtensionCode.ExtensionClass[0]
Description
... ... @@ -1,25 +1,5 @@
1 -The Live Data exporter application allows exporting any [[Live Data>>Extension.Live Data.Macro.WebHome]] to CSV.
1 +See [[Live Data Exporter>>xwiki:documentation.extensions.user.livedata-exporter.WebHome]].
2 2  
3 -Currently supported features:
3 += Usage =
4 4  
5 -* Export of all Live Data instances to CSV.
6 -* Column ordering and visibility as configured in the displayed Live Data are respected.
7 -* Filters and sorting are respected.
8 -* Multiple exports can be created for a single Live Data, e.g., to export differently filtered data.
9 -* The selected properties, filters and sorting orders are displayed for each export.
10 -* The export is done as a background job which should allow for large exports without timeouts, the progress is displayed in the UI.
11 -* Exports are only accessible for the current user (even with a direct link).
12 -* Exports are stored as temporary files on the server that are deleted after 8 hours or on user request.
13 -
14 -Limitations:
15 -
16 -* All columns are exported as-is in plain text, meaning that for example columns that contain HTML content are exported as HTML in the CSV.
17 -* Exports cannot be accessed after the page has been left or reloaded (or, in other words, you need to stay on the page until the export has been finished).
18 -* Progress display and error handling is basic and might need to be extended.
19 -* Only CSV format is currently supported but support for other formats can be implemented.
20 -
21 -== Usage ==
22 -
23 -The export can be started by clicking on the "Export…" item in the menu at the top right of a Live Data instance ((1) in the screenshot below). This opens a new panel at the top of the Live Data instance ((2) in the screenshot below). In this panel, there is a "Start Export" button ((3) in the screenshot below). Clicking it starts an export with the current configuration as shown in the screenshot. A progress bar is displayed at the bottom of it. After the export has finished (progress bar reached the right end), the "Download" button ((4) in the screenshot below) is enabled and can be clicked to download the exported CSV file. A "Delete" button ((4) in the screenshot below) can be clicked to delete the export on the server (and in the list of exports). While the export is still running, the button is named "Cancel" and cancels the running export in addition to deleting it. In version 1.0, the button always had the "Delete" label but had the same behavior.
24 -
25 -{{image reference="2022-06-01-LiveData-Exporter-with-boxes.png" width="650px"/}}
5 +See [[Export Live Data to CSV>>xwiki:documentation.extensions.user.livedata-exporter.export-live-data-csv.WebHome]].
Website
... ... @@ -1,0 +1,1 @@
1 +https://www.xwiki.org/xwiki/bin/view/DocApp/Code/ExtensionLD?id=xwiki:org.xwiki.contrib:application-livedata-exporter-ui&name=%22Live%20Data%20Exporter%20Application%22

Approvers

Approvers have not been explicitly defined for this Change Request. Approvers will be based entirely on approval rights.
This Change Request is ready for review.
No conflicts to show.
The change request cannot be published without valid approval or if at least one review request for changes.

Get Connected