Follow post-migration steps on this page for final conversion in Cloud. Then Scaffolding Cloud will be ready for use.
Prerequisites
You have
completed all previous steps
administrator access to Confluence Cloud
Your browser and its apps must allow third-party cookies for features on this page to work. Incognito mode and certain adblockers will disable third-party cookies.
Guide
Before it is fully functional, you will need to do a last simple conversion action to map those data together.
There are two methods to convert the Scaffolding macros to Cloud macros.
Depending on the number of pages or spaces that are being migrated you can choose between
manual conversion
bulk conversion
For manual conversion there are two ways to search for the pages with unmigrated Scaffolding macros
use the list of pages that contains Scaffolding macros that you've obtained from Step 1 - Plan Out Your Migration to search for all the pages that need action in Cloud
use the CQL described in How do I find all Scaffolding Server macros that's not converted to Scaffolding Cloud format yet to search all pages that contain unmigrated Scaffolding Server macros
Ensure permission is given to the right users
In your Confluence instance
go to a space migrated to Cloud
find the pages that contain Field macros.
ensure that both you and the "Scaffolding for Confluence" user (see below example) have the Add page permission on the space
Required user space permissions
Required space permission for Scaffolding app user
ensure that the page that contains Scaffolding server macros (Field macros or Live template macros), or the source for a live template do not have any restrictions
Converting the Scaffolding macros to Cloud macros
If you face any issues or errors during the single or bulk conversion, check out CopyKnown issues when migrating to Scaffolding Cloud for more information.
Bulk conversion of Scaffolding macros
The bulk conversion allows you to bulk convert the Scaffolding macro into Cloud macros through multiple pages and spaces.
go to Space Settings>Manage Space
choose Convert Scaffolding Server Macro
The page lists down all the migrated Scaffolding macros, and the status of the pages will show "Unconverted".
choose Bulk Convert to start the conversion process
choose Proceed on the next window
Closing the tab while the bulk conversion is running will halt the process and may lead to potential data loss.
The duration of the bulk conversion process is dependent on the number of pages.
choose Confirm once the conversion has been successfully completed
The page refreshes and the status of the pages will show "Converted".
The All contents converted button is greyed out indicating the bulk conversion was a success.
Reverting a converted page to unconverted using page history does not update the page conversion status in the space migration tool table.
Manual conversion of Scaffolding macros
The manual conversion requires you to go to each page of the migrated Scaffolding macro and manually click on the macros to convert them into Cloud macros.
Pages with Scaffolding field macros
In the page view mode, the Migrate Scaffolding macro buttons are displayed.
When editing the page (page edit mode), the page structure displayed is similar to what it looked like in the server environment. This is expected behavior.
Choose one of the buttons on the page, in the Page view mode.
You only have to click one of them to trigger a page-wide migration.
Selecting this button will do the following as a background task
convert this page to use the New Editor
migrate all Scaffolding macros on this page
Scaffolding structure will be converted from using Scaffolding Server macros to Scaffolding Cloud macros
map of all Scaffolding data (the form values) to this page
After some time, the page will be migrated to use Scaffolding Cloud macros. The Edit Content button now appears in Page view mode. Clicking it will allow you to insert values to the page.
in Page edit mode, you will see the structure has been converted to the new Scaffolding Cloud Field Group macro
in Page History, you will see two or three new versions created for this conversion purpose
Page view mode
Page edit mode
Page history
Pages with Live template macros
Depending on the type of template you have, you will see a warning banner in the Page view mode.
If you edit the page and edit the macro, you will see the Live template macro with limited function.
This limited functionality is expected behavior in Page edit mode.
In View Page mode inside the banner
choose the "Migrate Live template macro" link
You only have to click one of them to trigger a page-wide migration.
Selecting this action task actions the following as a background task:
converts this page to using New Editor
finds the underlying template used by this Live Template and converts all the Scaffolding Server macros on that page to Scaffolding Cloud macros
maps all of the Scaffolding data (the form values) to this page
After some time, you will see the structure and data of this page. The Edit Content button now appears in Page View mode. Clicking it will allow you to insert values to the page.
in Page edit mode, you will see the Live Template working, and the macro is now editable
in Page History, you will see two or three new versions created for this conversion purpose
Page view mode
Page edit mode
Page History
Review the migration
How did we do?
Contact us at support@appfire.com or via our support portal.