Merge branch 'prerelease/develop-ga' into prerelease/alpha

Author: sf-kishore-kurri

README.md

@@ -41,11 +41,12 @@ sfdx omnistudio:migration:assess -u [email protected]
 sfdx omnistudio:migration:migrate -u [email protected]
 
 
-// To migrate/assess specific components: FlexCards, DataMappers, Integration Procedures, or OmniScripts, add the following parameters:
---only=dr
---only=ip
---only=os
---only=fc
+// To migrate/assess specific components: FlexCards, DataMappers, Integration Procedures, OmniScripts, or Global Auto Numbers, add the following parameters:
+--only=dr    // DataMappers (DataRaptors)
+--only=ip    // Integration Procedures
+--only=os    // OmniScripts
+--only=fc    // FlexCards
+--only=autonumber   // Global Auto Numbers
 
 // To migrate all versions of the components and not just the active ones:
 --allversions
@@ -59,6 +60,47 @@ sfdx omnistudio:migration:migrate -u [email protected]
 
 5. An HTML page will be open in your default browser with the results of your migration/assessment reports.
 
+## Global Auto Number Migration
+
+Global Auto Numbers are components that generate sequential numbers across your Omnistudio org. The migration tool supports both assessment and migration of these components.
+
+### Prerequisites for Global Auto Number Migration
+
+Before migrating Global Auto Numbers, ensure that:
+
+1. **Org Preference is Disabled**: The `OmniGlobalAutoNumberPref` org preference must be disabled before migration
+2. **Rollback Flags are Disabled**: Both `RollbackIPChanges` and `RollbackDRChanges` flags must be disabled
+3. **Namespace is Specified**: Provide the correct namespace for your OmniStudio package
+
+### Global Auto Number Migration Process
+
+The migration process for Global Auto Numbers includes:
+
+1. **Pre-migration Checks**: Validates that org preferences and rollback flags are properly configured
+2. **Data Migration**: Transforms Global Auto Number settings from custom objects to standard Business Process Objects (BPO)
+3. **Post-migration Cleanup**: Removes source objects and enables the `OmniGlobalAutoNumberPref` org preference
+4. **Validation**: Ensures all records are successfully migrated before cleanup
+
+### Global Auto Number Assessment
+
+Assessment provides detailed information about:
+
+- **Name Changes**: Identifies any naming modifications required to comply with API naming standards
+- **Migration Readiness**: Determines if components can be automatically migrated or require manual intervention
+- **Warnings**: Highlights potential issues that may affect migration success
+
+### Usage Examples for Global Auto Numbers
+
+```bash
+# Assess Global Auto Numbers only
+sfdx omnistudio:migration:assess -u [email protected] --only=autonumber
+
+# Migrate Global Auto Numbers only
+sfdx omnistudio:migration:migrate -u [email protected] --only=autonumber
+```
+
+5. An HTML page will be open in your default browser with the results of your migration/assessment job.
+
 ### Assess Usage & parameters
 
 ```
@@ -88,7 +130,7 @@ OPTIONS
 
   --only=only                                                                       specify components to assess:
                                                                                     dr (DataRaptors), ip (Integration Procedures),
-                                                                                    os (OmniScripts), fc (FlexCards)
+                                                                                    os (OmniScripts), fc (FlexCards), autonumber (Global Auto Numbers)
 
   --relatedobjects=relatedobjects                                                   specify related objects to assess:
                                                                                     'apex' for Apex classes

messages/assess.json

@@ -1,17 +1,18 @@
 {
   "examples": [
-    "omnistudio:migration:assess -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE",
-    "omnistudio:migration:assess -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE --only=dr",
-    "omnistudio:migration:assess -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE --only=ip",
-    "omnistudio:migration:assess -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE --only=os",
-    "omnistudio:migration:assess -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE --only=fc"
+    "omnistudio:migration:assess -u [email protected] ",
+    "omnistudio:migration:assess -u [email protected]  --only=dr",
+    "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=autonumber"
   ],
   "commandDescription": "Assess migration of omnistudio components from custom objects to standard objects",
   "namespaceFlagDescription": "The namespaced of the package",
   "apiVersionFlagDescription": "The Salesforce API version to use",
   "errorNoOrgResults": "No results found for the org '%s'.",
-  "onlyFlagDescription": "Migrate a single element: os | ip | fc | dr",
-  "invalidOnlyFlag": "Invalid flag, valid options are: os | ip | fc | dr",
+  "onlyFlagDescription": "Migrate a single element: os | ip | fc | dr | autonumber",
+  "invalidOnlyFlag": "Invalid flag, valid options are: os | ip | fc | dr | autonumber",
   "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.",
@@ -29,7 +30,7 @@
   "allVersionsDescription": "Migrate all versions of a component",
   "changeMessage": " %s will be changed from %s to %s",
   "angularOSWarning": " Angular OmniScript will not be migrated, please convert this to LWC based Omniscript",
-  "apexLwcGA": "Please select the type of component to assess: 'apex' for Apex classes, 'lwc' for Lightning Web Components, or 'apex,lwc' if you want to include both types.",
+  "relatedObjectGA": "Please select the type of component to assess: 'apex' for Apex classes, 'lwc' for Lightning Web Components, 'flexipage' for FlexiPages, or 'apex,lwc,flexipage' if you want to include all types.",
   "apexLwc": "Please select the type of component to assess: 'apex' for Apex classes.",
   "invalidNamespace": "The namespace you have passed is not valid namespace, the valid namespace of your org is ",
   "noPackageInstalled": "No package installed on given org.",
@@ -39,13 +40,17 @@
   "formulaSyntaxError": "There was some problem while updating the formula syntax, please check the all the formula's syntax once : %s",
   "errorDuringFlexCardAssessment": "Error during FlexCard assessment",
   "errorDuringOmniScriptAssessment": "Error during OmniScript assessment",
+  "errorDuringGlobalAutoNumberAssessment": "Error during GlobalAutoNumber assessment",
   "processingFlexCard": "Processing FlexCard: %s",
   "processingDataRaptor": "Processing DataRaptor: %s",
   "processingOmniScript": "Processing OmniScript: %s",
+  "processingGlobalAutoNumber": "Processing GlobalAutoNumber: %s",
   "foundDataRaptorsToAssess": "Found %s DataRaptors to assess",
   "foundOmniScriptsToAssess": "Found %s OmniScripts and Integration Procedures to assess",
+  "foundGlobalAutoNumbersToAssess": "Found %s GlobalAutoNumbers to assess",
   "startingDataRaptorAssessment": "Starting DataRaptor assessment",
   "startingOmniScriptAssessment": "Starting OmniScript assessment",
+  "startingGlobalAutoNumberAssessment": "Starting GlobalAutoNumber assessment",
   "allVersionsInfo": "allVersions : %s",
   "assessmentInitialization": "Assessment Initialization: Using namespace: %s",
   "apiVersionInfo": "API Version: %s",
@@ -57,6 +62,9 @@
   "flexCardAssessment": "FlexCard Assessment",
   "assessedFlexCardsCount": "Assessed %s FlexCards",
   "flexCardAssessmentCompleted": "FlexCard assessment completed",
+  "globalAutoNumberAssessment": "GlobalAutoNumber Assessment",
+  "assessedGlobalAutoNumbersCount": "Assessed %s GlobalAutoNumbers",
+  "globalAutoNumberAssessmentCompleted": "GlobalAutoNumber assessment completed",
   "omniScriptAssessment": "OmniScript and Integration Procedure Assessment",
   "assessedOmniScriptsCount": "Assessed %s OmniScripts",
   "assessedIntegrationProceduresCount": "Assessed %s Integration Procedures",
@@ -115,4 +123,17 @@
   "errorGeneratingHTML": "Error while generating HTML from template for %s with properties %s",
   "unexpectedError": "Unexpected Assessment error",
   "errorEvaluatingExpression": "Error evaluating expression: %s, %s"
+  "retrievingFlexiPages": "Retrieving FlexiPages",
+  "successfullyRetrievedFlexiPages": "Successfully retrieved %s FlexiPages",
+  "assessingFlexiPages": "Assessing FlexiPages",
+  "completedProcessingAllFlexiPages": "Completed processing all flexipage files. Total processed: %s",
+  "completedProcessingFlexiPage": "Completed processing %s - Errors: %s",
+  "processingFlexiPage": "Processing flexipage file: %s",
+  "startingFlexiPageProcessing": "Starting to process flexipage: %s",
+  "readFlexiPageContent": "Read file content, size: %s characters",
+  "updatedModifiedContent": "updated content in file: %s",
+  "generatedDiffForFile": "Generated diff for file: %s",
+  "errorProcessingFlexiPage": "Error processing flexipage file: %s, %s",
+  "flexipagesWithChanges": "Found %s flexipage files with changes",
+  "migratingFlexiPages": "Migrating FlexiPages"
 }

messages/migrate.json

@@ -1,20 +1,21 @@
 {
   "examples": [
-    "omnistudio:migration:migrate -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE",
-    "omnistudio:migration:migrate -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE --only=dr",
-    "omnistudio:migration:migrate -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE --only=ip",
-    "omnistudio:migration:migrate -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE --only=os",
-    "omnistudio:migration:migrate -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE --only=fc",
-    "omnistudio:migration:migrate -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE -r apex,lwc",
-    "omnistudio:migration:migrate -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE -r apex",
-    "omnistudio:migration:migrate -u [email protected] --namespace=YOUR_PACKAGE_NAMESPACE -r lwc"
+    "omnistudio:migration:migrate -u [email protected] ",
+    "omnistudio:migration:migrate -u [email protected]  --only=dr",
+    "omnistudio:migration:migrate -u [email protected]  --only=ip",
+    "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]  -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",
   "apiVersionFlagDescription": "The Salesforce API version to use",
   "errorNoOrgResults": "No results found for the org '%s'.",
-  "onlyFlagDescription": "Migrate a single element: os | ip | fc | dr",
-  "invalidOnlyFlag": "Invalid flag, valid options are: os | ip | fc | dr",
+  "onlyFlagDescription": "Migrate a single element: os | ip | fc | dr | autonumber",
+  "invalidOnlyFlag": "Invalid flag, valid options are: os | ip | fc | dr | autonumber",
   "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.",
@@ -29,7 +30,7 @@
   "errorWhileUploadingCard": "An error ocurred while uploading Card: ",
   "errorWhileCreatingElements": "An error ocurred while saving OmniScript elements: ",
   "allVersionsDescription": "Migrate all versions of a component",
-  "apexLwcGA": "Please select the type of components to migrate: 'apex' for Apex classes, 'lwc' for Lightning Web Components, or 'apex,lwc' if you want to include both types.",
+  "relatedObjectGA": "Please select the type of components to migrate: 'apex' for Apex classes, 'lwc' for Lightning Web Components, 'flexipage' for FlexiPages, 'expsites' for Experience Sites, or 'apex,lwc,flexipage,expsites' if you want to include all types.",
   "apexLwc": "Please select the type of components to migrate: 'apex' for Apex classes.",
   "invalidNamespace": "The namespace you have passed is not valid namespace, the valid namespace of your org is ",
   "noPackageInstalled": "No package installed on given org.",
@@ -63,11 +64,13 @@
   "cleaningComponent": "Cleaning: %s",
   "cleaningDone": "Cleaning Done: %s",
   "migratingComponent": "Migrating: %s",
+  "cleaningFailed": "Cleaning Failed: %s",
   "migrationCompleted": "Migration completed: %s",
   "formulaSyntaxError": "There was some problem while updating the formula syntax, please check the all the formula's syntax once : %s",
   "foundDataRaptorsToMigrate": "Found %s DataRaptors to migrate",
   "foundFlexCardsToMigrate": "Found %s FlexCards to migrate",
   "foundOmniScriptsToMigrate": "Found %s OmniScripts and Integration Procedures to migrate",
+  "foundGlobalAutoNumbersToMigrate": "Found %s GlobalAutoNumbers to migrate",
   "allVersionsInfo": "allVersions : %s",
   "migrationInitialization": "Migration Initialization: Using namespace: %s",
   "apiVersionInfo": "API Version: %s",
@@ -113,4 +116,37 @@
   "labelStatusSkipped": "Skipped",
   "labelStatusFailed": "Failed",
   "labelStatusComplete": "Complete"
+  "retrievingFlexiPages": "Retrieving FlexiPages",
+  "successfullyRetrievedFlexiPages": "Successfully retrieved %s FlexiPages",
+  "migratingFlexiPages": "Migrating FlexiPages",
+  "completedProcessingAllFlexiPages": "Completed processing all flexipage files. Total processed: %s",
+  "completedProcessingFlexiPage": "Completed processing %s - Errors: %s",
+  "processingFlexiPage": "Processing flexipage file: %s",
+  "startingFlexiPageProcessing": "Starting to process flexipage: %s",
+  "readFlexiPageContent": "Read file content, size: %s characters",
+  "updatedModifiedContent": "updated content in file: %s",
+  "generatedDiffForFile": "Generated diff for file: %s",
+  "errorProcessingFlexiPage": "Error processing flexipage file: %s, %s",
+  "flexipagesWithChanges": "Found %s flexipage files with changes",
+  "omniGlobalAutoNumberPrefEnabled": "Successfully enabled OmniGlobalAutoNumberPref org preference",
+  "errorEnablingOmniGlobalAutoNumberPref": "Error enabling OmniGlobalAutoNumberPref org preference",
+  "performingPreMigrationChecks": "Performing pre-migration checks for Global Auto Number...",
+  "preMigrationChecksPassed": "Pre-migration checks passed. Proceeding with Global Auto Number migration.",
+  "preMigrationChecksFailed": "Pre-migration checks failed. Migration cannot proceed.",
+  "globalAutoNumberPrefEnabledError": "Global Auto Number preference (OmniGlobalAutoNumberPref) is enabled. Please disable it before proceeding with migration.",
+  "bothRollbackFlagsEnabledError": "Both RollbackIPChanges and RollbackDRChanges flags are enabled. Please disable both flags before proceeding with Global Auto Number migration.",
+  "rollbackIPFlagEnabledError": "RollbackIPChanges flag is enabled. Please disable this flag before proceeding with Global Auto Number migration.",
+  "rollbackDRFlagEnabledError": "RollbackDRChanges flag is enabled. Please disable this flag before proceeding with Global Auto Number migration.",
+  "errorCheckingRollbackFlags": "Error checking rollback flags status.",
+  "startingPostMigrationCleanup": "Starting post-migration cleanup for Global Auto Number...",
+  "postMigrationCleanupCompleted": "Post-migration cleanup completed successfully.",
+  "errorDuringPostMigrationCleanup": "Error during post-migration cleanup.",
+  "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": "Post Migration validation failed.",
+  "incompleteMigrationDetected": "Incomplete migration detected. Source objects: %s, Target objects: %s."
 }

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-beta.20",
+  "version": "2.0.0-rc.2",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {