Merge pull request #365 from mdmehran-qureshi/prerelease/develop-ga

@W-19086044 Add custom label migration functionality and resolve merge conflicts

Author: mdmehran-qureshi

messages/assess.json

@@ -5,12 +5,13 @@
     "omnistudio:migration:assess -u [email protected]  --only=ip",
     "omnistudio:migration:assess -u [email protected]  --only=os",
     "omnistudio:migration:assess -u [email protected]  --only=fc",
+    "omnistudio:migration:assess -u [email protected]  --only=cl",
     "omnistudio:migration:assess -u [email protected]  --only=autonumber"
   ],
   "commandDescription": "Assess migration of omnistudio components from custom objects to standard objects",
   "errorNoOrgResults": "No results found for the org '%s'.",
-  "onlyFlagDescription": "Migrate a single element: os | ip | fc | dm | autonumber",
-  "invalidOnlyFlag": "Invalid flag, valid options are: os | ip | fc | dm | autonumber",
+  "onlyFlagDescription": "Migrate a single element: os | ip | fc | dm | autonumber | cl",
+  "invalidOnlyFlag": "Invalid flag, valid options are: os | ip | fc | dm | autonumber | cl",
   "couldNotDeactivateOmniProcesses": "Could not deactivate current OmniProcesses",
   "couldNotTruncate": "Could not truncate %s",
   "couldNotTruncateOmnniProcess": "Could not truncate OmniProcess. Please make sure your OS/IP is not referenced in an OmniScrirpt or Flex Card.",
@@ -99,6 +100,10 @@
   "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",
+  "startingCustomLabelAssessment": "Starting Custom Label assessment",
+  "assessedCustomLabelsCount": "Assessed %s Custom Labels",
+  "customLabelAssessmentCompleted": "Custom Label assessment completed",
+  "errorDuringCustomLabelAssessment": "Error during Custom Label assessment: %s",
   "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",
@@ -179,5 +184,8 @@
   "nameMappingUndefined": "Undefined name mapping found",
   "experienceSiteException": "We’ve encountered an exception while processing Experience Cloud sites.",
   "reservedKeysFoundInPropertySet": "Reserved keys found in any of output response transformation fields: %s.",
-  "invalidTypeAssessErrorMessage": "We couldn't assess your Omnistudio components in the %s namespace. Select the correct namespace and try again"
+  "invalidTypeAssessErrorMessage": "We couldn't assess your Omnistudio components in the %s namespace. Select the correct namespace and try again",
+  "errorFetchingCustomLabels": "Error fetching custom labels: %s",
+  "customLabelAssessmentSummary": "Custom Label with same name and different value is already exist without namespace.",
+  "generatedCustomLabelAssessmentReportPage": "Generated custom label assessment report page %s of %s with %s labels"
 }

messages/migrate.json

@@ -6,15 +6,16 @@
     "omnistudio:migration:migrate -u [email protected]  --only=os",
     "omnistudio:migration:migrate -u [email protected]  --only=fc",
     "omnistudio:migration:migrate -u [email protected]  --only=autonumber",
+    "omnistudio:migration:migrate -u [email protected]  --only=cl",
     "omnistudio:migration:migrate -u [email protected]  -r apex,lwc",
     "omnistudio:migration:migrate -u [email protected]  -r apex",
     "omnistudio:migration:migrate -u [email protected]  -r lwc"
   ],
   "commandDescription": "Migrate omnistudio components from custom objects to standard objects",
   "namespaceFlagDescription": "The namespace of the package",
   "errorNoOrgResults": "No results found for the org '%s'.",
-  "onlyFlagDescription": "Migrate a single element: os | ip | fc | dm | autonumber",
-  "invalidOnlyFlag": "Invalid flag, valid options are: os | ip | fc | dm | autonumber",
+  "onlyFlagDescription": "Migrate a single element: os | ip | fc | dm | autonumber | cl",
+  "invalidOnlyFlag": "Invalid flag, valid options are: os | ip | fc | dm | autonumber | cl",
   "couldNotDeactivateOmniProcesses": "Could not deactivate current OmniProcesses",
   "couldNotTruncate": "Could not truncate %s",
   "couldNotTruncateOmnniProcess": "Could not truncate OmniProcess. Please make sure your OS/IP is not referenced in an OmniScrirpt or Flex Card.",
