Prerequisites

  • Confluence Server instance (contains the Scroll Word templates you want to migrate)
  • Confluence Cloud instance with Scroll Word Exporter and Scroll Exporter Extensions installed
  • On both instances:
    • Confluence admin permissions if you have global templates you want to migrate
    • Space admin permissions if you have space templates you want to migrate
  • Confluence Source Editor installed on Server instance

Migration Steps

Step-1: Change Scroll Exporter app specific macros 

Before moving your Confluence spaces to Cloud you should migrate any Scroll Exporter macros that are not available on Cloud to their respective Cloud compatible version. This is required if you have used the Scroll Exporter macros with Scroll Word Exporter before version 4.0.0.

These macros are:

  • Scroll Office Ignore
  • Scroll Office Ignore Inline
  • Scroll Office Only
  • Scroll Office Only Inline
  • Scroll Office Indexterm
  • Scroll Export Button

For each page where these macros are used follow these steps:

  1. Edit the page in Confluence
  2. Open the Confluence Source Editor by clicking the <> button in the top right
  3. Use the Search / Replace function on the top to apply the following changes:
    • Search for scroll-office-ignore and replace it with scroll-ignore
    • Search for scroll-office-ignore-inline and replace it with scroll-ignore-inline
    • Search for scroll-office-only and replace it with scroll-only
    • Search for scroll-office-only and replace it with scroll-only-inline
    • Search for scroll-office-index-term and replace it with scroll-indexterm
    • Search for scroll-exportbutton and replace it with scroll-export-button
  4. Close the Confluence Source Editor and Save the page

Step-2: Download Scroll Word Exporter global templates from Server instance

  1. On the Server instance go to the Global Administration settings
  2. From the left-hand sidebar, select Templates  under 'Scroll Word Exporter' 
  3. Check if there are any templates in the list that are marked as GLOBAL
  4. For each of these templates click the action button (•••) > Download and save the downloaded file

Step-3: Upload Scroll Word Exporter global templates to Cloud instance

  1. On the Cloud instance select Settings in the Confluence navigation (top right corner next to your user icon)
  2. From the left-hand sidebar, select Templates  under 'Scroll Word Exporter' 
  3. Click the Upload button in the top right and select all the files that you downloaded in Step 1
  4. Once the files have been uploaded you should see a message saying Templates imported successfully and the template list should display the new templates

Step-4: Download Scroll Word Exporter space templates from Server instance

To start, in your Server instance, find all the spaces containing the Scroll Word Exporter templates that you want to migrate. For each of your spaces:

  1. Go to Space tools > Add-ons / Apps > Scroll Word Exporter
  2. Check if there are any templates in the list that are not marked as either PROVIDED BY ADD-ON or  GLOBAL
  3. For each of these templates click the action button (•••) > Download and save the downloaded file

Step-5: Upload Scroll Word Exporter space templates to Cloud instance

  1. Go to Space tools > Add-ons / Apps > Scroll Word Exporter
  2. Click the Upload button in the top right and select all the files that you downloaded in Step 1
  3. Once the files have been uploaded you should see a message saying Templates imported successfully and the template list should display the new templates

Still Unclear? Reach Out to Us

If you need help with any of these migration steps, reach out to us via help@k15t.com.