Promotion migration planning
Review this information to understand how to migrate existing promotions to the Promotions tool. Migration is required for promotions created using either Accelerator
Version 7 configurations supported for promotion migration
The following configurations are supported for promotions migration:
- 7.0
- Developer 7.0
Migration types
When you run the promotion migration utility included with Version 7, the utility transforms all or part of each promotion from the existing data model to the Version 7 data model. There are two types of migrations you can perform:
Migration type | What it does |
---|---|
Complete migration | Migrates the entire promotion to the new data model. This allows you to fully
manage the migrated promotion using only the Version 7 Promotions tool from
this point forward. You run a complete migration on a promotion only once. |
Partial migration | Migrates only part of the promotion to the new data model. This allows you to
continue to use an external tool to edit the promotion after migration; you use the Management
Center Version 7 Promotions tool only for activating, deactivating, and deleting the promotion.
After the initial partial migration, if you change the promotion using the external tool, rerun the partial migration on the promotion to update the with the changes. You can also perform a partial migration on any new promotions you create with an external tool. |
After you have migrated a promotion using either of these two methods, do not use or earlier versions with the migrated promotion.
The promotion migration utility
The promotion migration utility uses two configuration files and a set of XSL templates to transform a promotion from the existing data model to the Version 7 data model. The following diagram shows the migration process and the databases involved:
The first configuration file is called promotionMigrationConfig.xml. This file specifies the XSL templates that correspond to each promotion type. These templates are defined for the default promotion types and are used to transform the runtime promotion XML to intermediate XML containing the data needed to populate the database tables. The second configuration file is called promotionMigrationControlInfo.xml, or the Control Info configuration file. The Control Info configuration file has the following functions:
- It specifies whether the promotions corresponding to a particular promotion type will undergo complete migration or partial migration.
- It specifies the mapping of any customized promotion types to their customized XSL template files.
- It specifies the delimiter for the promotion codes.
- It provides a special control parameter to choose a partial or complete migration for order-level promotions built in that have the option "Cannot be combined with product promotions" selected. For more details, see Migration limitation for certain order-level promotions.
If you want to change any of the default settings in the promotionMigrationControlInfo.xml file, you must copy and rename it, modify it, and then call the custom version when you run the promotion migration utility. See Sample promotionMigrationControlInfo XML file for additional detail on these functions, and a sample of the Control Info configuration file.
See Sample OrderLevelPercentOff XSL template for a sample XSL template.
Default versus custom promotion types
It is important to understand the difference between these two promotion types when deciding how to proceed with migration because the migration steps are different. Default promotion types are the promotion types shipped with . Custom promotion types are new promotion types that your company has added, which may reuse some of the elements of default promotion types. If you have both promotion types, you can perform the migration in two separate steps, following the appropriate procedure for each.
Promotion migration scenarios
How you migrate your existing promotions depends on your situation and your requirements. In some cases, you can run the promotion migration utility with the default configuration files; in other cases, you must make a custom Control Info configuration file and possibly XSL templates to support migration. The following table shows common migration scenarios and links to the correct procedure to follow.
Tool you use to manage your existing promotions | Tool you want to use to manage existing promotions | Do you have a customized promotions user interface, or promotions built on custom promotion types? | Action to take |
---|---|---|---|
n/a | None – migration is not required. | ||
Version 7 | No | Run the promotion migration utility with the default configuration files
and templates. In a certain case, you must create a custom Control Info configuration file to
specify an option that is not the default setting. See Migrating promotions built on default promotion types: complete migration. |
|
Version 6 (Feature Pack 3 and 3.0.1) | Version 7 | No | Run the promotion migration utility with the default configuration files
and templates. In a certain case, you must create a custom Control Info configuration file to
specify an option that is not the default setting. See Migrating promotions built on default promotion types: complete migration. |
External tool that loads promotions directly into the databases | External tool that loads promotions directly into the databases; Version 7 to activate, deactivate and delete promotions. | No -or- Yes - promotions built on custom promotion types |
Create a customized version of the Control Info configuration file to set the migration type to partial for each promotion type. If you have promotions built on custom promotion types, create a custom XSL template for each custom promotion type to transform the data to the data model. Then run the promotion migration utility with a parameter set to call this customized Control Info configuration file instead of the default file. |
Customized | Version 7 (this will require customization) |
Yes - customized promotions user interface and promotions built on custom promotion types | Build an XSL template for each custom promotion type, to transform the data to the data model. Then create a customized version of the Control Info configuration file to map each promotion type to its custom XSL template, and to specify a complete or partial migration. Then run the promotion migration utility with a parameter set to call this customized Control Info configuration file instead of the default file. |