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.
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.
When there are no breaking changes between the old and new versions, the upgrade process includes the following steps:
D:\inetpub\CustomersCanvas\.cc-<new-version-number> from the package CustomersCanvasServer.zip to this folder.\cc-<old-version-number>\Configuration folder:
clientConfig.json
AppSettings.config, Aurigma.DesignAtoms.config, FileCache.config, and Converters.config
TemplateConfigShortcuts.json
translations.json
D:\inetpub\CustomersCanvas\cc-<new-version-number>).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.
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.
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.
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.
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"
/>
<route
name="Color convertor API"
*path="api/ColorConvertor/{action}/{color}"
methods="POST"
authRequired="false"
unsafeHttpMode ="enabled"
/>
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>
When products are loaded to the editor or rendered to print files, fonts, which were available before, get missed after the upgrade.
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:
App.config file, find <appSettings> and replace the default settings with the folder paths where you store the assets.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.
Some text elements can be edited on the canvas, although the Rich text editor may open for others.
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.
Old IDML templates with defined bleed and slug areas open with a different size.
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.