Merge branch 'prerelease/develop-ga' into flexipage_fixes

Author: snehaljha-sf

messages/assess.json

@@ -102,7 +102,6 @@
   "integrationProcedureNameChangeMessage": "Integration Procedure reference %s will be changed to %s during migration.",
   "integrationProcedureManualUpdateMessage": "Integration Procedure reference %s may need manual updates after migration.",
   "duplicateCardNameMessage": "Potential duplicate: Another card has the same name %s after name cleaning. This may cause conflicts during migration",
-  "globalAutoNumberNameChangeMessage": "GlobalAutoNumber name will be changed from %s to %s to follow API naming standards",
   "duplicateGlobalAutoNumberNameMessage": "Potential duplicate: Another Global Auto Number has the same name %s after name cleaning. This may cause conflicts during migration",
   "existingApexPrompt": "Do you have a sfdc project that already contains the APEX classes retrieved from your org? [y/n]",
   "enterExistingProjectPath": "Enter the path to the project folder that contains the retrieved APEX classes:",
@@ -137,5 +136,52 @@
   "generatedDiffForFile": "Generated diff for file: %s",
   "errorProcessingFlexiPage": "Error processing flexipage file: %s, %s",
   "flexipagesWithChanges": "Found %s flexipage files with changes",
-  "migratingFlexiPages": "Migrating FlexiPages"
+  "migratingFlexiPages": "Migrating FlexiPages",
+  "experienceSiteMetadataConsent": "The consent for exp site is %s",
+  "experienceSiteConsentNotProvidedWarning": "Consent for experience sites is not provided. Experience sites will not be processed",
+  "relatedObjectsToProcessAfterExpSitesRemoval": "Objects to process after removing expsite are",
+  "experienceBundleMetadataAPIAlreadyEnabled": "ExperienceBundle metadata api is already enabled",
+  "enableExperienceBundleMetadataAPIProgramatically": "ExperienceBundle metadata api needs to be programatically enabled",
+  "unableToEnableExperienceBundleMetadataAPI": "Since the api could not able enabled the experience sites would not be processed",
+  "relatedObjectsToProcess": "Objects to process are",
+  "consentForExperienceSites": "'By proceeding further, you hereby consent to enable digital experience metadata api(y/n). If y sites will be processed, if n expsites will not be processed';",
+  "failedToGetConsentError": "Failed to get user consent: %s",
+  "settingDesignersToStandardModel": "Setting designers to use the standard data model",
+  "errorSettingDesignersToStandardModel": "Error occurred while setting designers to use the standard data model",
+  "designersSetToStandardModel": "Successfully executed setDesignersToUseStandardDataModel",
+  "exceptionSettingDesignersToStandardModel": "Exception occurred while setting designers to use the standard data model",
+  "noRelatedObjects": "No related objects to process",
+  "turnOffExperienceBundleAPI": "Since ExperienceSiteMetadata API was programatically enabled, turing it off",
+  "errorRevertingExperienceBundleMetadataAPI": "Exception occurred while reverting metadata API. Please do that manually",
+  "processingExperienceSites": "Starting experience sites processing for %s",
+  "experienceSitesProcessingStarted": "Started processing the experience sites",
+  "experienceSiteSuccessfullyProcessed": "Successfully processed experience sites for %s",
+  "readingFile": "Started reading the files",
+  "totalFileCount": "The total count of files is %s",
+  "skipNonJsonFile": "Skipping non-JSON file - %s",
+  "experienceSiteWithOmniWrapperSuccessfullyProcessed": "Successfully processed experience site file having vlocity wrapper",
+  "fileNotHavingWrapper": "File does not contain vlocity wrapper",
+  "errorProcessingExperienceSite": "Error processing experience site file",
+  "experienceSiteReportingDetails": "Only the files in which have vlocity wrapper will be shown in the assessment report",
+  "processingFile": "Processing for file",
+  "currentRegionOfExperienceSite": "The current region being processed is %s",
+  "currentComponentOfExperienceSite": "The current component being processed is %s",
+  "omniWrapperFound": "Omnistudio wrapper component found",
+  "printUpdatedObject": "Now printing the updated object %s",
+  "printDifference": "Printing the difference %s",
+  "updatingFile": "Updating the file content",
+  "processingFlexcardComponent": "Started processing FC component %s",
+  "processingOmniscriptComponent": "Started processing OS component",
+  "targetData": "The target data is %s",
+  "manualInterventionForExperienceSite": "%s needs manual intervention as the migrated key does not exist",
+  "manualInterventionForExperienceSiteAsFailure": "%s needs manual intervention as migration failed",
+  "manualInterventionForExperienceSiteAsDuplicateKey": "%s needs manual intervention as duplicated key found in storage",
+  "updatingStorageForOmniscipt": "Started updating storage for omniscript %s",
+  "keyAlreadyInStorage": "Key %s already exists in storage",
+  "flexcardStorageProcessingStarted": "Started preparing storage for flexcards",
+  "errorWhileProcessingFlexcardStorage": "Error occurred while processing key for flexcard storage",
+  "missingInfo": "Info is missing",
+  "errorCheckingGlobalAutoNumber": "We couldn’t check whether the Global Auto Number setting is enabled: %s. Try again later.",
+  "errorMigrationMessage": "Error migrating object: %s",
+  "nameMappingUndefined": "Name Mapping is undefined"
 }

