Skip to end of banner
Go to start of banner

Integration of Metadata and Comala Publishing

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Current »

Metadata for Confluence offers you a great integration with Comala Publishing.

It allows you to configure Metadata sets and fields in your draft space and publish them seamlessly to your target space as well. A must-have synchronization! 

If you're interested in Comala Publishing's additional functionalities, you should check out their user guide documentation. 

General Prerequisites

Before you get started, there are some important prerequisites to this integration, which include the following:

  • The global configuration of the Comala Publishing app has to contain the prefix "com.communardo" (without the quotations, obviously!) in the list of the property prefixes of the content properties that will be copied. In the current versions of the app, this configuration is set by default.

  • Your publishing settings of a space need to have the "Content Properties" option enabled. The setting can be found in the "Data to Include" section of the "Content Options" setting configuration.

  • The draft space needs to have a space homepage.

  • When you're using space Metadata in the draft space, you will need to ensure that this homepage is also published to the target space. To do this, just enable the option "Top level pages" in the "Space Publishing Options" section of the configuration.

Now you're almost good to go!

An important note: We encourage you to use global Metadata in this integration instead of space Metadata. 

The Metadata Comala Publishing integration will work better if you use global Metadata, instead of space Metadata. 

Unfortunately, if you use space Metadata, there are several limitations you will encounter:

  • When you're working on multiple pages, but only publish a single one with Comala Publishing, the changes in the Metadata of other pages might get published too.

  • Default values defined in the draft space can't be published when you use Comala Publishing.

  • Not all changes to a space Metadata set will be published with Comala Publishing.

    • When you modify the name, description, the "default for" setting or the order of fields for a space Metadata set in the draft space, these changes might not get synchronized to the publishing space when using Comala Publishing. The synchronization will only happen when there are additional structural changes to the fields of the set. For example, changing the hidden/required flag of a field, adding/removing fields or modifying fields.

  • Page template assignments of a Metadata set in the draft space can't be published with Comala Publishing.

You can also take a look at our available public tickets for the issues. They explain everything in more technical detail:

We highly suggest that you use the global Metadata option for this integration.

Not only will you avoid all the issues mentioned above, but global Metadata also offers collaboration opportunities within departments and spaces because it has fewer restrictions.

  • No labels