How kentico/xperience-by-kentico-kentico-migration-tool works
The repository implements a CLI-driven migration tool that transfers Kentico 11/12/13 data into Xperience by Kentico. Its main workflow is configuration and source-version selection, command dispatch, source reads, transformation, target writes, and reporting. The graph preserves documented content, commerce, and customization capabilities alongside core runtime layers. Relationships are limited to those shown in excerpts, the SOURCE INDEX, or README; several implementation details are unsampled, so some documented subsystem links remain broad.
Main entry points: Program.cs Migration CLI · Handlers Migration handlers · MigratePagesCommandHandler.cs Page migration · BulkDataCopyService.cs Bulk copy service
Components 25
CLI orchestration
- Migration CLI
Migration.Tool.CLI/Program.cs - Tool configuration
Migration.Tool.Common/ToolConfiguration.cs - Command dispatch
Migration.Tool.Common/Services/MasterCommand.cs
Source data
- K11 source context
Migration.Tool.K11/Context/K11Context.cs - KX12 source context
Migration.Tool.KX12/Context/KX12Context.cs - KX13 source context
Migration.Tool.KX13/Context/KX13Context.cs - KX13 widget API
KX13.Extensions/ToolApiController.cs
Migration stages
- Migration handlers
KVA/Migration.Tool.Source/Handlers - Page migration
KVA/Migration.Tool.Source/Handlers/MigratePagesCommandHandler.cs - Contact migration
Migration.Tool.Core.KX13/Handlers/MigrateContactManagementCommandHandler.cs - Commerce migration
Migration.Tool.Core.KX13/Handlers/Base/MigrateCommerceHandlerBase.cs - Source model facade
KVA/Migration.Tool.Source/ModelFacade.cs - Data mappers
KVA/Migration.Tool.Source/Mappers - Custom transformations
Migration.Tool.Extensions/CommunityMigrations - Identity mapping
Migration.Tool.Common/Helpers/GuidHelper.cs - Primary key locator
KVA/Migration.Tool.Source/Services/PrimaryKeyLocatorService.cs
Target integration
- Bulk copy service
Migration.Tool.Common/Services/BulkCopy/BulkDataCopyService.cs - Bulk copy request
Migration.Tool.Common/Services/BulkCopy/BulkCopyRequest.cs - XbyK target API
Migration.Tool.KXP.Api
Customization and reporting
- Migration protocol
Migration.Tool.Common/MigrationProtocol/IProtocol.cs - Migration guidance
Migration.Tool.Common/MigrationProtocol/HandbookReferences.cs - Command results
Migration.Tool.Common/Abstractions/CommandResult.cs - Migration IPC models
Migration.Tool.Common/Services/Ipc/Model.cs - Console and log output
Migration.Tool.Common/Helpers/ConsoleHelper.cs
Other components
- Operator
Connections 25
- Operator → Migration CLI: runs
README.md - Migration CLI → Tool configuration: loads settings
Migration.Tool.CLI/Program.cs - Migration CLI → Command dispatch: dispatches commands
Migration.Tool.CLI/Program.cs - Command dispatch → Migration handlers: handles commands
README.md - Migration CLI → K11 source context: selects source
Migration.Tool.CLI/Program.cs - Migration CLI → KX12 source context: selects source
Migration.Tool.CLI/Program.cs - Migration CLI → KX13 source context: selects source
Migration.Tool.CLI/Program.cs - Migration handlers → Source model facade: reads source
KVA/Migration.Tool.Source/Handlers/MigratePagesCommandHandler.cs - Page migration → Source model facade: selects records
KVA/Migration.Tool.Source/Handlers/MigratePagesCommandHandler.cs - Page migration → Data mappers: maps pages
KVA/Migration.Tool.Source/Handlers/MigratePagesCommandHandler.cs - Migration handlers → Data mappers: transforms data
README.md - Custom transformations → Data mappers: customizes mappings
- Contact migration → Bulk copy service: copies contact data
Migration.Tool.Core.KX13/Handlers/MigrateContactManagementCommandHandler.cs - Commerce migration → XbyK target API: migrates commerce
Migration.Tool.Core.KX13/Handlers/Base/MigrateCommerceHandlerBase.cs - Bulk copy service → Bulk copy request: uses request
Migration.Tool.Common/Services/BulkCopy/BulkDataCopyService.cs - Bulk copy service → XbyK target API: writes target data
README.md - Migration handlers → XbyK target API: writes migrated data
README.md - KX13 widget API → Migration handlers: provides widget data
- Page migration → Migration IPC models: uses page metadata
KVA/Migration.Tool.Source/Handlers/MigratePagesCommandHandler.cs - Page migration → Identity mapping: creates stable identities
KVA/Migration.Tool.Source/Handlers/MigratePagesCommandHandler.cs - Primary key locator → Source model facade: locates source keys
KVA/Migration.Tool.Source/Services/PrimaryKeyLocatorService.cs - Migration handlers → Migration protocol: records migration notes
KVA/Migration.Tool.Source/Handlers/MigratePagesCommandHandler.cs - Migration protocol → Migration guidance: uses guidance references
Migration.Tool.Common/MigrationProtocol/HandbookReferences.cs - Migration handlers → Command results: returns status
KVA/Migration.Tool.Source/Handlers/MigratePagesCommandHandler.cs - Migration CLI → Console and log output: outputs logs
README.md