If you have questions about the content in this post, please email us directly at [email protected]
In draw.io for Confluence Server 5.1 we've improved the revision handling. The concept is best demonstrated through the creation of a page with diagrams in it. First, we'll create a blank page.
Next we'll add a draw.io and a Gliffy diagram. Each diagram has a single rectangle in it with the revision of that diagram written as the label. (The draw.io diagram is on the left, the toolbar is not normally visible without a mouse hover).
One thing to note is that the viewer toolbar no longer has an edit button in draw.io. This is because we are strictly enforcing edits to happen within the page edit flow. Gliffy will allow you to edit the diagram directly from the page without a new page revision ever having been created, i.e. you can change the page without there being a unique snapshot of the page ever being made. In fact, a page revision is not created if a Gliffy diagram is edited via the page edit flow, either. Page revision 3 in the steps below is only created because the draw.io diagram is edited at the same time.
The page history is as expected for now, but let's edit the diagrams again within the page edit flow:
The page and page history appear as expected:
But when we click on "v.2" of the page:
It can be seen that Gliffy diagram macros always show the last revision of the diagram regardless of which page is displayed, i.e. is the Gliffy macro there or not, if yes, show the latest diagram. If you revert a page containing a draw.io diagram the diagram will also revert in step. One caveat is that the diagram history is only created since draw.io 5.1, so the diagram revision must be created using 5.1 or later. But if a draw.io diagram is created with 5.1+, that means it will have a correct, auditable, revision history.
draw.io for Confluence server 5.0 introduces the ability to create and share custom libraries within draw.io. Within the draw.io editor select File->New Library to create just that:
This will bring up the custom libraries dialog:
Having populated and saved your custom library it will then appear as a library in the left hand side library panel:
You can drag shapes from this new library into the drawing area as per any built-in shape. Custom libraries also have three small icons at the top right:
Add the current selection in the diagram to the custom library (see below).
Edit the custom library, this brings up the library dialog once more.
Close the custom library (this does not delete the library).
The add selection option enables you to select as much of the diagram as you wish, click the "+" icon in a custom library and that selection will be added to the library as a single shape to drag and drop back as you require.
File->Open Library shows you all available libraries, showing the name, author and a preview:
Select any library on the left hand side and press "open" to open that custom library in your editor. Also, custom libraries persist in the libraries panel per diagram, so if a diagram is using certain custom libraries, those always open with the diagram.