@@ -70,6 +71,7 @@
   "foundFlexCardsToMigrate": "Found %s FlexCards to migrate",
   "foundOmniScriptsToMigrate": "Found %s %s to migrate",
   "foundGlobalAutoNumbersToMigrate": "Found %s GlobalAutoNumbers to migrate",
+  "foundCustomLabelsToMigrate": "Found %s Custom Labels to migrate",
   "allVersionsInfo": "allVersions : %s",
   "migrationInitialization": "Migration Initialization: Using namespace: %s",
   "apiVersionInfo": "API Version: %s",
@@ -232,5 +234,24 @@
   "enableStandardRuntimeAfterDesigner": "Standard designer setup successful, proceeding with Standard Runtime enablement",
   "skipStandardRuntimeDueToFailure": "Skipping Standard Runtime enablement due to designer setup failure",
   "errorCheckingStandardDesigner": "Failed to check standard designer status for package %s: %s",
-  "relatedObjectsConsentNotGiven": "The related objects will not be processed because the user declined consent."
-}
+  "relatedObjectsConsentNotGiven": "The related objects will not be processed because the user declined consent.",
+  "startingCustomLabelMigration": "Starting Custom Labels migration",
+  "customLabelMigrationCompleted": "Custom Labels migration completed. %s labels processed out of %s total",
+  "errorDuringCustomLabelMigration": "Error during Custom Labels migration: %s",
+  "callingCloneCustomLabelsAPI": "Calling clone-custom-labels API for namespace: %s",
+  "cloneCustomLabelsAPIResponse": "Clone custom labels API response summary: %s results",
+  "errorCallingCloneCustomLabelsAPI": "Error calling clone-custom-labels API: %s",
+  "callingCloneCustomLabelLocalizationsAPI": "Calling clone-custom-label-localizations API for namespace: %s",
+  "cloneCustomLabelLocalizationsAPIResponse": "Clone custom label localizations API response summary: %s labels with localizations",
+  "errorCallingCloneCustomLabelLocalizationsAPI": "Error calling clone-custom-label-localizations API: %s",
+  "skippingCustomLabelTruncation": "Skipping truncation for Custom Labels",
+  "labelAlreadyExistsWarning": "Label already exists with status: %s",
+  "failedToCloneLabelError": "Failed to clone label with status: %s",
+  "localizationAlreadyExistsWarning": "Localization for %s already exists",
+  "failedToCreateLocalizationError": "Failed to create localization for %s",
+  "generatingCustomLabelsReport": "Generating custom labels migration report with %s labels (all statuses) across %s pages of %s each",
+  "generatedCustomLabelsReportPage": "Generated custom labels report page %s of %s with %s labels",
+  "errorFetchingCustomLabels": "Error fetching custom labels: %s",
+  "customLabelAssessmentSummary": "Custom Label with same name and different value is already exist without namespace.",
+  "generatedCustomLabelAssessmentReportPage": "Generated custom label assessment report page %s of %s with %s labels"
+}

src/commands/omnistudio/migration/assess.ts

@@ -18,6 +18,7 @@ import { Constants } from '../../../utils/constants/stringContants';
 import { ProjectPathUtil } from '../../../utils/projectPathUtil';
 import { PreMigrate } from '../../../migration/premigrate';
 import { PostMigrate } from '../../../migration/postMigrate';
+import { CustomLabelsUtil } from '../../../utils/customLabels';
 
 Messages.importMessagesDirectory(__dirname);
 const messages = Messages.loadMessages('@salesforce/plugin-omnistudio-migration-tool', 'assess');
@@ -115,6 +116,8 @@ export default class Assess extends OmniStudioBaseCommand {
       },
       flexipageAssessmentInfos: [],
       experienceSiteAssessmentInfos: [],
+      customLabelAssessmentInfos: [],
+      customLabelStatistics: { totalLabels: 0, canBeAutomated: 0, needManualIntervention: 0 },
     };
 
     Logger.log(messages.getMessage('assessmentInitialization', [String(namespace)]));
@@ -214,6 +217,7 @@ export default class Assess extends OmniStudioBaseCommand {
       await this.assessOmniScripts(assesmentInfo, namespace, conn, allVersions, OmniScriptExportType.OS);
       await this.assessOmniScripts(assesmentInfo, namespace, conn, allVersions, OmniScriptExportType.IP);
       await this.assessGlobalAutoNumbers(assesmentInfo, namespace, conn);
+      await this.assessCustomLabels(assesmentInfo, namespace, conn);
       return;
     }
 
