Setting the WoodWing article format to use

Info: Performing the steps described in this article requires direct server access. Depending upon how your system is hosted and the level of access you have to that system, coordination may be required with your Partner or WoodWing Support team.

In Studio Server, articles are stored in WoodWing's WCML format. Two versions of this format exist.

This article describes which formats these are, when they can be used and how to configure the system to use them.

The WCML format

The WoodWing article format is known as the WCML format, after the file extension .wcml.

Two versions were released: 'WCML2'. and 'WCML3'.

Compared to the WCML2 format, the WCML3 format brings the following improvements:

• Reduced file size by not duplicating all style definitions, colors, swatches, fonts, and font families for each article component.
• Improved performance for opening and saving the article by replacing the parser that is used for exporting and importing article data by a more modern, better performing XML parser.

Reducing data transfer and file size is important, especially for Studio Server installations and cloud hosting. The WCML3 article format will help with this.

Expected performance improvements

During the development of the WCML3 format, much testing was done to determine the performance improvement. What the improvement will be in your production environment very much depends on the complexity of the articles:

Small articles containing only a few components will see very little improvement.

For complex articles containing many styles (100+) and over 30 components, we saw a reduction in article size of 90%, while the speed of opening the article improved by 30%.

Compatibility

The table below show the compatibility of the WCML formats for Studio for InDesign and InCopy, Studio Server, and Studio.

When to use WCML3

When both WMCL2 and WCML3 are supported, consider using the WCML3 when:

• Complex articles containing many components are used.
• Situations in with high latency exist and where large articles are created and edited in Studio (this is typically the case when InDesign Servers for preview generation are hosted in the cloud).

Default formats

The default article format is WCML3.

Technical details

In the WCML3 format, the structure of the story has been changed: XML elements (such as styles, colors, preferences, and so on) that are shared by stories are no longer in every story but are instead placed in a shared section. The content section itself has not been changed. Third-parties that rely on the content structure should not be affected.

The structure of article templates files (.wcmt) has not been changed.

The XML parser that is used to import and export styling data and story content has been replaced with pugixml. The previous parser was Xerces based. The switch is motivated by performance considerations.

For the XML schemas including an example of each schema, see the following link:

• WCML2 and WCML3 example files

Upgrade strategy

Enabling WCML3 affects all users signing in to the instance of Studio Server, regardless of the version of Studio for InDesign and InCopy or Studio that they are using. It is important therefore to only switch to the generation of articles in WCML3 format when all users use clients that support that format.

Configuration

For versions in which both WCML2 and WCML3 are supported (see above), enabling a version can be done by adding one of the following options to the SERVERFEATURES in the config_overrule.php file of Studio Server:

new Feature( 'WcmlVersion2' ),

new Feature( 'WcmlVersion3' ),