Prerequisites

  • Confluence Server instance (contains the Scroll PDF templates you want to migrate)
  • Confluence Cloud instance with Scroll PDF 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 PDF Exporter before version 4.1.0.

These macros are:

  • Scroll PDF Exporter Ignore
  • Scroll PDF Exporter Ignore Inline
  • Scroll PDF Exporter Only
  • Scroll PDF Exporter Only Inline
  • Scroll PDF Exporter Indexterm
  • Scroll Export Button

For each page where these macros are used follow the steps below. You can find the affected pages via the Confluence search, for more details see Atlassian's documentation.

  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-pdf-ignore and replace it with scroll-ignore
    • Search for scroll-pdf-ignore-inline and replace it with scroll-ignore-inline
    • Search for scroll-pdf-only and replace it with scroll-only
    • Search for scroll-pdf-only and replace it with scroll-only-inline
    • Search for scroll-pdf-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 PDF 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 PDF 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 PDF 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 PDF 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 PDF Exporter space templates from Server instance

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

  1. Go to Space tools > Add-ons / Apps > Scroll PDF 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 PDF Exporter space templates to Cloud instance

  1. Go to Space tools > Add-ons / Apps > Scroll PDF 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.