Releases: WikiTransformationProject/wikitraccs-releases
WikiTraccs 1.13.1
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD LATEST RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
- fixed: certain empty tables could prevent pages from being transformed; those are now removed from the page
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs 1.13.0
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD LATEST RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
- new: downloading of external images (like: not stored in Confluence) can be disabled in the settings; if disabled, those images will be transformed to links
- fix: some progress bars went missing in the prerelease; those are back
- fix: fixed a rare race condition when choosing migration target sites
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs 1.12.29
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
- new: adding SharePoint page modification time to "25" progress log file
- improved: page migration speed
- improvement: working around time zone issues that can affect the "25" progress log file, marking up-to-date pages as changed; differences that can be attributed to time zones being off are now detected and ignored
- improvement: adding consistency check to check for large file uploads that were interrupted by Microsoft throttling
- improvement: consolidating local file storage locations; those are now documented here in detail: File Storage
- fixed: when page restrictions are narrowed down in the hierarchy of pages, dropped users and groups were not removed from the child pages
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs 1.12.16
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD LATEST RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
- new: signed WikiTraccs binaries
- new: checksum file in release package
- improvement: adding additional logging to permission migration to better diagnose edge cases
- fix: WikiTraccs could stop scheduling migration targets when accessing one target site fails; scheduling will now continue
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs 1.12.6 (Prerelease)
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD LATEST RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
Permission Migration Improvements
More cases are covered where WikiTraccs would previously give up, mainly in complex permission hierarchies.
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs 1.12.5
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD LATEST RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
Google Endpoint Fix
Time for Google's once a year change of endpoints. WikiTraccs has been adjusted to handle those.
Permission Migration Improvements
- new: in a hierarchy of restricted pages, when the principals of a parent page are not all mapped, the principals that are mapped will be inherited by the child pages (within narrow boundaries)
- improvement: hardened permission retrieval against connection losses
- improvement: when permissions cannot (fully) be applied to a SharePoint page (e.g. due to missing user mapping) permission inheritance for the SharePoint page will be broken nevertheless
- improvement: better indication when being throttled by Microsoft (in the console and log file)
- fix: reverted connection timeout back and increased to 600 seconds as it otherwise interferes with throttled requests
Verification Mode
This release introduces the mode Verify page contents.
When running in verification mode WikiTraccs will go over all migrated SharePoint pages, pull the corresponding original pages from Confluence, and compare contents. This creates updated progress log files.
WikiTraccs will check the following things:
- check each code snippet web part for invalid characters in the backing CanvasContent1 list item field
- check if the Confluence page contains words that are missing in the SharePoint page
The results will be stored in the "25" progress log file.
In the progress log file, each page entry will get an additional state indicator that is one of the following values:
- skippedverify - did not check a page; this is the state for the progress log file that is created when starting the verification run
- verified - checked a page and found nothing of interest
- worddiff - the Confluence page contains words that are not present in the SharePoint page
- invalidcodesnippetchars - a code snippet web part contains invalid characters in the CanvasContent1 field of the page list item
But why?
The reason for the introduction of the verification mode is an incident where pages seemed broken due to invalid characters in the backing field of the page. Note that several weeks had passed since the migration.
The content of a SharePoint page is stored in a list item field called CanvasContent1, in the Site Pages library. It is HTML which needs to adhere to certain rules. One rule is, that special characters like < and > need to be encoded properly. WikiTraccs does this since its inception in 2022. Nevertheless, something changed this content for some pages with HTML code snippet web parts to contain raw < and >. That made page rendering stop there.
The verification run checks for invalid characters in the backing CanvasContent1 field and highlights the affected pages in the progress log files. An easy solution is to delete and remigrate them.
Before recognizing that page content is simply not shown we assumed that page content had gone missing, which would be a blocker (and at the same time nearly impossible, since WikiTraccs already verifies the character count of transformed pages at the time of migration). It turned out that all page content was there, it was just not being displayed. But this initial assumption resulted in the verification run to also check for missing words. Note that updates to either the Confluence or the SharePoint page can also cause this check to be triggered.
In the future, the verification run might be extended with further checks or statistics collection.
Logging Improvements
Since the number of transformation modes is growing, WikiTraccs now shows the mode it is running in:
The log file and console also show the mode:
Possible values are:
- MIG - Content migration
- PRINCIPALS - Update 'Created by' & 'Modified by', as well as the dates
- VERIFY - Verify page contents
- PERM - Permission migration
WikiTraccs.GUI also contains several improvements for its progress bars.
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs v1.11.16
WikiTraccs - Confluence to SharePoint Migration Tool
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
- adjustment: default timeout for connections to SharePoint has been decreased from 100 seconds to 40 seconds - NOTE: this change exacerbated a concurrency issue that showed when being throttled by Microsoft, that will be solved in the next release
- fix: memory leaks that lead to high RAM usage
Please report back if you see RAM usage that increases over a period of multiple hours and reaches amounts of > 10 GB. Note that WikiTraccs needs at least as much RAM as the largest file that will be uploaded to SharePoint.
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs v1.11.12 (Prerelease)
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD LATEST RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
Jira Integration Improvements
So far, there were two assumptions baked into WikiTraccs: Jira can be reached to resolve issue links and issue tables, and WikiTraccs will wait for 60 seconds for Jira to respond. This is now more flexible.
- the maximum wait time for reaching out to Jira can now be configured via the
appsettings.json->WiggleRoom.JiraMaxWaitTimeSecsetting; this wait time is applied each time the the Jira-related Confluence endpoint is called - set
WiggleRoom.JiraMaxWaitTimeSecto-1to disable reaching out to Jira while migrating pages from Confluence to SharePoint; this is handy when the Jira application link is no longer functional - and a bug has been fixed: issue tables that showed the
fixVersionalways ran into a timeout when being migrated
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs v1.11.9 (Prerelease)
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
Page Label Migration
Finally page labels are migrated as well. With this release WikiTraccs creates a new field Confluence: Labels (WikiTraccs) for the SharePoint Site Pages Library, that is of type Multiple lines of text, that will contain the labels for each page.
Why not migrate to managed metadata instead of text? Because it complicates things. Migrating as managed metadata would introduce dependencies to the term store, which might pull in additional stakeholders with regard to permissions, administration, and knowledge management. And what if you want to use a choice field instead? Those are decisions specific to each migration effort.
The current migration approach for page labels is to put them all into the Confluence: Labels (WikiTraccs) field, separated by the space character (which cannot occur in a label). All labels have a prefix. Valid prefixes in Confluence are "global", "team", and "my".
So, for a page that has two labels foo and bar, the Site Pages library field Confluence: Labels (WikiTraccs) will have this content: global:foo global:bar.
You can use a PowerShell script to copy those values to another field of type managed metadata. And maybe clean them up a bit in the process.
Other Changes
- improvement: Confluence code macro titles are now migrated as well, becoming code comments in the SharePoint Code Snippet web part
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.
WikiTraccs v1.11.6 (Prerelease)
WikiTraccs - Confluence to SharePoint Migration Tool
📥 DOWNLOAD LATEST RELEASE
📖 GENERAL QUICK START GUIDE ↗️
📖 HOW TO UPDATE ↗️
In this release:
Changes
- new: setting to switch off attachment sections on pages (via appsettings.json)
- improved: link transformation now creates much shorter HTML for transformed links; this can help with large pages that previously ran into the platform limit of 2 MB per page
- improved: cross-site attachment handling
- improved: Confluence connection handling for better performance
- fix: images linking to pages could lose the link
- fix: file access issue in Selenium proxy
- fix: attachment file names that are invalid on Windows could prevent pages from being migrated
Image transformation adjustments
TL;DR: Just for information, nothing to do.
Adjacent images are now transformed to a column of centered images in SharePoint. Adjacent image placement kind of worked for the old text web part that was used by SharePoint pages up until fall of 2023. The new text web part that Microsoft introduced cannot display adjacent images anymore, at all. No chance. So the default image transformation now shows the ugly truth and makes those images appear centered, one by one. I really hope that the SharePoint pages story evolves in the future to support adjacent images.
Converting adjacent images to single centered images is the new default behavior.
Note: You can get the old behavior back via appsettings.json:
"CustomSettings": {
"Features": {
"UseCkEditorv5Mode": false
}
}Using above setting will continue to create pages that display adjacent images until you edit a page for the first time. SharePoint's page auto-upgrade will then re-arrange the images.
Note: A future release of WikiTraccs will introduce the option to convert adjacent images to image gallery web parts.
Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.
You agree to the Terms of Service by downloading and using WikiTraccs.