Problem

In environments using same-space publishing with Comala Document Management, pages that include content using the built-in Excerpt Include macro display the latest version of the source page, even if not published. This results in unapproved or draft content being shown on published pages, compromising the integrity of the review and approval process.

Confluence environment

Hosting type: Data Center
Appfire app: Comala Document Management
App version: 7.8.1
Host product version: Confluence 8.5.18

Diagnosis

A page with an applied Comala Document Management workflow uses the default Excerpt Include macro.

Open

Select macro

An update made in the source excerpt page does not trigger the workflow on the page using the excerpt include macro to indicate that a change has occurred in the included content.

Root cause

Comala Document Management does not monitor changes in dynamic content rendered through macros such as the Confluence Excerpt Include macro. As such, when content from another page is included using this macro and the source content changes, these changes do not flag the workflow on the consuming page, causing possible oversight in documentation changes.

Solution

Enable the Published View Macro Transform setting in Comala Document Management. This ensures that:

• Only the last approved version of the excerpt source is rendered in the including pages.

• Draft or unapproved changes in the excerpt source are not shown on the pages where they are included.

Open

This configuration effectively prevents unapproved content from being exposed and maintains workflow integrity.

In each space, you can make this active in the app space configuration.

Navigate to:

• Space tools > Comala Document Management > Configuration > Published View Macro Transform

Open

App space configuration