messages/migrate.json

@@ -144,14 +144,59 @@
   "startingPostMigrationCleanup": "Starting post-migration cleanup for Global Auto Number...",
   "postMigrationCleanupCompleted": "Post-migration cleanup completed successfully.",
   "errorDuringPostMigrationCleanup": "We’ve encountered an error during the post-migration cleanup. Try again later.",
-  "globalAutoNumberNameChangeMessage": "Global Auto Number name has been modified to fit naming rules: %s",
   "duplicatedGlobalAutoNumberName": "Duplicated Global Auto Number name",
   "errorWhileUploadingGlobalAutoNumber": "An error occurred while uploading Global Auto Number: ",
   "startingGlobalAutoNumberAssessment": "Starting Global Auto Number assessment...",
   "foundGlobalAutoNumbersToAssess": "Found %s Global Auto Numbers to assess",
   "unexpectedError": "An unexpected error occurred during processing",
-  "migrationValidationFailed": "The post-migration validation has failed.",
+  "migrationValidationFailed": "Post Migration validation failed.",
+  "incompleteMigrationDetected": "Incomplete migration detected. Source objects: %s, Target objects: %s.",
+  "experienceSiteMetadataConsent": "The consent for exp site is %s",
+  "experienceSiteConsentNotProvidedWarning": "Consent for experience sites is not provided. Experience sites will not be processed",
+  "relatedObjectsToProcessAfterExpSitesRemoval": "Objects to process after removing expsite are",
+  "experienceBundleMetadataAPIAlreadyEnabled": "ExperienceBundle metadata api is already enabled",
+  "enableExperienceBundleMetadataAPIProgramatically": "ExperienceBundle metadata api needs to be programatically enabled",
+  "unableToEnableExperienceBundleMetadataAPI": "Since the api could not able enabled the experience sites would not be processed",
+  "relatedObjectsToProcess": "Objects to process are",
+  "consentForExperienceSites": "'By proceeding further, you hereby consent to enable digital experience metadata api(y/n). If y sites will be processed, if n expsites will not be processed';",
+  "failedToGetConsentError": "Failed to get user consent: %s",
+  "settingDesignersToStandardModel": "Setting designers to use the standard data model",
+  "errorSettingDesignersToStandardModel": "Error occurred while setting designers to use the standard data model",
+  "designersSetToStandardModel": "Successfully executed setDesignersToUseStandardDataModel",
+  "exceptionSettingDesignersToStandardModel": "Exception occurred while setting designers to use the standard data model",
+  "noRelatedObjects": "No related objects to process",
+  "turnOffExperienceBundleAPI": "Since ExperienceSiteMetadata API was programatically enabled, turing it off",
+  "errorRevertingExperienceBundleMetadataAPI": "Exception occurred while reverting metadata API. Please do that manually",
+  "processingExperienceSites": "Starting experience sites processing for %s",
+  "experienceSitesProcessingStarted": "Started processing the experience sites",
+  "experienceSiteSuccessfullyProcessed": "Successfully processed experience sites for %s",
+  "readingFile": "Started reading the files",
+  "totalFileCount": "The total count of files is %s",
+  "skipNonJsonFile": "Skipping non-JSON file - %s",
+  "experienceSiteWithOmniWrapperSuccessfullyProcessed": "Successfully processed experience site file having vlocity wrapper",
+  "fileNotHavingWrapper": "File does not contain vlocity wrapper",
+  "errorProcessingExperienceSite": "Error processing experience site file",
+  "experienceSiteReportingDetails": "Only the files in which have vlocity wrapper will be shown in the assessment report",
+  "processingFile": "Processing for file",
+  "currentRegionOfExperienceSite": "The current region being processed is %s",
+  "currentComponentOfExperienceSite": "The current component being processed is %s",
+  "omniWrapperFound": "Omnistudio wrapper component found",
+  "printUpdatedObject": "Now printing the updated object %s",
+  "printDifference": "Printing the difference %s",
+  "updatingFile": "Updating the file content",
+  "processingFlexcardComponent": "Started processing FC component %s",
+  "processingOmniscriptComponent": "Started processing OS component",
+  "targetData": "The target data is %s",
+  "manualInterventionForExperienceSite": "%s needs manual intervention as the migrated key does not exist",
+  "manualInterventionForExperienceSiteAsFailure": "%s needs manual intervention as migration failed",
+  "manualInterventionForExperienceSiteAsDuplicateKey": "%s needs manual intervention as duplicated key found in storage",
+  "updatingStorageForOmniscipt": "Started updating storage for omniscript %s",
+  "keyAlreadyInStorage": "Key %s already exists in storage",
+  "flexcardStorageProcessingStarted": "Started preparing storage for flexcards",
+  "errorWhileProcessingFlexcardStorage": "Error occurred while processing key for flexcard storage",
+  "missingInfo": "Info is missing",
   "incompleteMigrationDetected": "We couldn’t complete the migration process",
   "errorCheckingGlobalAutoNumber": "We couldn’t check whether the Global Auto Number setting is enabled: %s. Try again later.",
