Version compatibility

Some templates and document specifications can be opened and used in other versions of Rational® Publishing Engine than the version they were created in. In Rational Publishing Engine 1.2 and later, you can choose which template structure to use, thereby making it compatible with templates created in any other version of Rational Publishing Engine.

Rational Publishing Engine 1.2 and later

In Rational Publishing Engine 1.2, the template language was redesigned to include additional elements in the Palette view, expanded JavaScript functionality, and more. As a result, you have the option of selecting which template language you use to design your templates and thus, templates you created with older releases are compatible with Rational Publishing Engine 1.2 and later. You can choose to use the Rational Publishing Engine 1.2 and later template language or continue to use the template language from an earlier version of Rational Publishing Engine.

After you install the latest version of Rational Publishing Engine, it is possible that your data provider does not yet support the version 2 template structure. For example, you might be using a data provider that incorporates Rational Reporting for Document Generation 1.1.2.2 or earlier. If your data provider does not support the Rational Publishing Engine 1.2 or later and the version 2 template structure yet, specify the version 1 template structure for your templates. Check with the administrator, user interface, or documentation for the data provider to see which version of Rational Reporting for Document Generation is incorporated into your data provider.

When you create a template, you can select one of these options:
  • Template version 1 (RPE 1.1.2.2 and older): Use the functionality from Rational Publishing Engine 1.1.2.2 and earlier and not the additional functionality introduced in Rational Publishing Engine 1.2.
  • Template version 2 (current RPE version): Use the additional functionality introduced in Rational Publishing Engine 1.2.

    To use the same template version for every new template, select Use a specific template version in the Document design preferences.

When you open a template that was created with a previous version, you can select one of these options:
  • Template version 1 (preserve version, RPE 1.1.2.2 and older): Do not use the additional functionality introduced in Rational Publishing Engine 1.2.
  • Template version 2 (upgrade template to current RPE version): Use the additional functionality introduced in Rational Publishing Engine 1.2. When you choose to upgrade a template that was created in a previous version of Rational Publishing Engine, it is no longer compatible with the version it was created in.

    You do not have the option to remember your selection when opening templates. You must specify a selection each time you open a template that was created with a previous version of Rational Publishing Engine so that the wrong template version is not mistakenly used when working with older version of Rational Publishing Engine or Rational Reporting for Document Generation.

Rational Publishing Engine 1.1.2.2 and earlier

If you choose not to upgrade your installation of Rational Publishing Engine, note that certain versions of Rational Publishing Engine are not compatible with others. To use the table below, find the version of Rational Publishing Engine you have installed and then see templates created with which versions of Rational Publishing Engine are compatible with the version you have installed.
  • For Compatible versions, you can open a template or document specification created in the version of Rational Publishing Engine from a column heading and continue to work with it with the current version you have installed.
  • For Compatible with version 1 templates, you can open a document specification or a version 1 template created in the version of Rational Publishing Engine from a column heading and continue to work with it in the current version you have installed. Version 2 templates are not compatible with Rational Publishing Engine 1.1.2.2 and earlier.
  • For Not compatible versions, no templates that were created in the version of Rational Publishing Engine from a column heading can be used with the current version you have installed.
Table 1. Rational Publishing Engine version compatibility
Rational Publishing Engine version installed Templates created with 1.0 Templates created with 1.1 Templates created with 1.1.1 Templates created with 1.1.1.1 Templates created with 1.1.2 Templates created with 1.1.2.1 Templates created with 1.1.2.2 Templates created with 1.2 Templates created with 1.2.0.1
1.2.0.1 installed Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible
1.2 installed Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible
1.1.2.2 installed Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible with version 1 templates Compatible with version 1 templates
1.1.2.1 installed Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible with version 1 templates Compatible with version 1 templates
1.1.2 installed Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible with version 1 templates Compatible with version 1 templates
1.1.1.1 installed Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible with version 1 templates Compatible with version 1 templates
1.1.1 installed Compatible Compatible Compatible Not compatible Not compatible Not compatible Not compatible Not compatible Not compatible
1.1 installed Compatible Compatible Compatible Not compatible Not compatible Not compatible Not compatible Not compatible Not compatible
1.0 installed Compatible Compatible Compatible Not compatible Not compatible Not compatible Not compatible Not compatible Not compatible

Feedback