Template compatibility messages

Note: This feature is only available in OL Connect Chromium version.

This page provides information about Error, Warning, and Information messages that may be generated by the Template Compatibility dialog. Due to ongoing improvements, the messages below may not exactly match wording of the messages displayed on screen.

The messages are grouped by type. Click the type to view the messages.

Changed field and table access syntax

Description: The use of record.fields and record.tables is no longer array-like, and therefore the length property and numeric indexing are not supported. These collections are now plain objects.

For example, this code causes errors:

Copy 
for (let i = 0; i < record.fields.length; i++) {
  logger.info(record.fields[i]);
}

You should rewrite it as:

Copy 
for (const name in record.fields) {
  logger.info(record.fields[name]);
}

If you need array-like behavior, use Object.keys(), Object.values(), or Object.entries() to transform the object.

Note: Detail tables remain arrays. For example, record.mydetailtable and record.tables.mydetailtable can still be indexed as before.

Icon: Error

Displays: When any type of script contains the use of record.fields and/or record.tables in combination with the length property in the opened template.

Legacy script syntax no longer supported

Description: Scripts run directly in the content browser, so non-standard JavaScript syntax is no longer supported. For example, String.substr(name, 1, 3), which worked in earlier versions of Designer, will cause an error. Use standard JavaScript instead, such as name.substr(1, 3), which works in both environments.

Icon: Error

Displays: When any type of script contains any use of 'currently known' non-standard JavaScript syntaxes in the opened template.

Updated Syntax for scripted CMYK colors

Description: Legacy CSS syntax is not supported in this version of OL Connect Designer. The non-standard cmyk() function is no longer available and each unique CMYK color must now be defined as a color swatch.

Once a swatch is defined, it should be referenced in scripting by its swatch name rather than by constructing a color value. For example:

Copy 
var color = "var(--cmyk-100-40-100-0)";

Icon: Error

Displays: When any standard script or script file (internal or external) contains a legacy reference to the cmyk() function.

Changed SVG Rendering Behavior

Description: This version of OL Connect Designer uses a new internal browser (Chromium), which renders SVG images without <width> and <height> attributes differently. These SVGs now automatically fill the allocated space while preserving their aspect ratio.

To control the size, apply a width or height to the containing HTML element. The set dimensions will then also apply to images that are dynamically loaded or replaced at runtime.

Icon: Warning

Displays: When the Resources → Images section contains images with the .svg file extension or when the HTML content contains the <svg></svg> element tags.

Detecting broken images requires post-pagination scripts

Description: The data-broken-image attribute is now added after standard scripts have run, but before pagination. This means you can’t use a standard script with the [data-broken-image] selector to detect broken images. To do so, use a post-pagination script instead.

Icon: Warning

Displays: When any standard script (non post-pagination) contains a reference to the [data-broken-image] selector in the opened template.

Isolated scope for user scripts

Description: Each user script now runs in its own isolated scope. As a result, variables declared with const, let, or var, and functions declared using the function keyword, are no longer global. They can only be accessed within the script where they are defined.

To create global variables or functions accessible across scripts, omit the declaration keyword for variables (e.g., x = 123) and use function expressions

(e.g., fn = function() { … }).

Icon: Warning

Displays: When any type of script contains any declared variables or functions that are also used from other scripts in the opened template.

Mozilla-specific CSS properties are no longer supported

Description: This version of OL Connect Designer uses a new internal browser (Chromium), which does not support Mozilla-specific CSS properties. The -moz- prefix, previously required for some features, cannot be used, however most related features are available in standard CSS.

Icon: Warning

Displays: When the HTML, CSS, scripts contain a reference to a -moz- CSS property in the opened template.

Opacity setting for Tint Color swatches is not applicable for non-PDF output

Description: Any Opacity setting applied to CMYK and spot Tint Color swatches is only applicable to PDF output formats. In other formats, Tint Color swatches are always fully opaque. This may cause visual differences and reduced design accuracy for non-PDF outputs.

Icon: Warning

Displays: When any CMYK color swatch and any spot colors are defined as a Tint with an applied opacity.

Postponed pagination with merge.section.paginate

Description: The post pagination script function merge.section.paginate no longer triggers pagination immediately. Instead, pagination is deferred until the script that calls it has finished executing.

Icon: Warning

Displays: When any post pagination script contains the use of merge.section.paginate in the opened template.

Section-Related sheetConfig.positions.all properties are now write-only

Description: The section-related control script properties under sheetConfig.positions.all are write-only. Attempting to read these values will return null or undefined.

Icon: Warning

Displays: When any control script contains the use of sheetConfig.positions.all in the opened template.

Updated Number and Date formatting

Description: Number and date formatting follow the latest official Unicode standard (CLDR), replacing a legacy format. As a result, you may notice differences in how numbers and dates are displayed.

For example, in certain languages, negative currency values used to be displayed within parentheses or with the minus symbol following the value (a format known as financial or accounting notation). Formatting now follows the standard notation.

Icon: Warning

Displays: Only when formatter options are used in scripts, expressions, or wizards of the opened template.

Updated Syntax for CMYK Colors and Swatches

Description: Legacy CSS syntax is not supported in this version of OL Connect Designer. The non-standard cmyk() function is no longer available and each unique CMYK color must be defined as a color swatch.

Direct references to color swatches are also no longer supported. Use the var(--name) syntax instead, where name is the name of a color swatch. For example:

Copy 
color: var(--Empire\ Green);

Note: Spaces must be backslash-escaped, and color swatch names are case sensitive.

When opening an older template, unsupported color references are automatically migrated where possible. However, references in read-only resources, such as remote CSS or HTML files, cannot be updated automatically.

A list of converted references, and references that are read-only and cannot be converted, is displayed with this message.

Icon: Warning

Displays: When any type of HTML, CSS, or script file (internal or external) contains legacy references to the cmyk() function or applies color swatches without using the var() function.

Read-Only content in Preview mode

Description: In Preview mode, browser content is read-only. Limited interactions, such as resizing or moving static elements, are supported. Toolbar buttons and menu items that modify content are disabled.

Icon: Information

Displays: Always

Resource names are now case sensitive

Description: Resource names, such as sections, master pages, and media, are case sensitive. When referencing a resource in a script, the case of the name in the script must match the case of the name in the Resources panel.

Icon: Information

Displays: Always

Simplified script validation in Design mode

Description: Script validation in Design mode is limited to syntax errors. Runtime warnings and errors, such as unknown table or field names, no longer appear in the Scripts panel or script editors during design. Full validation, including runtime checks, remains available in Preview mode.

Icon: Information

Displays: When any type of scripts are present in the opened template.

Text rendering differences

Description: This version of OL Connect Designer uses a different internal browser (Chromium), which renders text with slight variations. This may cause text to appear with different offsets, potentially affecting word wrapping. As a result, content that fits on a page in previous versions of the Designer might shift to the next page in this new version.

Icon: Information

Displays: Always