Drawio Macro

Version 1.1 von xwikiadmin am 2023/04/25 10:54
Warnung: Aus Sicherheitsgründen wird das Dokument in einem eingeschränkten Modus angezeigt, da es sich nicht um die aktuelle Version handelt. Dadurch kann es zu Abweichungen und Fehlern kommen.

Das Makro [velocity] konnte nicht ausgeführt werden. Grund: [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.]. Klicke auf diese Nachricht, um Details zu erfahren.

Das Makro [velocity] konnte nicht ausgeführt werden. Grund: [The execution of the [velocity] script macro is not allowed in [xwiki:Confluence.Macros.Drawio]. Check the rights of its last author or the parameters if it's rendered from another script.]. Klicke auf diese Nachricht, um Details zu erfahren.

Description

The Drawio macro is a bridge between Drawio macro used in Confluence and the Diagram macro used in XWiki. The aim of this macro is to allow users to view and also to modify the Drawio/Diagrams.net diagrams migrated from Confluence. By default, the macro displays the preview of the Drawio diagram. The user can create the editable version of the diagram, by using its representation into an 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.
Information

Besides the diagramName parameter, the {{drawio}} macro used in Confluence has other parameters that don't have to be cleaned, because these parameters are being ignored by this bridge macro.

Example of usage

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

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

The result is the following:

MyDrawioDiagram.drawio.png