WikiTraccs 1.21.10
WikiTraccs switches to Confluence Cloud REST API v2 (mandatory as of December 2, 2024)
Note: This topic is only relevant when migrating from Confluence Cloud. Confluence Server and Data Center are not affected.
WikiTraccs switches over from Confluence REST API v1 (“on-prem API”) to v2 (“cloud API”) which is a pretty big change (#118). Atlassian is removing critical v1 endpoints on Dec 2, 2024 and forces app vendors to use v2, although this new version requires significantly more API calls (which makes it slower) and is more cumbersome to use.
WikiTraccs has been undergoing intensive v2 adjustment and testing over the the last couple of months. So far it used mainly v1 endpoints but now switches to v2.
Ideally, there should be no differences for users of WikiTraccs.
Here’s the announcement in the blog: WikiTraccs switches to Confluence Cloud v2 REST API.
WikiTraccs brings the margins back to text web parts
SharePoint pages are now created in a way that brings the margins back to text web parts.
Some time in 2024 Microsoft changed something in text web parts. Margins between paragraphs disappeared gradually. Now the margins are nearly always missing, making paragraphs of text stick together more than they should. You’ll notice that with pages migrated so far. The margins can be brought back by editing the pages and changing the style from “No spacing” to “Normal”.
From now on, WikiTraccs sets a flag on pages it creates that brings the margins back by default, although they are a bit larger compared to manually created pages. This has technical reasons and will be tackled in a future release.
Only if you don’t want the margins back, you activate the old behavior with the following configuration in appsettings.json
:
{
"CustomSettings": {
"Features": {
"GlobalRichTextStylingVersion": 1
}
}
}
Other Improvements
Confluence On-premises & Cloud
- improved: SharePoint pages now have their First Published Date set, as well as the Author; this makes migrated Confluence blog posts appear at the right place in news web parts (previously they would show up as new)
- the First Published Date is set to the Confluence page creation time
- the Publisher is set to the creator of the Confluence page
- the change should also be noticeable in the SharePoint page header, when using a SharePoint page template that shows this information
- improved: attachments that are reported as “not found” by Confluence when downloading (although they are listed as page attachment) are now logged as transformation error
- fix: handling of attachments where the name only differs by Unicode Normalization Form; WikiTraccs renames the quasi-duplicates because SharePoint doesn’t support that; also, a transformation error will be logged
Confluence Cloud
- fix: nested task list items could be missing after transformation since the task list format changed in Confluence Cloud; affected SharePoint pages can be identified by the “Text Transferred Percent” metric being below 100
- fix: pages with empty title now migrate properly; the page file name will contain the word “MISSINGTITLEMARKER” where the title usually is located (so far I know of one confirmed case of a page with empty title)
- fix: looking up the target space id for a link could return a wrong one if the target space doesn’t exist
- fix: a link to a database or whiteboard could prevent page creation
- fix: enhanced user profile macro transformation now also recognizes user account IDs