MultiExcerpt and Draw.io in Data Center and Server

Looking for information on the Cloud? Read the MultiExcerpt and draw.io in cloud article.

Caching

For a MultiExcerpt that contains a Draw.io Diagram macro:

When included in a MultiExcerpt Include macro, the diagram does not render unless caching is disabled.

When the MultiExcerpt Include macro uses caching, the included diagram is blank.

Use the macro editor to disable caching in your MultiExcerpt Include macro.

Page context

The draw.io Diagrams for Confluence plugin is a plugin developed by another company, and draw.io depends on the page context in which the diagram is defined. We do not have any insight into that dependency or control over it.

Therefore, it is not possible to enable the parameter “Use MultiExcerpt Include Page Context” in a MultiExcerpt Include macro that is used to include a draw.io macro:

But I need to render the included content in the MultiExcerpt INCLUDE page context

Suppose you have a MultiExcerpt (ME) that combines a draw.io macro and some content that must be rendered in the context of the MultiExcerpt INCLUDE page’s context instead of the default of using the context of the original page. In that case, you must split the mixed content into two MultiExcerpt (ME) macros.

Then, use two different MultiExcerpt Include (ME-Include) macros with different context parameter settings.

My draw.io macro does not work when included in a MultiExcerpt Enhanced Permissions (MEEP) Macro

I see this access error when I try to view the page with a MultiExcerpt Include that consists of a MEEP that has a draw.io macro in it:

draw.io

Source page access restriction: Click the link below to check if the page is accessible.
/foo/foo+test

The MEEP (MultiExcerpt Enhanced Permissions) macro is only designed to override the Confluence PAGE permissions for the page with the original ME (MultiExcerpt).

A ME-Include (MultiExcerpt-Include) macro can include the body of a MEEP that is on a restricted page that a user would not usually be able to view, and the MEEP has the list of users/groups that can override Confluence's page permissions.

However, the MEEP has no mechanism for overriding other permissions/restrictions like those enforced by the Draw.io macro. The MEEP cannot tell the Draw.io macro to override its permission check using the users/groups specified in the MEEP.

This works as designed, and it limits MEEP's abilities.

We recommend you put Draw.io diagrams in ME macros on pages normally accessible by any user who needs to use ME-Include to include them. One cannot put the Draw.io diagram in a MEEP and have that somehow override the permission checks in the Draw.io application.