Register for a free webinar to learn more about the latest version of our software.
This is an old documentation. Go to the latest Customer's Canvas docs

Upgrading the Design Editor

Aurigma updates Customer's Canvas on a regular basis. Once a new version is released, it appears in your account in My Licenses & Downloads. You may want to test new features of the Design Editor and see how they can improve your project. This topic will help you ensure a smooth transition to the new version of the editor.

Important

When you need to run both old and new versions of the Design Editor, run them in separate application pools.

If you customized a UI theme for earlier versions, it may become incompatible with new versions of the Design Editor.

The Standard Upgrade Process

When there are no breaking changes between the old and new versions, the upgrade process includes the following steps:

  1. In the File Explorer, navigate to your application's web directory, for example, D:\inetpub\CustomersCanvas\.
  2. Unzip cc-<new-version-number> from the package CustomersCanvasServer.zip to this folder.
  3. Copy your configuration changes, if any, from the \cc-<old-version-number>\Configuration folder:
    • clientConfig.json
    • AppSettings.config, Aurigma.DesignAtoms.config, FileCache.config, and Converters.config
    • TemplateConfigShortcuts.json
    • translations.json
    • Custom CSS
    • Email notifications
    • Themes
  4. In the IIS manager, stop your application.
  5. In the Basic Settings of your application, change the Physical path to the new folder (D:\inetpub\CustomersCanvas\cc-<new-version-number>).
  6. In the IIS manager, start your application.

Version-specific upgrading instructions

Since the Design Editor introduced significant changes in 6.0.0, 5.33.0, 5.5.0 and 5.1.0, you must perform additional steps to upgrade through these versions.

If you now run, for example, Design Editor 5.0, you can upgrade through these versions in one go.

6.0.0

Using System Fonts

Design Editor 6.0 has stopped using systems fonts. Now, you must store all the fonts available to your users in the asset folder defined in the FontDirectory configuration parameter.

After you have unzipped the new version and restored the old configuration files, you must run the Font Migration Tool to find and copy system fonts used in your products and configs.

Using Classic Text Engine

All types of text elements now support rich formatting and can be edited right on the canvas using the new WYSIWYG text engine. However, the new engine does not support some features yet, and you can still enable the Rich text editor and text pop-up boxes to edit such features.

After you have restored your old configuration files, you can set the LegacyTextEngineEnabled parameter to true in Aurigma.DesignAtoms.config.

5.33.0

In version 5.33, we have changed the way we define the bleed zone and print area size. Earlier, if you wanted to create a 3.5x2" business card with 1/8" bleed, you created a 3.75x2.25" design and put a safety line inside it. But now, when you create a 3.5x2" design, the bleed zone will expand outside the design.

This may result in changing the product size and unnecessary safety lines. If you encounter this, you can either rework the design and change the Bleed and Slug settings or enable the old behavior. In the latter case, set LegacyIdmlBleedParsingEnabled to true in Aurigma.DesignAtoms.config.

5.5.0

After you have restored your old configuration files, in \Configuration\AuthSettings.config, find:

<route
  name="Color convertor API"
  *path="api/ColorConvertor/{action}/{color}/{id}"
  methods="POST"
  authRequired="false"
  unsafeHttpMode ="enabled"
/>
and replace it with:
<route
  name="Color convertor API"
  *path="api/ColorConvertor/{action}/{color}"
  methods="POST"
  authRequired="false"
  unsafeHttpMode ="enabled"
/>

5.1.0

Upgrade through 5.1.0 requires additional changes only if you enabled the auto-start provider. In this case, replace the <serviceAutoStartProviders> node in %WINDIR%\System32\inetsrv\config\applicationHost.config with the following:

<serviceAutoStartProviders>
  <add name="CcAutoStartProvider" type="Aurigma.DesignEditor.CustomersCanvasInitialization, Aurigma.DesignEditor" />
</serviceAutoStartProviders>

Troubleshooting

Some fonts are missing in your products

When products are loaded to the editor or rendered to print files, fonts, which were available before, get missed after the upgrade.

Solution

This may occur if the products refer to system fonts. Since Design Editor 6.0 has stopped using them, use the FontMigrationTool to scan your products for references to system fonts and copy those fonts to the application's folder.

In My Licenses & Downloads, you can find the Font Migration Tool that helps you analyze state files, templates, and mockups and copy the system fonts used in those files to the asset folder.

To run this tool:

  1. Unzip FontMigrationTool from the distribution package.
  2. In the App.config file, find <appSettings> and replace the default settings with the folder paths where you store the assets.
  3. Run FontMigrationTool.exe and follow the instructions in readme.md.

To ensure that print files use the correct fonts, you can disable the font substitution feature in AppSettings.config.

Rich text editor opens for some text elements

Some text elements can be edited on the canvas, although the Rich text editor may open for others.

Solution

All types of text elements now support rich formatting and can be edited right on the canvas using the new WYSIWYG text engine. However, the new engine does not support some features yet and can open the Rich text editor and text pop-up boxes to edit such features. if you want to make this behavior consistent or just enable the old text engine, you can set the LegacyTextEngineEnabled parameter to true in Aurigma.DesignAtoms.config.

Size of products based on InDesign templates changed

Old IDML templates with defined bleed and slug areas open with a different size.

Solution

The way of defining the bleed zone has changed in version 5.33, bringing the user experience closer to Adobe InDesign and other professional tools.

To fix this issue, you can either change the product size manually to comply with the new approach or use the LegacyIdmlBleedParsingEnabled parameter to return to the old approach. You can set this parameter to true in Aurigma.DesignAtoms.config to load IDML templates with bleed and slug areas as it was implemented in version 5.32.

See Also

Manual