Migrate from Just Add+ diagrams to Capable Diagrams in Confluence
To migrate Just Add+ diagrams, a Confluence administrator opens the Migration tab in Capable, selects Just Add+ for Confluence (Modus Create) and its Diagram macro, runs Perform verification, then Start migration. Source pasted into the macro becomes a Capable diagram; source loaded from a URL or attachment becomes a Capable diagram from URL or attachment.
#Before you start
You need | Why |
|---|---|
Confluence administrator rights | Only administrators can open the Migration tab. |
A pilot space | A small first run shows you the real failure rate in minutes. |
The browser tab left open | The migration runs in your browser and stops if you close the tab. |
#Steps
In Confluence administration, open the app's settings page (Capable, or Capable Diagrams for the standalone app) and select the Migration tab.
Read Introduction and tick the confirmations, then go to Options. Leave Skip errors on.
In Select apps, choose Just Add+ for Confluence (Modus Create).
In Select macros, choose Diagram, and narrow the pages to your pilot space.
On Run, select Perform verification. It reads the pages and writes nothing. Read the results.
Select Start migration. When it finishes, select Download log and keep the file.
#What converts
Macro | Becomes | Worth knowing |
|---|---|---|
Diagram, with source in the macro | A Capable diagram | PlantUML, C4 with PlantUML, BlockDiag, Bytefield, GraphViz, Mermaid, Symbolator, Vega, Vega-Lite, ditaa, ERD, Nomnoml, Pikchr, Structurizr, Svgbob, UMLet and WaveDrom source, with the diagram title. |
Diagram, with source from a URL or attachment | Diagram from URL/attachment (Capable) | The same languages. The macro keeps loading from the same URL or page attachment. |
Missing PlantUML and BlockDiag wrappers are added so the diagram renders in Capable.
This page covers the Diagram macro. Just Add+ Markdown and LaTeX macros have their own migrators in Capable for Confluence.
The Just Add+ migration is not offered in the Zero Egress edition of Capable Diagrams.
#What happens next
Each page the run changes gets a new version labelled "Migrated by Capable", so any page can be put back from its history.
Re-running is safe. Run again for more spaces, or for pages that failed once you have fixed the cause.
To undo a whole run, open Repair on the Migration tab and use Roll back pages with the log you downloaded. See Roll back a Confluence macro migration.
#If it does not work
No Migration tab: you are not a Confluence administrator, or you are in the wrong app. See I cannot find the Migration tab.
Pages you cannot edit are skipped and reported as permission failures. Use Admin Key (experimental) under Advanced options lets an administrator migrate them.
#Related
Just Add+ for Confluence (Diagrams)
Full migration notes for the Diagram macro.
Test a Confluence migration with a dry run
Verify before you write anything.
Roll back a Confluence macro migration
Undo a run from its log.
Insert a PlantUML diagram in Confluence
Working with PlantUML afterwards.
Run a migration
Every wizard step and option.
Seventeen languages in, Capable diagrams out.
