Known Issues and limitations
Limitations
Pages with more than 2 MB of page text content cannot be created in SharePoint Online. This is a known limitation of SharePoint Online. Note that this does NOT mean page attachments, but actual page content. Pages hitting this limit would be massively long.
When migrating page restrictions, WikiTraccs will only migrate up to 200 user and group restrictions per page.
Overly long page titles break page creation in SharePoint. This is tracked in issue #3.
Changes to a Confluence page’s attachments or comments are not counted as “page change”. The page is detected as unchanged, even if e.g. attachments are added.
Changes to a Confluence pages’s title will duplicate the page in SharePoint, as the file name of the SharePoint page changes. Those kinds of title changes in Confluence might also lead to stale or broken links in SharePoint. If already migrated pages (in SharePoint) link to the newly migrated page (that now has a new name in SharePoint), those links will point to the old page; or be broken if the old page is deleted manually.
The principal/metadata update mode of WikiTraccs currently can only handle up to 5000 attachments per page.
Rich image captions are not supported by SharePoint Online, the text content of the image caption will be used instead.
Confluence Cloud
Migrating databases is not yet supported as there is no endpoint provided by Atlassian to export the data.
Link transformation for sharing links that have been pasted to pages (those contain ‘/l/cp/’ ) is not yet possible. Note that those are not tiny links, which are properly transformed. Discussions about this link format: 1, 2.
At the time of this writing, retrieving inline comments might fail in Confluence Cloud. Note that inline comments are currently not surfaced anywhere on migrated pages, but only stored in the WikiTraccs site with the page storage format XML blob. This inline comment retrieval currently seems to be broken with the Confluence Cloud REST API v2.
Hard links of type create page are left as is, pointing to Confluence. WikiTraccs doesn’t know what to do about them as there is no equivalent in SharePoint. Sample link: https://contoso.atlassian.net/wiki/pages/createpage.action?spaceKey=SPC&title=Page.