Confluence bridge for Drawio

Version 1.1 par Admin le 25/06/2024 - 07:06
Avertissement: La version de ce document n'est pas la plus récente. Pour des raisons de sécurité, XWiki affiche le document en mode restreint. Ce mode d'affichage peut provoquer des erreurs dans le corps du document.

Erreur dans l'exécution de la macro [velocity]. Cause : [The execution of the [velocity] script macro is not allowed in [xwiki:Confluence.Macros.DiagramMacros]. Check the rights of its last author or the parameters if it's rendered from another script.]. Cliquer sur ce message pour voir plus de détails.

Erreur dans l'exécution de la macro [velocity]. Cause : [The execution of the [velocity] script macro is not allowed in [xwiki:Confluence.Macros.ConfluenceDrawio]. Check the rights of its last author or the parameters if it's rendered from another script.]. Cliquer sur ce message pour voir plus de détails.

Description

This is a Confluence bridge for the Drawio macro. By default, the macro displays the preview of the diagram. The user can edit it by converting it to a proper XWiki diagram, always having the option to go back to the preview of the original diagram.

Parameters

ParameterDescription
diagramNameThe diagram identifier. It should be the name of the attachment storing the Drawio diagram data. The Drawio diagram exports consist in attachments added to the parent page. For example, for a diagram called MyDrawioDiagram.drawio, there will be two attachments on the parent page: MyDrawioDiagram.drawio.png (the filename with a ".png" extension) representing the preview of the diagram and MyDrawioDiagram.drawio representing the diagram data in Diagrams.net's native format.

The other parameters coming from Confluence are ignored by this bridge.

Example of usage

The syntax of the macro using the diagram called "MyDrawioDiagram.drawio" is the following:

{{confluence_drawio diagramName="MyDrawioDiagram.drawio" /}}

The result is the following:

MyDrawioDiagram.drawio.png