Migrate a Live Table to Live Data
Last modified by Eleni Cojocariu on 2026/09/12 12:02
Steps
Replace a live table instance by a Live Data, reusing the results page the live table already reads.
- Open the page holding the live table, to see the list it displays before changing anything.
- Add useLiveData=true to the query string of that URL, to see the same live table rendered as a Live Data without touching the page.
- Replace the livetable Macro call by a liveData Macro call whose source is liveTable, moving className, resultPage, queryFilters and translationPrefix into the sourceParameters query string, and the columns into properties.
- Set template instead of resultPage if the results came from a Velocity template, named in the xpage query string of the live table url configuration.
- Convert the extraParams entries used for filtering into the filters Macro parameter, and move the rest into sourceParameters.
- Save the page and check every converted filter. The list is displayed as a Live Data, as follows:
The results page itself needs no change, which is what makes the migration a rewrite of the Macro call only. The filters are worth checking one by one because a source parameter passed straight through is not guaranteed to have the same effect on a Live Data as it had on a live table.
FAQ
Why is extraParams not supported as such?
Because its main use is filtering, and a Live Data expresses filters generically through the filters Macro parameter, which every source honours.
Do I have to rewrite my live table results page?
No. The liveTable source reads it as it is, which is what makes the migration a rewrite of the Macro call only.
A property was rendered differently by the live table. How do I get the same rendering?
By setting the displayer of that property in the Macro content, as described in Live Data Configuration.
