Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Step

Description

Image

1

Perform a regular migration using Atlassian’s migration assistant.

2

6

Configure the rest of your topic.

7

Export On your Server/DC instance

Either export a single topic to a JSON file using the REST endpoints export or export2 /export2 REST endpoint on your Server / Data Center instance as described here (please expand “Using the REST interface”) .

Please name the export file exactly “sqa_export.json” and save it on your computer.

3

Upload “sqa_export.json” to the topic page (the page holding the Overview macro of the relevant topic) as attachment.

4

Edit the topic page and then edit the overview macro. In case everything went right an additional tab called migration will show up.

💡 Please remember that you must be an admin to see the migration tab.

Image Removed

5

On the migration tab make your settings (we recommend to keep them as they are for now) and then hit “Run migration”. The migration will now start and you will see all details under migration results.

In case everything worked fine and you have checked that you are happy with the migration result you may check “Delete comments…” and run the migration again. This will delete the old comments not needed anymore.

Image Removed

Repeat the steps for all other topics you want to migrate.or export all topics using the /exportAll endpoint.

💡 Both endpoints deliver an url and a download link first. When you click the download link you will either get a message that the export has not been finished yet (ready : false) or the browser downloads the file already. In case the export has not been finished yet, reload the page e.g. every 10 seconds until you get the download.

Image Added

3

On your Cloud instance

First navigate to:

Code Block
<<your_url>>/plugins/servlet/ac/de.edrup.confluence.plugins.simple-qa/simple-qa-migration

Example:

Code Block
https://example.atlasstian.net/wiki/plugins/servlet/ac/de.edrup.confluence.plugins.simple-qa/simple-qa-migration

Once the page has been loaded you can configure the migration:

  1. Overwrite responses already imported: when selected answers will be re-imported and eventual changes after the first migration will be overridden

  2. Delete comments after migration (do NOT use before you checked the migration results): when selected the comments which are the basis for the migration of answers will be deleted. You should only use this option once you are sure the migration works well for you.

  3. Space key: defining a space key is only needed in case you are using data collected from the /export or /export2 endpoint of the Server/DC app below version 3.11.3. Below the mentioned version the exported data did not contain the space key. Therefore you can only import topic by topic always defining the space key here.

Image Added

4

Select the file you have exported under step #2 and run the migration