-  "errorMigrationMessage": "Error migrating object: %s"
+  "errorMigrationMessage": "Error migrating object: %s",
+  "nameMappingUndefined": "Name Mapping is undefined"
 }

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-omnistudio-migration-tool",
   "description": "This SFDX plugin migrates FlexCard, OmniScript, DataRaptor, and Integration Procedure custom objects to standard objects.",
-  "version": "2.0.0-rc.5",
+  "version": "2.0.0-rc.7",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {

src/commands/omnistudio/migration/assess.ts

@@ -15,6 +15,8 @@ import { OmnistudioOrgDetails, OrgUtils } from '../../../utils/orgUtils';
 import { OrgPreferences } from '../../../utils/orgPreferences';
 import { Constants } from '../../../utils/constants/stringContants';
 import { ProjectPathUtil } from '../../../utils/projectPathUtil';
+import { PreMigrate } from '../../../migration/premigrate';
+import { PostMigrate } from '../../../migration/postMigrate';
 
 Messages.importMessagesDirectory(__dirname);
 const messages = Messages.loadMessages('@salesforce/plugin-omnistudio-migration-tool', 'assess');
@@ -69,8 +71,11 @@ export default class Assess extends OmniStudioBaseCommand {
     const allVersions = (this.flags.allversions || false) as boolean;
     const assessOnly = (this.flags.only || '') as string;
     const relatedObjects = (this.flags.relatedobjects || '') as string;
+    const isExperienceBundleMetadataAPIProgramaticallyEnabled: { value: boolean } = { value: false };
     const conn = this.org.getConnection();
-
+    let objectsToProcess: string[];
+    // To-Do: Add LWC to valid options when GA is released
+    const validOptions = [Constants.Apex, Constants.ExpSites, Constants.FlexiPage];
     if (apiVersion) {
       conn.setApiVersion(apiVersion);
     } else {
@@ -93,8 +98,16 @@ export default class Assess extends OmniStudioBaseCommand {
 
     const namespace = orgs.packageDetails.namespace;
     let projectPath = '';
+    const preMigrate: PreMigrate = new PreMigrate(this.org, namespace, conn, this.logger, messages, this.ux);
     if (relatedObjects) {
+      objectsToProcess = relatedObjects.split(',').map((obj) => obj.trim());
       projectPath = await ProjectPathUtil.getProjectPath(messages, true);
+
+      await preMigrate.handleExperienceSitePrerequisites(
+        objectsToProcess,
+        conn,
+        isExperienceBundleMetadataAPIProgramaticallyEnabled
+      );
     }
 
     const assesmentInfo: AssessmentInfo = {
@@ -108,6 +121,7 @@ export default class Assess extends OmniStudioBaseCommand {
         ipAssessmentInfos: [],
       },
       flexipageAssessmentInfos: [],
+      experienceSiteAssessmentInfos: [],
     };
 
     Logger.log(messages.getMessage('assessmentInitialization', [String(namespace)]));
@@ -124,13 +138,8 @@ export default class Assess extends OmniStudioBaseCommand {
       process.exit(1);
     }
 
-    let objectsToProcess: string[];
     // Assess related objects if specified
     if (relatedObjects) {
-      // To-Do: Add LWC to valid options when GA is released
-      const validOptions = [Constants.Apex, Constants.FlexiPage];
-      objectsToProcess = relatedObjects.split(',').map((obj) => obj.trim());
-
       // Validate input
       for (const obj of objectsToProcess) {
         if (!validOptions.includes(obj)) {
@@ -150,14 +159,41 @@ export default class Assess extends OmniStudioBaseCommand {
       assesmentInfo.lwcAssessmentInfos = relatedObjectAssessmentResult.lwcAssessmentInfos;
       assesmentInfo.apexAssessmentInfos = relatedObjectAssessmentResult.apexAssessmentInfos;
       assesmentInfo.flexipageAssessmentInfos = relatedObjectAssessmentResult.flexipageAssessmentInfos;
+      assesmentInfo.experienceSiteAssessmentInfos = relatedObjectAssessmentResult.experienceSiteAssessmentInfos;
     }
     try {
       orgs.rollbackFlags = await OrgPreferences.checkRollbackFlags(conn);
     } catch (error) {
       Logger.log((error as Error).message);
       Logger.log((error as Error).stack);
     }
-    await AssessmentReporter.generate(assesmentInfo, conn.instanceUrl, orgs, assessOnly, objectsToProcess, messages);
+
+    // Post Assessment tasks
+    const postMigrate: PostMigrate = new PostMigrate(
+      this.org,
+      namespace,
+      conn,
+      this.logger,
+      messages,
+      this.ux,
+      objectsToProcess
+    );
+
+    const userActionMessages: string[] = [];
+    await postMigrate.restoreExperienceAPIMetadataSettings(
+      isExperienceBundleMetadataAPIProgramaticallyEnabled,
+      userActionMessages
+    );
+
+    await AssessmentReporter.generate(
+      assesmentInfo,
+      conn.instanceUrl,
+      orgs,
+      assessOnly,
+      objectsToProcess,
+      messages,
+      userActionMessages
+    );
     return assesmentInfo;
   }