WikiTraccs 1.30.25
Table Revamp Release
This release includes two major improvements to table transformations: allowing nested tables, and table size optimization.
Adding Support for Nested Tables
Nesting tables will declutter pages with lots of small nested tables. WikiTraccs will keep those nested, while still denesting large nested tables that wouldn’t fit the SharePoint page. Since table nesting is not available to end users (in the SharePoint page browser editor), it is bound to the “Use non-standard table transformations” setting, which is on by default.
I made some noise on LinkedIn about creating nested tables in SharePoint and tagged Microsoft people from the pages-related product group. There was no backlash, only open ears. Also, when copying nested tables from Word to SharePoint, they’ll survive. Based on this - and extensive testing - I conclude that nested tables are OK to create.
Optimizing Table Sizes
Table size optimization renders each table in a real browser as only the browser “knows” how wide each table column is. WikiTraccs builds on and expands its browser automation capabilities which are already used (mainly) for interactive Confluence login, draw.io preview image generation, and whiteboard export.
This new feature is on by default, but can be switched off in the WikiTraccs settings.
Note: this feature needs Chrome and might not work in locked-down environments.
Troubleshooting Note
Since table size optimization required hardening the browser automation core of WikiTraccs, it potentially affects interactive Confluence login, draw.io preview image generation, whiteboard export (Confluence Cloud), the browser-based proxy mode, and Jira data card transformation (Confluence Cloud). If you see any issues, like a hanging migration or browser-related error messages in the console, please report them. At the moment, browser-related logging is extensive to early spot any issues.
At the moment, the browser for table size optimization will be visible. While the browser renders your tables, you can watch. This might change in the future, as the browser window could also be hidden. It will also auto-close after about half a minute of inactivity, and pop up again if there is something to do.
Prerelease Evolution
1.30.5
- new: adding support for nested tables
- new: adding table size optimization
- new: downloading attachments using alternative endpoint since some endpoints got deprecated by Atlassian (Cloud, only with token-based authentication)
- improvement: adding additional hard link formats for Confluence v9 and up (this should fix link transformation for children display and page tree macro)
- improvement: beautifying the status macro
- improvement: retaining more colors when transforming Aura panels
- improvement: logging hygiene (reducing the output of some larger operations)
- improvement: adding logout detection to browser-based proxy mode
- improvement: numbering column width in Confluence Cloud (was way too wide)
- improvement: decoupling merged table cells and cell colors from the “non-standard table transformation” setting, as it is now supported
- improvement: skipping Jira issue type images when migrating
- fix: storing page content snapshot to SharePoint could fail
- fix: tiny link parsing for very high page numbers
- fix: macro count metric was off for macros in Excerpt Include macros
1.30.5 → 1.30.13
- new: Aura Inline button macro conversion (Cloud)
- improvement: info/warning/etc panels are back to 100% width when using table size optimization
- improvement: slightly larger padding above info/warning/panel text when contained in colored table; looks better
- improvement: browser for table transformation does only open when there is a table on the page
- retired: two settings are being retired
- switching back to the old pre-2024 SharePoint page format, and
- using the Confluence Cloud v1 API (which has been deprecated by Atlassian)
- fix: tables will now be kept nested by default when “non-standard table transformation” setting is checked; was still decoupled and disabled
- fix: table transformation issue with old SharePoint page format (CK4) and nested tables; table nesting is now only active in the new page format (CK5), which is the default
- fix: two fields of the Site Assets library (that were introduced in the previous v1.29 release) are created with the wrong internal name; this release detects and fixes those fields
- affected fields:
- before the fix, clicking those fields and looking at the address bar of your browser shows either
Field=Confluence_x003a__x0020_Labels_x0020__x0028_WikiTraccs_x0029_orField=Confluence_x003a__x0020_File_x0020_Comment_x0020__x0028_WikiTraccs_x0029_, which needs to be corrected - those two fields will be deleted and recreated with their correct internal names
WT_In_CfLabelsandWT_In_CfSimpleComment - no data is lost when recreating the fields, as no data could be stored in the first place
- affected fields:
- fix: WikiTraccs sometimes prepares a migration target site multiple times because it misinterprets display name mismatches for otherwise correctly provisioned fields
- fix: WikiTraccs fails to re-add manually deleted fields to the Site Pages library; this has been fixed
1.30.13 → 1.30.16
- new: documenting the different table-related settings that were added; adding links to those in the settings dialog
- new: settings to control browser-based table size optimization
- always show automated browser windows
- always hide automated browser windows
- skip table size optimization
- improvement: adding informational panels to the browser windows that are controlled by WikiTraccs, so you know why they’re there
1.30.16 → 1.30.17
- improvement: making status macro font size smaller
- fix: retrieving non-page additional root nodes in Confluence Cloud on personal spaces and spaces with space keys that start with number
1.30.17 → 1.30.18
- new (Confluence Cloud): adding support for 3-column layouts with sidebar, as well as 4- and 5-column layouts
- since SharePoint does only support a maximum of three columns, additional columns will overflow to a new section for 4- and 5-column Confluence layouts
- improved: log output when license file cannot be processed
1.30.18 → 1.30.22
- new: troubleshooting setting to save page provisioning template to disk
- improved: logging and error handling for pages that end up being empty for (yet) unknown reason (note: those are marked by Failed Transformation count 9001)
- improved: transformation of space links linking to non-existing personal spaces
- those personal space links were counted in the page’s Failed Transformation metric since no mapping entry in the Space Inventory list could be found; but that is overkill as it is not really a relevant error to fix
- now those links are treated like user mentions and don’t count as Failed Transformation anymore; here a sample, showing a head symbol instead of a note about an unresolvable space:
- improved: error handling for image downloads blocked by proxy with 403 Forbidden
- improved: error handling for failed user mention transformations
- fix: out of bounds error when downloading Communardo metadata plugin data for very large page IDs
1.30.22 → 1.30.23
- improved: scenarios observed “in the wild”
- adding status log during transformation of large tables (> 500 rows)
- preventing needless retries when hitting page size limit of 2 MB
- optimizing page creation to allow ~33% bigger pages
- not counting missing space mapping as “Failed Transformation” anymore
- not counting “at:declarations” tag in page as “Failed Transformation” anymore
1.30.23 → 1.30.25 (released: 2025-11-06)
- improved: hard link transformation speed if multiple links point to the same target page
- improved: keeping WarningsAndErrors log file cleaner and free from common duplicates, to make it easier to analyze
- improved: transformation of empty content report macro (no placeholder anymore)
- fixed: link transformation was missing for attachment macro when configured to show attachments from different page
- fixed: very long content URLs didn’t fit in field of Content Snapshots list (mainly happening for encoded URLs in languages like Chinese or Russian)
- fixed: invalid characters in attachment comment can prevent page transformation (e.g. “vertical tab” character)
- fixed: fixed-width tables became non-fixed when table optimization is enabled
- fixed: some pre-existing table border styles can prevent page transformation