Child pages
  • Diagramming in Confluence - Mass import from Gliffy to draw.io
Skip to end of metadata
Go to start of metadata




Mass import diagrams from Gliffy to draw.io

For customers who want to switch from Gliffy to draw.io, the app comes with a practical feature: The Gliffy Mass Import (Confluence Server only). All diagrams created with Gliffy can be quickly and easily imported into native draw.io diagrams.

FAQ for the Gliffy Mass Import







Gliffy mass import guide

Follow these three simple steps to mass import all of the Gliffy diagrams in your Confluence instance.

If you are worried about running this directly on your production instance, or if you have custom shapes in your Gliffy diagrams, we recommend you copy your production instance to a test instance, and run a test import there. For more information about this, please see the Gliffy mass import FAQ.


1. Install the draw.io app


In the General configuration under "DRAW.IO ADD-ON" select "Add-on Configuration"


2. Import the Gliffy diagrams


In the Add-on Configuration, select the "Gliffy Import" tab. Click on either the "Start Import" button to import all of the Gliffy diagrams in your instance, or use "Filter by spaces" to import only the diagrams attached to pages in this specific space.

 


3. Download the report


Wait until the import has finished, and download the report. Use the report to see whether all diagrams were converted successfully, and which diagrams were not able to be imported.

Tips


When should you perform the import?

We recommend that you do the conversion outside of the normal usage hours of your Confluence instance. Even though it is possible to perform the conversion while employees are using your Confluence instance, it can significantly delay or extend the conversion process.

We also recommend you do a test import using the Gliffy mass importer on your test instance of Confluence.

What Confluence permissions are needed?

The administrator that triggers the Gliffy mass import must have write permission for every Confluence page containing a Gliffy diagram. Otherwise, the mass importer can't save the draw.io diagram to that page!

Pages with restricted permissions aren´t editable by the administrator and will cause the mass importer to fail to convert the Gliffy diagrams on those restricted pages.

Will draw.io create a backup?

Yes, draw.io automatically creates a backup before the conversion of a diagram begins. You can always revert to a previous version using the version history of the Confluence page.

What happens if you uninstall Gliffy?

You can keep Gliffy in your Confluence instance, even after the support period has ended. Although Gliffy diagrams may not be edited, they will be displayed normally, and can also be converted to draw.io diagrams. If you uninstall Gliffy, draw.io can still perform the mass import, but the Gliffy diagrams will not be visible within your Confluence instance.


Get free draw.io trial Visit the draw.io Website



Something not quite right?

Gliffy diagrams with custom shapes or non-standard formatting may not convert to draw.io diagrams correctly.

Space/page permissions can also cause issues during the import process.

Turn on the logging and profiling, generate a ZIP file and contact support. We'll help you resolve your mass import issues as quickly as possible! See the Gliffy mass import FAQ for how to contact support with this information.


1. Enable the logging and profiling


In your Confluence administration, select Logging and Profiling from the left panel.


2. Configure the logging and profiling


Under Add New Entry, enter mxgraph as the Class/Package Name, select DEBUG, then click on Save at the bottom of the page.



3. Create the support ZIP file


  • Import the diagrams.
  • In the Confluence administration, under Logging and Profiling, click on Support Tools in the left panel.
  • Finally, in the Support Tools page, click on the Create Support Zip tab, then click on the Create button.
  • Send this support ZIP file to support@draw.io along with the other information as specified in the Gliffy mass import FAQ.




  • No labels