Product Composer System Data Migration Utility 7.12 Introduction This utility supports the migration of PCS product template rules from PCS 2.3 SP2 (on PRPC 6.2 SP2) to PCS 7.12 to bridge the clipboard structure gaps. The utility is not required for the migration of plan and product rules. You should modify the utility to support the data migration for the implementation layer while upgrading from PCS 2.3 SP2 to PCS 7.12. This utility is not required if you are upgrading from PCS 7.11. Migration procedure The UpgradeTemplateDatafromSP2ToPCS7 activity belongs to the Rule-HC-PCS-Product class and is responsible for updating the data in the upgraded system. Before executing this activity: 1. Import all custom rules to the upgraded system. The data in the original ruleset version is available, though it has been copied to a major version. After running the utility, test the data thoroughly. If required, delete the data in the original ruleset version using the Pega 7 OOTB tool. Or, you can back up the data before and delete while copying to the major ruleset version. For example, you should copy the PCS custom rules created in Custom rules: 03-02-xx or below to a major version: 07-XX-XX. 2. Once you copy the custom rules contained in the original ruleset version to the upgraded system, execute the UpgradeTemplateDatafromSP2ToPCS7 activity from the Actions menu in Designer Studio. The system prompts for the migrated ruleset version number as a parameter to the activity. The parameterized ruleset version number is used to select the template custom rules from the ruleset version and update them accordingly, as shown below. Data Migration Utility 1
The PCS 7.12 clipboard structure slightly varies from that of 2.3 SP2. New pages have been added in PCS 7.12. The following shows the clipboard structure of PCS 2.3 SP2. Data Migration Utility 2
After the custom rules have been copied to the upgraded system, the clipboard structure is updated as shown below. After running the utility, the clipboard structure is populated with the data for the new pages as shown below. Data Migration Utility 3
Data Migration Utility 4
Technical overview The utility has these activities: Rule-HC-PCS-Product UpgradeTemplateDatafromSP2ToPCS7 The main utility, UpgradeTemplateDatafromSP2ToPCS7, is used to take the ruleset version based on submitted parameters and retrieve all related rules, which have not been upgraded. You can determine a template rule s status by the IsTemplateUpgraded property. Rule-HC-PCS-Product UpgradeTemplatePages The UpgradeTemplatePages activity is used to retrieve all related data and populate them to the appropriate clipboard pages. @baseclass SaveTemplatePage The SaveTemplatePage activity is used to save the upgraded template pages in the updated existing ruleset version, for example, 07-12-XX. Rule-HC-PCS-Product IsTemplateUpgraded When the template has been upgraded, the property IsTemplateUpgraded is set to True. Data Migration Utility 5
Copyright 2015 Pegasystems Inc., Cambridge, MA All rights reserved. This document describes products and services of Pegasystems Inc. It may contain trade secrets and proprietary information. The document and product are protected by copyright and distributed under licenses restricting their use, copying distribution, or transmittal in any form without prior written authorization of Pegasystems Inc. This document is current as of the date of publication only. Changes in the document may be made from time to time at the discretion of Pegasystems. This document remains the property of Pegasystems and must be returned to it upon request. This document does not imply any commitment to offer or deliver the products or services described. This document may include references to Pegasystems product features that have not been licensed by your company. If you have questions about whether a particular capability is included in your installation, please consult your Pegasystems service consultant. For Pegasystems trademarks and registered trademarks, all rights reserved. Other brand or product names are trademarks of their respective holders. Although Pegasystems Inc. strives for accuracy in its publications, any publication may contain inaccuracies or typographical errors. This document or Help System could contain technical inaccuracies or typographical errors. Changes are periodically added to the information herein. Pegasystems Inc. may make improvements and/or changes in the information described herein at any time. This document is the property of: Pegasystems Inc. One Rogers Street Cambridge, MA 02142-1590 Phone: (617) 374-9600 Fax: (617) 374-9620 www.pega.com Product Composer System Document: Data Migration Utility Software Version: 7. 12 Updated: January 2015 Data Migration Utility 6