How to migrate Confluence Content using Space Selectors
Selecting whole Confluence spaces for SharePoint migration is the easiest way to map and migrate Confluence content.
Why use a space selector?
With space selectors you tell WikiTraccs what to migrate on a per-Confluence-space basis.
Usual scenarios are:
- migrate each Confluence space to a corresponding SharePoint site
- migrate multiple Confluence spaces to one SharePoint site, for example for archiving purposes
If that is a granularity you can work with, do it. It’s easier than CQL query selectors and content ID selectors.
Where to configure space selectors?
Go to the Space Inventory; it should already contain a list of all Confluence spaces WikiTraccs found, when you followed the steps of the Quick Start tutorial.
Set a check mark in the Wt_Setting_RequestTransformation column for every space you want to migrate.
Here’s what the Space Inventory list might look like:
| WT_In_CfSpaceName | WT_In_CfSpaceKey | Wt_Setting_RequestTransformation | WT_Setting_TargetSiteRootUrl | |
|---|---|---|---|---|
| Project Alpha | PALPHA | x | https://contoso.sharepoint.com/sites/ProjectAlpha | |
| Project Beta | PBETA | x | https://contoso.sharepoint.com/sites/ProjectBeta | |
| Miscellaneous | MISC | x | https://contoso.sharepoint.com/sites/Miscellaneous | |
| Marketing | MRKT | https://contoso.sharepoint.com/sites/Marketing | ||
| Sales | SALES | https://contoso.sharepoint.com/sites/Sales | ||
| Customer Service | SERVICE | https://contoso.sharepoint.com/sites/CustomerService | ||
| HR | HR | https://contoso.sharepoint.com/sites/HR | ||
| Finance | FIN | https://contoso.sharepoint.com/sites/Finance | ||
| IT | IT | https://contoso.sharepoint.com/sites/IT |
Note: Other columns have been omitted for brevity.
In the above sample, three spaces have been selected for migration: Project Alpha, Project Beta, and Miscellaneous.
Link Transformation
Space selectors are relevant for link transformation.
When WikiTraccs transforms a cross-space link from PAGE_SOURCE to PAGE_TARGET, all selectors in the Space Inventory will be checked if they contain PAGE_TARGET.
Having found a selector that contains PAGE_TARGET, WikiTraccs uses this selector’s WT_Setting_TargetSiteRootUrl value to create the link.
Be sure to fill those WT_Setting_TargetSiteRootUrl columns for all selectors, not only the ones to be migrated.