@@ -233,6 +237,9 @@ export default class Assess extends OmniStudioBaseCommand {
       case Constants.GlobalAutoNumber:
         await this.assessGlobalAutoNumbers(assesmentInfo, namespace, conn);
         break;
+      case Constants.CustomLabel:
+        await this.assessCustomLabels(assesmentInfo, namespace, conn);
+        break;
       default:
         throw new Error(messages.getMessage('invalidOnlyFlag'));
     }
@@ -315,4 +322,21 @@ export default class Assess extends OmniStudioBaseCommand {
     );
     Logger.log(messages.getMessage('globalAutoNumberAssessmentCompleted'));
   }
+
+  private async assessCustomLabels(assesmentInfo: AssessmentInfo, namespace: string, conn: Connection): Promise<void> {
+    try {
+      Logger.log(messages.getMessage('startingCustomLabelAssessment'));
+      const customLabelResult = await CustomLabelsUtil.fetchCustomLabels(conn, namespace, messages);
+      assesmentInfo.customLabelAssessmentInfos = customLabelResult.labels;
+      assesmentInfo.customLabelStatistics = customLabelResult.statistics;
+      Logger.logVerbose(
+        messages.getMessage('assessedCustomLabelsCount', [assesmentInfo.customLabelAssessmentInfos.length])
+      );
+      Logger.log(messages.getMessage('customLabelAssessmentCompleted'));
+    } catch (error) {
+      Logger.error(messages.getMessage('errorDuringCustomLabelAssessment', [(error as Error).message]));
+      assesmentInfo.customLabelAssessmentInfos = [];
+      assesmentInfo.customLabelStatistics = { totalLabels: 0, canBeAutomated: 0, needManualIntervention: 0 };
+    }
+  }
 }

src/commands/omnistudio/migration/migrate.ts

@@ -17,6 +17,7 @@ import { InvalidEntityTypeError, MigrationResult, MigrationTool } from '../../..
 import { ResultsBuilder } from '../../../utils/resultsbuilder';
 import { CardMigrationTool } from '../../../migration/flexcard';
 import { OmniScriptExportType, OmniScriptMigrationTool } from '../../../migration/omniscript';
+import { CustomLabelsMigrationTool } from '../../../migration/customLabels';
 import { Logger } from '../../../utils/logger';
 import OmnistudioRelatedObjectMigrationFacade from '../../../migration/related/OmnistudioRelatedObjectMigrationFacade';
 import { generatePackageXml } from '../../../utils/generatePackageXml';
@@ -439,6 +440,7 @@ export default class Migrate extends OmniStudioBaseCommand {
         ),
         new CardMigrationTool(namespace, conn, this.logger, messages, this.ux, allVersions),
         new GlobalAutoNumberMigrationTool(namespace, conn, this.logger, messages, this.ux),
+        new CustomLabelsMigrationTool(namespace, conn, this.logger, messages, this.ux),
       ];
     } else {
       // For single component migration, the order doesn't matter as much
@@ -479,6 +481,9 @@ export default class Migrate extends OmniStudioBaseCommand {
         case Constants.GlobalAutoNumber:
           migrationObjects.push(new GlobalAutoNumberMigrationTool(namespace, conn, this.logger, messages, this.ux));
           break;
+        case Constants.CustomLabel:
+          migrationObjects.push(new CustomLabelsMigrationTool(namespace, conn, this.logger, messages, this.ux));
+          break;
         default:
           throw new Error(messages.getMessage('invalidOnlyFlag'));
       }
@@ -655,6 +660,7 @@ export default class Migrate extends OmniStudioBaseCommand {
         migratedId: undefined,
         warnings: [],
         migratedName: '',
+        localizationStatus: record['localizationStatus'] || {},
       };
 
       if (migrationResults.results.has(record['Id'])) {
@@ -670,6 +676,7 @@ export default class Migrate extends OmniStudioBaseCommand {
         } else {
           obj.status = 'Complete';
         }
+
         obj.errors = errors;
         obj.migratedId = recordResults.id;
         obj.warnings = recordResults.warnings;